Issuing an Instant Transfer Send File request

To send a file with instant transfer, execute the Instant Transfer Send File Issuance command against the Send Acknowledge job.

(1) Instant Transfer Send File Issuance command

Program interface

CALL library name/UTLSEND PARM( ['LIB=library name'] ['FILE=filename']
  ['H=hostname'] ['PORT=portnum'] ['RCVLOC=rcvlocationpath'] ['RCVFILE=rcvfilename']
  ['MODE={T|B}'] ['P=priority'] ['SYNC' ['W=waittime']] ['G'] ['OUTPUT=filename']
  ['EXIT' CLvariable name])

Explanation of parameters

LIB=Library name

Library name in which HULFT is installed ("HULFT" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

FILE=filename

Name of the file to send (Mandatory)

For a physical data file, specify the name in the format of Library name/File name(Member name). For an archive file, specify the name in the format of Library name/File name.

H=hostname

Name of the remote host to send the file to (Mandatory)

Specify this parameter as an alphanumeric character string of 68 bytes or less.

PORT=portnum

Port number of the receiving-side host (Optional)

Specify this parameter in the range of "1" to "65535".

If omitted, "30000" is set.

RCVLOC=rcvlocationpath

Save destination of the receive file (Optional)

Specify characters usable on the receiving side within 200 bytes.

For the save destination used when this parameter is omitted, refer to (2) Points to be noted on the parameters.

RCVFILE=rcvfilename

Name of the receive file (Optional)

Specify characters usable on the receiving side within 200 bytes.

If omitted, the send file name is used as the receive file name as well on the receiving-side host.

For the naming convention applied when the send file name is used as the receive file name, refer to the explanation about the Receive Management Information in Operation Manual for the receiving-side host.

MODE={T|B}

Transfer Type (Optional)

T : Text data

B : Binary data

If omitted, "T" (Text data) is set.

P=priority

Priority of the Send File (Optional)

Specify this parameter within the range of "1" to "256".

Smaller number indicates higher priority.

If omitted, "50" is set.

SYNC

Synchronous Transfer Request (Optional)

When omitted, HULFT executes the Send File asynchronously.

W=waittime

Synchronous Transfer Timeout (Seconds) (Optional)

Specify the waiting time to synchronize processing result on executing the Synchronous Transfer. Specify this parameter within the range of "10" to "259200". When it reaches the time that you specified, the application resumes processing even if it is in the middle of sending. If this occurs, note that the transfer result is not returned to the command. When you set "0" for this parameter, HULFT waits for the result infinitely.

To specify this parameter, you must define the "SYNC" parameter.

When omitted, HULFT waits infinitely until the application receives a processing result.

G

Control of error messages that the Send File command outputs (Optional)

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages that the Send File command outputs (Optional)

Specify this parameter in the format of Library name/File name(Member name).

When omitted, error messages are not output.

The number of log records that a log file can retain is unlimited.

EXIT CL variable name

Specifies to receive the error code output by the Send File command and specifies the CL variable name to set the error code value (Optional)

The CL variable name must be immediately after the EXIT tag.

HULFT sets an error code to the CL variable only if the command ends unsuccessfully.

When omitted, an error code is not set.

Command interface

UTLINSTTRN SNDFILE() SNDMBR() FATR() HOST() PORT() RCVLOC() RCVFILE() MODE()
   PRIORITY() SYNC() WAITTIME() LIBRARY() MSG() FILE() MBR()

Explanation of parameters

SNDFILE

Name of the remote host to send the file to (Mandatory)

Specify this parameter in the format of Library name/File name.

Specify these names as an alphanumeric character string of 10 bytes or less starting with an alphabet, respectively.

SNDMBR

Member name of the file to which error messages are output ("*FILE" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

If omitted, the same file name as the file that is specified for the SNDFILE parameter is used.

FATR

Attribute of the file to send (*PF by default)

*PF :: Physical file
*SAVF :: Archive file

If you specify "*SAVF" for this parameter, the value of SNDAMBR is not used.

HOST

Name of the host to send the file (Mandatory)

Specify this parameter as an alphanumeric character string of 68 bytes or less.

PORT

Port number of the receiving-side host (Optional)

Specify this parameter in the range of "1" to "65535".

If omitted, "30000" is set.

RCVLOC

Save destination of the receive file (Optional)

Specify characters usable on the receiving side within 200 bytes.

For the save destination used when this parameter is omitted, refer to (2) Points to be noted on the parameters.

RCVFILE

Name of the receive file (Optional)

Specify characters usable on the receiving side within 200 bytes.

If omitted, the send file name is used as the receive file name as well on the receiving-side host.

MODE={T|B}

Transfer Type (Optional)

T : Text data

B : Binary data

If omitted, "T" (Text data) is set.

P=priority

Priority of the Send File request for instant transfer (Optional)

Specify this parameter within the range of "001" to "256".

If omitted, "050" is set.

SYNC

Synchronous Transfer Request ("*NO" by default)

*NO :: Asynchronous Transfer
*YES :: Synchronous Transfer

WAITTIME

Synchronous Transfer Timeout (Seconds) (Optional)

Specify the waiting time to synchronize processing result on executing the Synchronous Transfer. Specify this parameter within the range of "000010" to "259200". When you set "000000" for this parameter, HULFT waits for the result infinitely.

To specify this parameter, you must define the "SYNC(*YES)" parameter.

When omitted, HULFT waits infinitely until the application receives a processing result.

LIBRARY

Library name in which HULFT is installed ("HULFT" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

MSG

Control of error messages ("*YES" by default)

*NO :: Suppress error messages.
*YES :: Show error messages.

FILE

Name of the library and the file to which error messages are output (Optional)

Specify this parameter in the format of Library name/File name.

Specify these names as an alphanumeric character string of 10 bytes or less starting with an alphabet, respectively.

When omitted, error messages are not output.

The number of log records that a log file can retain is unlimited.

MBR

Member name of the file to which error messages are output ("*FILE" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

(2) Points to be noted on the parameters

Specifying the receiving-side host

For the receiving-side host, use HULFT Ver.8.4 or higher.

Specifying the receive destination on the receiving side

Specify an existing location for the save destination of the receive file.
Specify the save destination and name of the receive file according to the specifications of the operating system on the receiving side.
If the save destination for the receive file is omitted, a particular location is used on the receiving-side host as the default destination for the receive file. 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 Administration Manual for each host type.
If the file specified as the receive file does not exist, a new receive file is created.

When the file already exists, the existing file is overwritten.
When the receiving-side host is an IBM i and the receive file is newly created, the value for Instant Transfer Receive File Record Size(INSTTRANSRCDLEN) in the System Environment Settings is used. For details, refer to Administration Manual.