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 targeted for sending (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 parameter 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 Note.

-rcvfile rcvfilename

File name of the receive file (Optional)

Specify an alphanumeric character string within 200 bytes.

When 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 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 execute a Synchronous Transfer, specify the wait time for synchronizing the transfer with the processing result, 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 Utility Timeout (utlwait) in the System Environment Settings file is applied.

Note

  • Specify HULFT Ver.8.4 or later 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.