Instant Transfer Send File Issuance command

To execute instant transfer, run the Instant Transfer Send File Issuance command.

Format of command

utlsend -file filename -h hostname [-port portnum] 
        [-rcvloc rcvlocationpath] [-rcvfile rcvfilename] 
        [-mode {t|b}] [-p priority] [-sync [-w time]]

Explanation of the parameters

-file filename

File name of the file to send (Mandatory)

Specify an alphanumeric character string within 200 bytes.

-h hostname

Host name of the receiving-side host (Mandatory)

Specify an alphanumeric character string within 68 bytes.

-port portnum

Port number of the receiving-side host (Optional)

Specify a value from "1" to "65535".

Omitting this field sets "30000".

-rcvloc rcvlocationpath

Save destination of the receive file (Optional)

Specify an alphanumeric character string within 200 bytes.

For details on the save destination when the field is omitted, refer to Points to be noted.

-rcvfile rcvfilename

File name of the receive file (Optional)

Specify an alphanumeric character string within 200 bytes.

If you omit this parameter, the receive file is created with the same name as the send file.

-mode {t|b}

Transfer type (Optional)

t:

Text data

b:

Binary data

Omitting this field sets "t".

-p priority

Priority of the Send File request (Optional)

Specify a value from "1" to "256". A smaller number means a higher priority.

Omitting this field sets "50".

-sync

Parameter to issue a Synchronous Transfer request (Optional)

If omitted, HULFT executes the Send File asynchronously.

-w time

Synchronous transfer timeout (seconds) (Optional)

When you specify the Synchronous Transfer, set the wait time for synchronizing the transfer with the result of processing, in the range from '10' to '259200.'

To specify this parameter, you must specify the parameter "-sync".

When you omit this parameter, the value that is set for Socket Read Timeout (socktime) in the System Environment Settings file is applied.

Points to be noted

• Specify HULFT Ver.8.4 or higher for the receiving-side host.

• Specify an existing location for the save destination of the receive file.

• Specify both the save destination and the name for the receive file according to the operating system specifications of the receiving-side host.

• If you omit the save destination for the receive file, the receive file is sent to a specified save destination on the receiving-side host.

  The save destination differs depending on the machine type.

  For details on the default destination used when the save destination for the receive file is omitted, refer to the following for each host type:

  HULFT10 for Windows Administration Manual : Instant transfer

  HULFT10 for Linux/AIX Administration Manual : Instant transfer

  HULFT10 for IBMi Administration Manual : Instant transfer

  HULFT10 for zOS Administration Manual : Instant transfer

• If the specified receive file does not exist, a new receive file is created.