Send Management Information (Mainframe)

The file information of files to be sent is registered.  

(1) Field List

Table 5.11 List of Send Management Information Fields

Field Name

Default Value

Setting Value

Optional

Remarks

File ID

 

Alphanumeric characters

-

Within 8 bytes

Comment

 

Alphanumeric characters

Within 60 bytes

Mainframe DSN

 

Alphanumeric characters

-

Within 44 bytes

Transfer Type

TEXT

(*1)

-

 

Format/Multi Format ID

 

Alphanumeric characters

Within 8 bytes

Compression Level

None

(*1)

-

 

Code Conversion

Sending Side

(*1)

-

 

EBCDIC Code Set

Standard

(*1)

-

 

Send File Mode

Keep

(*1)

-

 

Volume Serial

 

Alphanumeric characters

Within 6 bytes

Transfer Mode

Work File

(*1)

-

 

Work Volume Serial

 

Alphanumeric characters

Within 6 bytes

Capacity

CYL

(*1)

-

 

1ST Extent

5

From 1 to 9999

 

Secondary

3

From 0 to 9999

 

UNIT Quantity

1

From 1 to 59

 

Transfer Group ID

 

Alphanumeric characters

-

Within 8 bytes

Pre-send Job ID

 

Alphanumeric characters

Within 8 bytes

Successful Job ID

 

Alphanumeric characters

Within 8 bytes

Unsuccessful Job ID

 

Alphanumeric characters

Within 8 bytes

Interface DBID

 

CSV, XML

Within 8 bytes

Transfer Interval

0

From 0 to 32768

Unit: 10 milliseconds

Transfer Priority

50

From 1 to 256

 

Transfer Block Length

4096

(*2)

Unit: bytes

Transfer Block Count

3

From 1 to 99

 

Shiftcode Mode

Cut

(*1)

-

 

Subsequent Character

No Cut

(*1)

-

 

UNIT

 

Alphanumeric characters

Within 8 bytes

Sequence Number

 

From 1 to 9999

 

Sending with RDW

No

(*1)

-

 

Encryption Key

 

Alphanumeric characters

8 to 20 bytes

:

Optional

-

:

Mandatory

*1

:

On screen, select an option.

*2

:

Setting value ranges from '6' to '10000' for the destination host lower than HULFT Ver.7, and it ranges from '128' to '10000' for the connection destination of HULFT Ver.7 or higher.

(2) Explanation of Each Field

Each field to be set in Send Management Information is explained.

File ID

The ID to identify the file to send

Specify in alphanumeric character within 8 bytes.

Comment

This is the comment related to the Send file.

Mainframe DSN

Data Set Names (DSN) of Send file stored in mainframe.

Specify according to the naming conventions of Mainframe data set names.

Transfer Type

The data type of file to be sent:

FORMAT:

Format data

BINARY:

Binary data

TEXT:

Text data

MULTIFORMAT:

Multi Format data

Format/Multi Format ID

The ID where the Format or Multi Format of the Send file is registered

For details on the Format ID, refer to Format Information (Mainframe).

For details on the Multi Format ID, refer to Multi Format Information (Mainframe).

Format ID is mandatory when 'FORMAT' is specified for the Transfer Type. Multi Format ID is mandatory when 'MULTIFORMAT' is specified for the Transfer Type.

Compression Level

The compression level at the time of file transfer:

None

 

Horizontal:

Compression within records

Vertical:

Compression across records

Code Conversion

The code conversion destination of the files to be sent

Sending Side:

Sending host conversion

Receiving Side:

Receiving host conversion

No Conversion:

No conversion

EBCDIC Code Set

The EBCDIC code system that is used at the time of conversion from EBCDIC code to ASCII code:

  • Kana

  • Lower Case

  • ASCII

  • ASPEN

  • Standard

  • Standard Extension

  • NEC Kana

  • Kana Extension

  • User Table 1

  • User Table 2

  • User Table 3

 

= Remarks =

You can specify 'Kana Extension' if HULFT at the connection destination is Ver.7.3.0 or higher.

Send File Mode

Exclusive access control while sending the file and the mode when it ends successfully:

Keep:

Saves the file after successful termination without locking when creating the Send work file or while sending

Clear:

Locks when creating the Send work file or while sending and makes it to a 0-byte file after successful end

Delete:

Locks while creating the Send work file or during sending and deletes the file after successful end

Lock:

Locks when the creating Send work file or during sending and saves the file after successful end

Volume Serial

The Volume Serial of the stored Send files.

Specify according to the naming conventions of Mainframe Volume Serial.

Transfer Mode

Transfer mode used for sending the Send file.

Direct:

Direct transfer of the Send file without creating work file

Work File:

Create work file from Send file and transfer

Work Volume Serial

Volume Serial of Send work file.

Specify according to the naming conventions of Mainframe Volume Serial.

Capacity

Space units of Send work file.

CYL:

Cylinder

TRK:

Track

OMIT:

Omitted (Auto Calculation)

1ST Extent

Primary request volume of Send work file.

Secondary

Incremental amount of Send work file.

UNIT Quantity

Multi volume unit count of Send work file.

Transfer Group ID

The ID where send destination of the Send file is registered.

For details on the Transfer Group ID, refer to Transfer Group Information (Mainframe).

Pre-send Job ID

The ID of the job to be started before sending

For details on the Job ID, refer to Job Information (Mainframe).

When omitted, the job is not started.

Successful Job ID

The ID of the job to be executed when sending file is completed successfully.

For details on the Job ID, refer to Job Information (Mainframe).

When omitted, the job is not started.

Unsuccessful Job ID

The ID of the job to be executed when sending file is completed unsuccessfully.

For details on the Job ID, refer to Job Information (Mainframe).

When omitted, the job is not started.

Interface DBID

This is the interface at the receiving side of the sent data:

CSV:

Converts the Receive file into CSV format on the receiving side

XML:

Converts the Receive file into XML format on the receiving side

When the Receive file received on the receiving side is in CSV format (UNIX, Linux, NonStop, and Windows) or in XML format (UNIX, Linux, and Windows), the above fixed characters are specified.

When the field is defaulted, the receiving in CSV format or XML format is not carried out. To establish interface, specify 'FORMAT' or 'MULTIFORMAT' for the Transfer Type.

Transfer Interval

The interval between two blocks in transfer.

Transfer Priority

Priority assignment specifying the order in which files will be transferred.

Smaller the value, higher the priority.

Transfer Block Length

The length of one block during transfer

The product of the Transfer Block Length and the Transfer Block Count cannot exceed 65520.

Transfer Block Count

This refers to the block count that is transferred at one time.

You cannot set the value of which product of multiplication of the Transfer Block Length and the Transfer Block Count exceeds 65520.

Shiftcode Mode

How to handle shift codes when carrying out code conversion

Cut:

Deletes shift codes and makes the data smaller

Space:

Converts from shift codes to space characters

Subsequent Character

Handling of trailing space and NULL (X'00') characters.

Null Cut:

Cuts the trailing null characters

Space Cut:

Cuts the trailing space characters

Both:

Cuts the trailing space and null characters

No Cut:

Does not cut the trailing space and null characters

UNIT

UNIT name where the send file is stored

Sequence Number

The sequence number on the tape volume in which Send file is stored.

Sending with RDW

This field specifies whether to add Record Descriptor Word (RDW) to transfer data or not

Yes:

Send with RDW

No:

Send without RDW (Default)

When you carry out sending with RDW, specify 'B:BINARY' for the Transfer Type.

Encryption Key

The key that encrypts the data.

You can apply security to the file to be sent. Enter the same Encryption Key as set in the Receive Management Information of the remote host.

When you default this field, the file is not encrypted.

(3) Points to be Noted When Setting

Mainframe DSN

Generation file, Partitioned Organization file and VSAM file can also be registered. Relative generation number and file (Member) name are specified within brackets.

Do not enclose the file name with single quotations.

Volume Serial

If Volume Serial Number is omitted, files are considered to be cataloged.

If the Send DSN is VSAM file, it should be cataloged.

UNIT

If UNIT name is omitted, it will be set to the unit group name of Send/Receive file (INIT-UNIT) specified in the System Environment Settings.

Further, if the Volume Serial Number is omitted, unit name will be referred from the catalog. The specified unit name and unit group name of Send/Receive file (INIT-UNIT) set in the System Environment Settings will be ignored.

Send File Mode

If you specify 'C (Clear)' or 'D (Delete)' for the Send File Mode in the Work File Transfer, the operation of HULFT varies according to the setting in the Post-send Clear Mode in the System Environment Settings. Work file is created, regardless of the result of the Send process, successful or unsuccessful. If the Post-send Clear Mode is set to 'A,' Send files or all the records are deleted after the successful termination of the Send processing.

Multicasting is disabled if the Send File Mode is set to other than 'K (Keep).' Still multicasting is enabled if the Send File Mode is set to 'C (Clear)' or 'D (Delete),' and the Post-send Clear Mode is set to 'B,' respectively. If the Send file is VSAM or partitioned organization file, you cannot specify 'C (Clear)' or 'D (Delete)' for the Send File Mode.

In the Work File Transfer, when the code conversion is executed on the sending side, conversion between EBCDIC codes is not available.

Work Volume Serial

If omitted, the location of the creation of work file will vary based on the 'Work Volume Mode.' If the Work Volume Mode is set to '0,' work file will be created in the Volume Serial Number that is defined as the volume of storage attribute. If the Work Volume Mode is set to '1,' work file will be created in the same Volume Serial Number as the Send file.

Capacity

When 'O (Omitted)' is specified in the Capacity, 1st extent, secondary and capacity of the Send work file will be calculated automatically from the Send file capacity.

Since automatic calculation of the capacity is carried out based on the attributes of Send file, the automatic calculation cannot be done in either of the following cases; if Send file is created with elements other than track or cylinder; if Send file is VSAM file.

Further, note that capacity may become insufficient during the creation of work file under following conditions:

In the case of Partitioned Organization file

The capacity of work file is calculated based on the overall partition size.

When the device types of Send file and work file are different

Calculated from the allotted amount of Send file.

Interface DBID

When the database ID (8 bytes alphanumeric character ID) used to load the sent data in UNIX or Windows database is specified, interface can be done with 'DB Interface Option.' Three character alphabets 'CSV' and 'XML' cannot be used as database ID.

UNIT Quantity

When specifying 2 or more for unit quantity, Work Volume Serial cannot be specified.

Replacement Message

The fields that can be used for message replacement are given below.

By specifying the '&MSG0' to '&MSG5' in the following fields, the message specified during Send File issue or the message sent are replaced.

  • Mainframe DSN

  • Volume Serial

  • Work Volume Serial

  • UNIT

  • Transfer Group ID

  • Pre-send Job ID

  • Successful Job ID

  • Format ID

  • Multi Format ID

  • Interface DBID

Restrictions on MT usage

There are restrictions in respect of sending from MTs. For details regarding limitations, refer to Operation Manual.

Shiftcode Mode

Where you would like code conversion on the sending side, specification of 'Cut' for the Shiftcode Mode varies Receive data length according to the setting of the Shiftcode Mode for Send Files (RECLEN) in the System Environment Settings. If 'Y' is specified for the Shiftcode Mode for Send Files, HULFT deletes the shift codes and adds space characters of the same length as the shiftcodes at the end of the record. On the other hand if 'N' is specified, HULFT deletes shift codes to shorten the record length. For the details of the Shiftcode Mode for Send Files, refer to the explanation on each field of the System Environment Settings inAdministration Manual.