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		Alphanumeric characters	Mandatory	Within 50 bytes (starting with an alphabetic character)	Outside the panel	✓
A2	File Name *4		Alphanumeric characters	Mandatory	From 3 to 33 bytes	Basic Settings	✓
A3	Transfer Type	TEXT	*1	Mandatory		Basic Settings	✓
A4	Compression Preference	None	*1	Mandatory		Basic Settings	✓
A5	DEFLATE Level	Default	*1	Mandatory	*5
A6	Code Conversion	Sending Side	*1	Mandatory		Basic Settings	✓
A7	Pre-send Job ID		Alphanumeric characters	Optional	Within 50 bytes (starting with an alphabetic character)	Basic Settings	✓
A8	Successful Job ID		Alphanumeric characters	Optional	Within 50 bytes (starting with an alphabetic character)	Basic Settings	✓
A9	Unsuccessful Job ID		Alphanumeric characters	Optional	Within 50 bytes (starting with an alphabetic character)	Basic Settings	✓
A10	Multi/Format ID		Alphanumeric characters	Optional	Within 50 bytes (starting with an alphabetic character) *2	Basic Settings	✓
A11	Interface DBID		Alphanumeric characters	Optional	3 bytes *2	Basic Settings	✓
A12	Transfer Group ID	*3	Alphanumeric characters	Mandatory	Within 50 bytes (starting with an alphabetic character)	Outside the panel	✓
A13	Comment		Alphanumeric characters	Optional	Within 60 bytes	Outside the panel	✓
A14	Transfer Interval	0	From 0 to 32767	Mandatory	Unit: msec	Extension Settings	✓
A15	Send File Mode	Keep	*1	Mandatory		Extension Settings	✓
A16	Transfer Block Length	0	0, from 128 to 65520	Mandatory		Extension Settings	✓
A17	Transfer Block Count	0	0, from 1 to 99	Mandatory		Extension Settings	✓
A18	Transfer Priority	50	From 1 to 256	Mandatory		Extension Settings	✓
A19	EBCDIC Set	Autoconfiguration	*1	Mandatory		Extension Settings	✓
A20	Subsequent Character	No Cut	*1	Mandatory		Extension Settings	✓
A21	Cipher Key		*7	*7	*7	Extension Settings	✓
A22	Shiftcode Mode	*6	*1	Mandatory		Extension Settings	✓

*1:	When you configure settings on the screen, select an option from the list that is shown on the screen.
*2:	You can configure this setting when you select 'FORMAT' (F) or 'MULTIFORMAT' (M) for the Transfer Type.
*3:	When you register a Transfer definition in HULFT-HUB Manager, the field is automatically set.
*4:	This information is shown as 'Send File Name' on the Collecting and Distributing System Management Information screen.
*5:	You can configure this setting when you select 'DEFLATE' (3) for the Compression Preference.
*6:	The default value varies depending on the specification of the Kanji Code Type in the Registered Client Information for the client.
	- IBM Kanji or IBM Simplified Chinese: Cut
	- UTF-8: Add
*7:	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. (For versions lower than HULFT Ver.8.4.0, Forced Strong Key Mode is treated as "Disabled".)
	- 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	Batch
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	*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]

For HULFT8 Ver.8.4 or later clients, "_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 file that is stored on IBM i.

For physical data files, specify the format as 'Library Name/File Name (Member Name).'

For stored files, specify the format as 'Library Name/File Name.'

[Remarks]

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

(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

[Note]

For transferring stored files, you can only specify 'BINARY' (B).

(A4) Compression Preference

This field specifies the compression preference 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

(A5) DEFLATE Level

This field specifies the compression level that is used for DEFLATE compression.

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

<Table> Setting Values for DEFLATE Level

On-screen Options	Values in CSV File	Description
Speed	S	Suppress the compression ratio and decrease the compression time
Default	D	Intermediate between Speed and Compression Ratio
Compression Ratio	C	Increase the compression time to prioritize the 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 Side	S	Sending side conversion
Receiving Side	R	Receiving side conversion
No Conversion	N	No conversion

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

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

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

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

(A11) 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 on the host on the receiving side (UNIX, Linux, Nonstop, Windows), specify 'CSV.'

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.

(A12) 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.'

(A13) Comment

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

[Note]

If you enter double-byte codes on a screen in HULFT-HUB Manager, shift codes may be added to the double-byte codes when the information is registered on the client side. If the data exceeds 60 bytes when shift codes are added, HULFT will cut the data of the 61st byte and after.

[Remarks]

You can enter lowercase alphabetic characters.

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

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

(A16) 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.'

(A17) 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.'

(A18) Transfer Priority

This field specifies the priority in the queue for transferring files.

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 you omit this specification in the CSV file for Collecting and Distributing System Management Information, HULFT-HUB sets '50.'

(A19) EBCDIC Set

This field specifies the EBCDIC code system (encoding code scheme) that is used for single byte code conversion.

<Table> Setting Values for EBCDIC Set

On-screen Options	Values in CSV File	Description
Autoconfiguration	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

(A20) Subsequent Character

This field specifies the handling of subsequent characters.

On-screen Options	Values in CSV File	Description
Space Cut	S	Cut trailing spaces
No Cut	N	Do not cut trailing spaces or NULLs

You can select only 'No Cut' (N) if you selected 'BINARY' (B), 'FORMAT' (F), or 'MULTIFORMAT' (M) for the Transfer Type.

(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

The value that can be set varies depending on the specification of the Kanji Code Type in the Registered Client Information for the client.

When the Kanji Code Type is 'IBM Kanji' or 'IBM Simplified Chinese'

This field specifies how to handle shift codes when HULFT sends data to a host that uses a code set that does not use shift codes.

<Table> Setting Values for Shiftcode Mode When Kanji Code Type is 'IBM Kanji' or 'IBM Simplified Chinese'

On-screen Options	Values in CSV File	Description
Cut	C	Cut shift codes from data
Space	S	Replace with space code

When the Kanji Code Type is 'UTF-8'

This field specifies how to handle shift codes when HULFT sends data to a host that uses a code set that uses shift codes.

<Table> Setting Values for Shiftcode Mode When Kanji Code Type is 'UTF-8'

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.

(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 that uses this Send Management Information.

[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.
-	You can use the Message Transmission function if the version of the client is Ver.6 or higher on both the sending side and the receiving side. For details, 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

In either of the following cases, HULFT carries out uncompressed transfer even if you have specified 'DEFLATE' (3) for the Compression Preference:

When the version of the host on the receiving side is lower than Ver.8
When 'Yes' (Y) is specified for the Use HULFT7 Comm. Mode in the Host Information

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 Length and Transfer Block Count

If you set '0' for both the Transfer Block Length and the Transfer Block Count, HULFT system automatically sets 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
IBM Kanji	Optional	Japan (Latin) Extended for IBM (F)
IBM Simplified Chinese	Optional	Simplified Chinese Extended (I)
UTF-8	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)
	KEIS	ASPEN (D)
	NEC Kanji	NEC Katakana (G)
	IBM Simplified Chinese	Simplified Chinese Extended (I)