Send Management Information

This topic explains how to register the file information for the file to be sent.

You can view and modify this information on the following screens:

Transfer Information screen
Collecting and Distributing System Management Information screen

You can also import and export this information on the following screen:

Collecting and Distributing System Management Information screen

[Note]

For versions lower than HULFT-HUB Server Ver.3.9, if the client is HULFT Ver.8.4 or higher and the Forced Strong Key Mode is set to 'Enabled' in the System Environment Settings, connection with the client is not supported. Therefore, it is not possible to view, update, or newly register the management information for that client.

List of Fields

1. Send Management Information

<Table> List of Fields for Send Management Information

No.	Field Name	Default Value	Setting Value	Specification	Remarks	Transfer	Distribute
A1	File ID		Uppercase alphanumeric characters and "_" *1	Mandatory	Within 50 bytes	Outside the panel	✓
A2	File Name		Alphanumeric characters	Mandatory	Within 200 bytes	Basic Settings	✓
A3	Transfer Type	TEXT	*2	Mandatory		Basic Settings	✓
A4	Compression Preference	None	*2	Mandatory		Basic Settings	✓
A5	Compression Mode		*2	Mandatory	*5	Basic Settings	✓
A6	Code Conversion	Sending Host	*2	Mandatory		Basic Settings	✓
A7	Compression Unit		0, from 1 to 32760	Optional	Unit: byte	Basic Settings	✓
A8	Pre-send Job ID		Alphanumeric characters and "_" *1	Optional	Within 50 bytes	Basic Settings	✓
A9	Successful Job ID		Alphanumeric characters and "_" *1	Optional	Within 50 bytes	Basic Settings	✓
A10	Unsuccessful Job ID		Alphanumeric characters and "_" *1	Optional	Within 50 bytes	Basic Settings	✓
A11	Format/Multi Format ID		Alphanumeric characters and "_" *1	Optional	Within 50 bytes *3	Basic Settings	✓
A12	Interface DBID		Alphanumeric characters	Optional	3 bytes *3	Basic Settings	✓
A13	Transfer Group ID	*4	Alphanumeric characters and "_" *1	Optional	Within 50 bytes	Outside the panel	✓
A14	Comment		Alphanumeric characters	Optional	Within 60 bytes	Outside the panel	✓
A15	Transfer Interval	0	From 0 to 32760	Mandatory	Unit: msec	Extension Settings	✓
A16	Send File Mode	Keep	*2	Mandatory		Extension Settings	✓
A17	Transfer Block Length	0	0, from 128 to 65520	Mandatory	Unit: byte	Extension Settings	✓
A18	Transfer Block Count	0	0, from 1 to 99	Mandatory		Extension Settings	✓
A19	Transfer Priority	50	From 1 to 256	Mandatory		Extension Settings	✓
A20	EBCDIC Set	Autoconfiguration	*2	Mandatory		Extension Settings	✓
A21	Cipher Key		*6	*6	*6	Extension Settings	✓
A22	Shiftcode Mode	Add	*2	Mandatory		Extension Settings	✓

*1:	If the Controlling Server is HULFT-HUB Server that is lower than Ver.3.10, you cannot use "_".
*2:	When you configure settings on the screen, select an option from the list that is shown on the screen.
*3:	You can configure this setting when you select 'FORMAT' (F) or 'MULTIFORMAT' (M) for the Transfer Type.
*4:	When you register a Transfer definition in HULFT-HUB Manager, the default value of the field is automatically set.
*5:	You can configure this setting when you select 'DEFLATE' (3) or 'Zstandard' (4) for the Compression Preference.
*6:	The value that can be specified for Cipher Key differs depending on the value specified for Forced Strong Key Mode in the System Environment Settings of the client.
	- Forced Strong Key Mode is "Disabled": 8 to 20 alphanumeric characters (Optional).
	- Forced Strong Key Mode is "Enabled": 64-character hexadecimal text string (0-9, A-F) (Mandatory).

2. Additional information other than Send Management Information

You can view both the Send Management Information and the following additional information on each screen where you edit Transfer definitions.

<Table> List of Fields for Additional Information other than Send Management Information

No.	Field Name	Setting Value	Specification	Remarks	Transfer	Distribute
B1	Host Name	Alphanumeric characters	*1		Outside the panel	-
B2	File Alias *2	Alphanumeric characters	Optional	Within 256 bytes	Outside the panel	✓
B3	Batch Distribution ID	Alphanumeric characters	*1		-	✓
B4	Business Group ID	Alphanumeric characters	*3		-	✓

*1:	You are allowed only to view this field on the screen.
*2:	This information is shown as 'Alias' on the Collecting and Distributing System Management Information screen.
*3:	When you configure settings on the screen, select an option from the list that is shown on the screen.

[Legend]
Default Value	Value that is set for the field when you create a new management information record on a screen
Specification	Whether the specification is mandatory or optional when you update the management information record on a screen
Transfer	Transfer Information screen
Distribute	Collecting and Distributing System Management Information screen
✓	Availability of the field

Explanation of Each Field

The following describes the fields that are configured in the Send Management Information.

For a field for which you select an option from the list, the following shows both the options that are displayed on the screen and the values that are described in the CSV file to be used for Collecting and Distributing System Management Information.

1. Send Management Information

(A1) File ID

This field specifies the ID to identify the file to be sent.

[Note]

"_INSTANT_TRANSFER_" cannot be specified in File ID. "_INSTANT_TRANSFER_" is a file ID exclusively for Instant Transfer.

(A2) File Name

This field specifies the Send file that is stored on UNIX.

Specify the absolute path.

In HULFT10 for Linux/AIX-Enterprise, you can specify the name of a file that uses network resources.

(A3) Transfer Type

This field specifies the data type of the file to be sent.

<Table> Setting Values for Transfer Type

On-screen Options	Values in CSV File	Description
FORMAT	F	Format data
BINARY	B	Binary data
TEXT	T	Text data
MULTIFORMAT	M	Multi format data

(A4) Compression Preference

This field specifies the compression type when the file is transferred.

<Table> Setting Values for Compression Preference

On-screen Options	Values in CSV File	Description
None	N	No compression
Horizontal	1	Compression within each record
Vertical	2	Compression across records
DEFLATE	3	DEFLATE compression
Zstandard	4	Zstandard compression

(A5) Compression Mode

This field specifies the compression mode that is used for DEFLATE or Zstandard compression.

You can set this field only if you have specified 'DEFLATE' (3) or 'Zstandard' (4) for the Compression Preference.

<Table> Setting Values for Compression Mode

On-screen Options	Values in CSV File	Description
Speed	S	Give priority to speed over compression ratio
Compression Ratio	C	Give priority to compression ratio over speed
Default	D	Intermediate between Speed and Compression Ratio

(A6) Code Conversion

This field specifies the host that carries out code conversion for the file to be sent.

<Table> Setting Values for Code Conversion

On-screen Options	Values in CSV File	Description
Sending Host	S	Sending side conversion
Receiving Host	R	Receiving side conversion
No Conversion	N	No conversion

(A7) Compression Unit

This field specifies the record processing units when binary files are compressed.

When "BINARY" (B) is specified for Transfer Type and either "Horizontal" (1) or "Vertical" (2) is specified for Compression Preference, this field is used to specify the Compression Unit.

Processing is carried out faster for larger setting values. (However, more memory is used.)

(A8) Pre-send Job ID

This field specifies the ID of the job that HULFT starts before the Send processing is carried out.

For details about the Job ID, refer to Job Information.

If you omit this field, HULFT does not start the job.

(A9) Successful Job ID

This field specifies the ID of the job that HULFT starts when the sending of the file ends successfully.

For details about the Job ID, refer to Job Information.

If you omit this field, HULFT does not start the job.

(A10) Unsuccessful Job ID

This field specifies the ID of the job that HULFT starts when the sending of the file ends unsuccessfully.

For details about the Job ID, refer to Job Information.

If you omit this field, HULFT does not start the job.

(A11) Format/Multi Format ID

This field specifies the registered ID for format or multi format of the file to be sent.

For details about the Format ID, refer to Format Information.

For details about the Multi Format ID, refer to Multi Format Information.

If the Transfer Type is 'FORMAT' (F), the format ID is required; if the Transfer Type is 'MULTIFORMAT' (M), the multi format ID is required.

(A12) Interface DBID

This field specifies the interface on the host on the receiving side for sending data.

- CSV:

Carry out CSV conversion of the Receive file on the host on the receiving side

To receive the file in CSV format (UNIX, Linux, Nonstop, Windows) on the host on the receiving side, specify the fixed characters that are shown above.

If you omit this field, HULFT does not carry out receiving in CSV format.

To interface, select 'FORMAT' (F) or 'MULTIFORMAT' (M) for the Transfer Type.

(A13) Transfer Group ID

This field specifies the ID for which the sending destination host for the file to be sent is registered.

For details about the Transfer Group ID, refer to Transfer Group Information.

[Note]

For Transfer definitions that are registered on the Transfer Information screen in HULFT-HUB Manager, HULFT-HUB automatically selects as default values the transfer group IDs (for transfer groups that are registered on the client side) that include the host on the receiving side that is selected in the transfer map. If there is no relevant transfer group ID, HULFT-HUB automatically sets an 8-character transfer group ID that starts with 'HB.'

(A14) Comment

This field specifies the comment regarding the file to be sent.

(A15) Transfer Interval

This field specifies the interval from the end of the transfer of one block (the product of the Transfer Block Length and the Transfer Block Count) to the transfer of the next block.

This allows files to be transferred without monopolizing the network (intermittent transfer).

(A16) Send File Mode

This field specifies whether to apply the exclusive control during sending of the Send file, and the processing when the sending of the file ends successfully.

<Table> Setting Values for Send File Mode

On-screen Options	Values in CSV File	Description
Keep	K	Do not lock during sending, and save the file after the sending of the file ends successfully
Clear	C	Lock during sending, and make the file a 0-byte file after the sending of the file ends successfully
Delete	D	Lock during sending, and delete the file after the sending of the file ends successfully
Lock	L	Lock during sending, and save the file after the sending of the file ends successfully

[Note]
-	If you select anything other than 'Keep' (K) for the Send File Mode, HULFT cannot carry out multicasting that transmits from HULFT on the sending side to all transfer destinations (client-side multicasting function).

(A17) Transfer Block Length

This field specifies the length of one block for transfer.

You cannot set this value so that the product of the Transfer Block Length and the Transfer Block Count exceeds '65520.'

(A18) Transfer Block Count

This field specifies the number of blocks per transfer.

You cannot set this value so that the product of the Transfer Block Length and the Transfer Block Count exceeds '65520.'

(A19) Transfer Priority

This field specifies the priority in the queue for starting file transfer.

Greater priority is given to smaller numeric values.

If there is more than one transfer processing in the queue, you can start the Send processing for the file you want to send first by setting a lower value for the transfer priority.

If this specification is omitted in the CSV file for Collecting and Distributing System Management Information, HULFT-HUB sets '50.'

(A20) EBCDIC Set

This field specifies the EBCDIC code system (encoding code scheme) that is used for conversion from ASCII to EBCDIC.

<Table> Setting Values for EBCDIC Set

On-screen Options	Values in CSV File	Description
Autoconfiguration *1	0	Autoconfiguration
Katakana	A	EBCDIC Katakana
Lower Case	B	EBCDIC Lower Case
ASCII	C	EBCDIC ASCII
ASPEN	D	EBCDIC ASPEN
Japan (Latin) for IBM	E	Japan (Latin) for IBM
Japan (Latin) Extended for IBM	F	Japan (Latin) Extended for IBM
NEC Katakana	G	NEC Katakana
Japan (Katakana) Extended for IBM	H	Japan (Katakana) Extended for IBM
Simplified Chinese Extended	I	Simplified Chinese Extended
User Table 1	V	User Table 1
User Table 2	W	User Table 2
User Table 3	X	User Table 3

[Remarks]

'ASPEN' (D) and 'NEC Katakana' (G) are not recommended.

If you specify 'ASPEN' (D) or 'NEC Katakana' (G), the files may not be converted.

Use a different code set.

(A21) Cipher Key

This field specifies the key for encrypting data.

Security is applied to the file to be sent. Set the same cipher key that has been set in the Receive Management Information on the remote host.

(A22) Shiftcode Mode

This field specifies whether to add shift codes when HULFT carries out code conversion.

<Table> Setting Values for Shiftcode Mode

On-screen Options	Values in CSV File	Description
Add	Y	Add shift codes
Do Not Add	N	Do not add shift codes

2. Additional information other than Send Management Information

This additional information is displayed together with the Send Management Information on each screen where you edit Transfer definitions. You can view and modify this information on screens in HULFT-HUB Manager.

[Note]

You cannot view this additional information on the Management screen on the client (HULFT) side.

(B1) Host Name

This field shows the host name of the client on which the Send Management Information is registered.

[Remarks]

You can view this field only on the Transfer Information screen (cannot be modified).

(B2) File Alias

This field specifies the alias for the file to be sent.

It is recommended that you assign a unique name in the Send Management Information so that each file ID that is displayed on screens in HULFT-HUB Manager can be easily identified.

[Remarks]

This information is shown as 'Alias' on the Collecting and Distributing System Management Information screen.

(B3) Batch Distribution ID

This field shows the Batch Distribution Information ID with which the Send Management Information is registered as distribution data.

[Remarks]

You can view this field on the Collecting and Distributing System Management Information screen (cannot be modified).

(B4) Business Group ID

This field specifies the Business Group ID to which this Send Management Information belongs.

[Remarks]

You can view this field on the Collecting and Distributing System Management Information screen.

Points to be Noted When Configuring Settings

1. Replacement message

You can replace variables with the messages that you specify when issuing the Send File or with received messages, by specifying the variables from '$MSG0' to '$MSG5' or from '$MSGL0' to '$MSGL1' in the following fields (Message Transmission function):

- File Name

- Pre-send Job ID

- Successful Job ID

- Format ID

- Multi Format ID

- Transfer Group ID

[Note]
-	You can edit the Transfer Group ID only on the Collecting and Distributing System Management Information screen. On the Transfer Information screen, you can select only an ID that has been set automatically by HULFT-HUB Manager or an existing transfer group ID, and therefore you cannot carry out replacement with message.
-	For details about the Message Transmission function, refer to Administration Manual for the client.
-	Depending on the language settings on the remote host, replacement with message may not be carried out correctly and transfer may fail. For details, refer to Administration Manual.

2. Compression Preference

'DEFLATE' (3) is enabled if the client on the receiving side is HULFT8.

When the client on the receiving side is lower than HULFT8, transferred data will not be compressed even if you specify 'DEFLATE' (3).
'Zstandard' (4) is enabled if the client on the receiving side is HULFT10 or higher.

If the client on the receiving side is lower than HULFT10, when you specify 'Zstandard' (4), HULFT operates according to the setting value of 'Compression Type Selection' in the System Environment settings.

3. Code Conversion

If the sending side client and receiving side client are both running HULFT Ver. 8.4 or higher, even if the user specifies "Sending Side" (S) in Code Conversion, receiving side conversion might switch automatically. In addition, even if "Receiving Side" (R) is specified in Code Conversion, sending side conversion might switch automatically. This is called "automatic switching of sending side conversion and receiving side conversion". For details, refer to Code Conversion Manual.

However, for transfers via HULFT-HUB Server Ver.3.8, automatic switching is disabled for sending side conversion and receiving side conversion.
If the receiving side client is HULFT for Mainframe and "UTF-8" is specified for Kanji Code Type in the Registered Client Information for that client, receiving side conversion is not available. Therefore, specify "Sending Side" (S) for Code Conversion.

4. Transfer Block Count and Transfer Block Length

If you set '0' for both the Transfer Block Length and the Transfer Block Count, HULFT automatically optimizes the size of the transfer unit (the product of the Transfer Block Length and the Transfer Block Count).

However, if you specify '0' for only the Transfer Block Length or for only the Transfer Block Count, an error occurs.

For details, refer to Administration Manual for the client.

5. Automatic Setting of EBCDIC Set

If you specify 'Autoconfiguration' (0) for the EBCDIC Set, the type of EBCDIC that is actually used depends on the combination of the Kanji Code Type that is set in the Registered Client Information on both the client on the sending side and the client on the receiving side, as shown below.

<Table> Values When EBCDIC Set is Set to 'Autoconfiguration' (0)

Kanji Code Type of Sending Client	Kanji Code Type of Receiving Client	EBCDIC to Be Used
UTF-8 SHIFT-JIS EUC-JP	UTF-8	Katakana (A)
	SHIFT-JIS	Katakana (A)
	EUC-JP	Katakana (A)
	GB18030	Katakana (A)
	IBM Kanji	Japan (Latin) Extended for IBM (F)
	JEF	Katakana (A)
GB18030	UTF-8	Katakana (A)
GB18030	IBM Simplified Chinese	Simplified Chinese Extended (I)