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.

(1) 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 Registering and updating a record in management information.

Table 2.1 Fields of the Send Management Information

Field Name

Default Value

Valid Values

Optional

Remarks

Screen

File

File ID

SNDFILE

 

Alphanumeric characters

 

Within 50 bytes starting with an alphabetic letter

Send File Name

FILENAME

 

Alphanumeric characters

 

In the range of 3 to 33 bytes

Transfer Interval

INTERVAL

0

0 to 32767

Unit:Millisecond

Transfer Block Length

BLOCKLEN

0

0,128 to 65520

 

Transfer Block Count

BLOCKCNT

0

0 to 99

 

Compression Preference

COMP

N

N,1,2,3

 

 

DEFLATE Level

DEFLATELVL

D

S,D,C

 

Transfer Priority

TRANSPRTY

50

1 to 256

 

 

EBCDIC Set

CHARTYPE

0

0, A to I, V to X

 

 

Transfer Type

TRANSTYPE

 

F,B,T,M

 

 

Shiftcode Mode

SHIFTTRANSACT

(*1)

Y,N,C,S

 

(*1)

Subsequent Character

SPCUT

N

S,N

 

 

Code Conversion

KJCHNGE

S

S,R,N

 

 

Send File Mode

CLEAR

K

K,C,D,L

 

 

Pre-send Job ID

PREJOBID

 

Alphanumeric characters

Within 50 bytes starting with an alphabetic letter

Successful Job ID

JOBID

 

Alphanumeric characters

Within 50 bytes starting with an alphabetic letter

Unsuccessful Job ID

ERRJOBID

 

Alphanumeric characters

Within 50 bytes starting with an alphabetic letter

Multi/Format ID

FMTID

 

Alphanumeric characters

Within 50 bytes starting with an alphabetic letter

Interface DBID

DBID

 

Alphanumeric characters

Only the string "CSV" (*2)

Transfer Group ID

GRPID

 

Alphanumeric characters

 

Within 50 bytes starting with an alphabetic letter

Cipher Key (when Forced Strong Key mode is disabled) (*3)

PASSWORD
 

 
 

Alphanumeric characters

In the range of 8 to 20 bytes

Cipher Key (when Forced Strong Key mode is enabled) (*4)

Hexadecimal character string

 

64 digits

Comment

COMMENT

 

Characters

Within 60 bytes

:

Optional

Blank

:

Mandatory

*1

:

When omitted, the value of this parameter depends on Code Set for Transfer (CS4TRNSFR) specified in the System Environment Settings:

*2

:

You can set this field when you select "F" (FORMAT) or "M" (MULTI-FMT) for Transfer Type (TRANSTYPE).

*3

:

This type of cipher key can be set when Forced Strong Key Mode (STRONGKEYMODE) is set to "0" (Disabled) in the System Environment Settings.

*4

:

This type of cipher key must be set when Forced Strong Key Mode (STRONGKEYMODE) is set to "1" (Enabled) in the System Environment Settings.

(2) 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 (DEFLATELVL)

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).

If Code Set for Transfer is set to UTF-8 on the local host, specify the same EBCDIC set as that of the receiving-side host (remote 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.

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

Y (Add) :

Add shift codes

N (None) :

Do not add shift codes

When omitted, the value for this parameter depends on Code Set for Transfer (CS4TRNSFR) specified in the System Environment Settings:

Table 2.2 Default and valid values of Shiftcode Mode

Value of Code Set for Transfer (CS4TRNSFR)

Default Value

Valid Values

I (IBM Kanji)

C (Cut)

  • S (Space)

  • C (Cut)

8 (UTF-8)

Y (Add)

  • N (None)

  • Y (Add)

C (IBM Simplified Chinese)

C (Cut)

  • S (Space)

  • C (Cut)

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 ID (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 (PASSWORD) (when Forced Strong Key mode is disabled)

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 (PASSWORD) (when Forced Strong Key mode is enabled)

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

(3) 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 explanation about sending-side and receiving-side conversions in 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 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 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) or "8" (UTF-8).

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.

Table 2.3 Values of EBCDIC Set determined automatically

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

KEIS

NEC Kanji

IBM Simplified Chinese

IBM Kanji

F

F

F

 

F

F

F

F

 

UTF-8

-

-

-

-

F

A

D

G

I

IBM Simplified Chinese

I

 

 

I

 

 

 

 

I

-: Combinations of code sets that are not used for the code conversion during a file transfer.

Blank : Combinations of code sets that cannot be converted during a file transfer

A: Katakana

D: ASPEN

F: Japan (Latin) Extended for IBM

G: NEC Katakana

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 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.