Send Management Information
The Send Management Information stores the information about the files to send. There are two ways to register records in the information.
-
Registration using the Management Console
->Refer to Creating and editing a record of the Send Management Information.
-
Registration using parameter file and command
->Refer to Management Information Batch Registration command.
Fields
The table below carries the values and optional statuses for the registration using the Management Console. The optional statuses for the registration using parameter file and command may differ from those for the registration using the Management Console. For the detail on optional statuses for the registration using parameter file and command, refer to Management Information Batch Registration command.
Field Name |
Default Value |
Valid Values |
Optional |
Remarks |
|
---|---|---|---|---|---|
Screen |
File |
||||
SNDFILE |
|
Alphanumeric characters and "_" |
|
Within 50 bytes starting with an alphabetic letter |
|
FILENAME |
|
Alphanumeric characters |
|
In the range of 3 to 33 bytes |
|
INTERVAL |
0 |
0 to 32767 |
✔ |
Unit:Millisecond |
|
BLOCKLEN |
0 |
0,128 to 65520 |
✔ |
|
|
BLOCKCNT |
0 |
0 to 99 |
✔ |
|
|
COMP |
N |
N,1,2,3 |
|
|
|
DEFLATELVL |
D |
S,D,C |
✔ |
|
|
TRANSPRTY |
50 |
1 to 256 |
|
|
|
CHARTYPE |
0 |
0, A to I, V to X |
|
|
|
TRANSTYPE |
|
F,B,T,M |
|
|
|
SHIFTTRANSACT |
C |
C,S |
|
|
|
SPCUT |
N |
S,N |
|
|
|
KJCHNGE |
S |
S,R,N |
|
|
|
CLEAR |
K |
K,C,D,L |
|
|
|
PREJOBID |
|
Alphanumeric characters and "_" |
✔ |
Within 50 bytes starting with an alphabetic letter |
|
JOBID |
|
Alphanumeric characters and "_" |
✔ |
Within 50 bytes starting with an alphabetic letter |
|
ERRJOBID |
|
Alphanumeric characters and "_" |
✔ |
Within 50 bytes starting with an alphabetic letter |
|
FMTID |
|
Alphanumeric characters and "_" |
✔ |
Within 50 bytes starting with an alphabetic letter |
|
DBID |
|
Alphanumeric characters |
✔ |
Only the string 'CSV' (*1) |
|
GRPID |
|
Alphanumeric characters and "_" |
|
Within 50 bytes starting with an alphabetic letter |
|
PASSWORD
|
|
Alphanumeric characters |
✔ |
In the range of 8 to 20 bytes |
|
Hexadecimal character string |
|
64 digits |
|||
COMMENT |
|
Characters |
✔ |
Within 60 bytes |
✔ |
: |
Optional |
Blank |
: |
Mandatory |
*1 |
: |
You can set this field when you select "F" (FORMAT) or "M" (MULTI-FMT) for Transfer Type (TRANSTYPE). |
*2 |
: |
This type of cipher key can be set when Forced Strong Key Mode (STRONGKEYMODE) is set to "0" (Disabled) in the System Environment Settings. |
*3 |
: |
This type of cipher key must be set when Forced Strong Key Mode (STRONGKEYMODE) is set to "1" (Enabled) in the System Environment Settings. |
Explanations of each field
This section explains the fields to be specified in a record of the Send Management Information. A string within brackets () is the tag of a field name to be specified when you use a parameter file to register the information.
- File ID (SNDFILE)
-
ID to identify the file to send
Because "_INSTANT_TRANSFER_" is the ID used only for instant transfer, it cannot be specified as File ID.
- Send File Name (FILENAME)
-
File stored on the IBM i operating system
For a physical data file, specify the name in the format of Library name/File name(Member name).
For an archive file, specify the name in the format of Library name/File name.
You cannot use reserved words such as "*FIRST", "*FILE", and so forth, in the name of a send file. Specifying a file name with a reserved word may result in an unexpected behavior of HULFT.
- Transfer Interval (INTERVAL)
-
The interval between Transfer Unit (Transfer Block Length x Transfer Block Count)
If omitted, "0" is set.
- Transfer Block Length (BLOCKLEN)
-
The length of one block during transfer
Transfer Block Length (BLOCKLEN) multiplied by Transfer Block Count (BLOCKCNT) must not exceed 65520.
- Transfer Block Count (BLOCKCNT)
-
The number of blocks per transfer
Transfer Block Length (BLOCKLEN) multiplied by Transfer Block Count (BLOCKCNT) must not exceed 65520.
- Compression Preference (COMP)
-
The options of compression in file transfer
- N :
-
None
- 1 :
-
Horizontal (Compression within records)
- 2 :
-
Vertical (Compression across records)
- 3 :
-
DEFLATE
- DEFLATE Level (DEFLATELEVEL)
-
The compression level for DEFLATE compression
This field can be set only if "3" (DEFLATE) is specified for the Compression Preference (COMP).
- S :
-
Speed
- D :
-
Default
- C :
-
Compression Ratio
If omitted, "D" is set.
- Transfer Priority (TRANSPRTY)
-
The priority in queue when starting the file transfer
Smaller numbers mean higher priority.
- EBCDIC Set (CHARTYPE)
-
The Type-EBCDIC code set that is used for conversion of single-byte codes
If Code Set for Transfer is set to a Type-EBCDIC code set on the local host, specify the same EBCDIC set as that of the sending-side host (local host).
- 0 :
-
Autoconfiguration
- A :
-
Katakana
- B :
-
Lowercase
- C :
-
ASCII
- D :
-
ASPEN
- E :
-
Japan (Latin) for IBM
- F :
-
Japan (Latin) Extended for IBM
- G :
-
NEC Katakana
- H :
-
Japan (Katakana) Extended for IBM
- I :
-
Simplified Chinese Extended
- V :
-
User Table 1
- W :
-
User Table 2
- X :
-
User Table 3
If omitted, "0" (Autoconfiguration) is set.
= Remarks ="D" (EBCDIC ASPEN) and "G" (NEC Katakana) are not recommended.
If you specify "D" (EBCDIC ASPEN) and "G" (NEC Katakana), the files may not be converted.
Use a different code set.
- Transfer Type (TRANSTYPE)
-
The data type of the file to send
- F (FORMAT) :
-
Format data
- B (BINARY) :
-
Binary data
- T (TEXT) :
-
Text data
- M (MULTI-FMT) :
-
Multi format data
- Shiftcode Mode (SHIFTTRANSACT)
-
Handling of shift codes when HULFT performs code conversion
- C (Cut) :
-
Convert to the shortened data by removing shift codes
- S (Space) :
-
Convert shift codes to space codes
If omitted, "C" (Cut) is set.
- Subsequent Character (SPCUT)
-
Handling of trailing spaces
- S :
-
Remove trailing spaces
- N :
-
Do not remove trailing spaces
- Code Conversion (KJCHNGE)
-
The code conversion destination of the files to be sent
- S :
-
Sending Side
- R :
-
Receiving Side
- N :
-
No Conversion
- Send File Mode (CLEAR)
-
Exclusive access control to a Send file during sending and while handling when the sending terminated successfully
- K (Keep) :
-
Never lock the file while sending. The application saves the file after sending terminated successfully.
- C (Clear) :
-
Lock the file while sending. The file turns to be a 0-byte file after sending terminated.
- D (Delete) :
-
Lock the file while sending. The application deletes the file after sending terminated successfully.
- L (Lock) :
-
Lock the file while sending. The application saves the file after sending terminated successfully.
- Pre-send Job ID (PREJOBID)
-
The ID of the Job Information record that represents the job to be started before the sending-side transferring is performed
For details on the Job Information, refer to Job Information.
When omitted, a job does not start.
- Successful Job ID (JOBID)
-
The ID of the Job Information record that represents the job to be started when a sending-side transferring ends successfully
For details on the Job Information, refer to Job Information.
When omitted, the job does not start.
- Unsuccessful Job ID (ERRJOBID)
-
The ID of the Job Information record that represents the job to be started when a sending-side transferring ends unsuccessfully
For details on the Job Information, refer to Job Information.
When omitted, the job does not start.
- Multi/Format ID (FMTID)
-
The ID of a Format Information record or a Multi Format Information record specified for the send file
For details on the Format Information, refer to Format Information.
For details on the Multi Format Information, refer to Multi Format Information.
The format ID is mandatory when Transfer Type is set to "F" (FORMAT), and the multi format ID is mandatory when Transfer Type is set to "M" (MULTI-FMT).
- Interface DBID (DBID)
-
Interface of sending data on the receiving side
- CSV :
-
Convert a Receive file to CSV formatting on the receiving side
When you want to receive the receive file in a CSV format on the receiving-side host (either of UNIX, Linux, NonStop, or Windows), specify "CSV" for this field. When omitted, the receiving in CSV format is not carried out. To establish this interface, specify "F" (FORMAT) or "M" (MULTI-FMT) for the Transfer Type.
- Transfer Group ID (GRPID)
-
The ID of the Transfer Group Information record that represents the group of destination hosts for the send file.
For details on the Transfer Group Information, refer to Transfer Group Information.
- Cipher Key (when Forced Strong Key mode is disabled) (PASSWORD)
-
Key used when data is encrypted in an encryption algorithm
You can apply security to the data to be sent. Specify the same cipher key as is specified in the Receive Management Information on the remote host.
When omitted, the encryption of data is not carried out.
- Cipher Key (when Forced Strong Key mode is enabled) (PASSWORD)
-
Key used when data is encrypted in an encryption algorithm
You can apply security to the data to be sent. Specify the same cipher key as is specified in the Receive Management Information on the remote host.
Make sure that you specify Cipher Key. If the receiving-side host is not in Forced Strong Key mode, a transfer error occurs.
- Comment (COMMENT)
-
Comment on the Send file
Points to be noted on the settings
Compression Preference
In the following cases, even if "3" (DEFLATE) is specified for the Compression Preference (COMP), the file is transferred without being compressed:
-
Sending to HULFT lower than Ver.8 on a receiving host
-
Setting "Y" (Yes) for the Use HULFT7 Comm. Mode in the Host Information
DEFLATE Level
This field cannot be specified if one of the following values for the Compression Preference (COMP) is selected:
-
N (None)
-
1 (Horizontal)
-
2 (Vertical)
Code Conversion
You cannot specify "Receiving Side" if a receiving host is HULFT for Mainframe and Code Set for Transfer in the System Environment Settings of the receiving host is "8" (UTF-8).
When both sending-side and receiving-side hosts are Ver.8.4 or higher, the code converting side may switch to the receiving-side even if you specify "S" (Convert on the sending-side host) for Code Conversion (KJCHNGE), or switch to the sending-side even if you specify "R" (Convert on the receiving-side host) for Code Conversion (KJCHNGE).
For details, refer to the following:
HULFT10 Code Conversion Manual :
Send File Mode
Specify "K" for the Send File Mode, when you let HULFT perform multicasting.
When you send a physical data file with "C" or "D" specified for the Send File Mode, HULFT "clears" or "deletes" the members of the physical data file according to the settings.
Transfer Block Length and Transfer Block Count
If you specify "0" for both the Transfer Block Length (BLOCKLEN) and the Transfer Block Count (BLOCKCNT), HULFT automatically optimizes the size of the Transfer Unit (Transfer Block Length x Transfer Block Count).
However, if you specify "0" for only one of either the Transfer Block Length (BLOCKLEN) or the Transfer Block Count (BLOCKCNT), an error occurs.
For details, refer to the following:
HULFT10 for IBMi Administration Manual :
Replacement Messages
Listed below are the fields that you can replace variables with messages.
By specifying a variable substitution from "&MSG0" to "&MSG5" or from "&MSGL0" to "&MSGL1", you can replace the values of the following fields with the messages that are specified at the time of the Send File or with the messages specified at the time of the Send Request by a receiving host:
-
Send File Name
-
Transfer Group ID
-
Pre-send Job ID
-
Successful Job ID
-
Format ID
-
Multi Format ID
Depending on the language setting of a remote host, the messages may not be assigned properly and the replacement messages may cause transfer to end with an error.
For notes on message transmissions, refer to the following:
HULFT10 for IBMi Administration Manual :
Sending of Chinese language data
Make sure that the Code Set for Transfer (CS4TRNSFR) in the System Environment Settings is set to "C" (IBM Simplified Chinese).
Specify "I" (Simplified Chinese Extended) or "0" (Autoconfiguration) for the EBCDIC Set (CHARTYPE).
Behavior when EBCDIC Set is set to "Autoconfiguration".
When "0 (Autoconfiguration)" is selected as EBCDIC Set, the EBCDIC set actually used when a single byte code conversion is performed during a file transfer is determined as below.
Code Set for Transfer on the local host |
Code Set for Transfer on the remote host |
||||||
---|---|---|---|---|---|---|---|
UTF-8 |
SHIFT-JIS |
EUC-JP |
GB18030 |
IBM Kanji |
JEF |
IBM Simplified Chinese |
|
IBM Kanji |
F | F | F | F | F | ||
IBM Simplified Chinese |
I |
|
|
I |
|
|
I |
Blank : Combinations of code sets that cannot be converted during a file transfer
F: Japan (Latin) Extended for IBM
I: Simplified Chinese Extended
For details on Code Set for Transfer (CS4TRNSFR) of the System Environment Settings in which the code set used on the local host is specified, refer to the following:
HULFT10 for IBMi Administration Manual :
For details on Code Set for Transfer (KCODETYPE) in which the code set used on the remote host is specified, refer to Host Information.