Issuing a Send Request request

To make a request for sending to a remote host from the receiving-side host, execute the Send Request Issuance command.

Before you execute the Send Request Issuance command, make sure that the Send Acknowledge job and the Observe job are running on the remote host and that the Receive Acknowledge job is running on the local host. To make the remote host send the file properly, required records of management information must be registered appropriately in advance.

(1) Send Request Issuance command

Program interface

CALL Library name/UTLRECV PARM(['LIB=Library name'] 'F=fileid' ['H=hostname']
   ['MSG0=message0'] ['MSG1=message1'] ['MSG2=message2'] ['MSG3=message3']
   ['MSG4=message4'] ['MSG5=message5'] ['MSGL0=lmessage0'] ['MSGL1=lmessage1']
   ['SYNC'] ['W=waittime'] ['G'] ['OUTPUT=filename'] ['EXIT' CL variable 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.

F=fileid

File ID that is used for receiving (Mandatory)

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

H=hostname

Name of remote host to which you submit a request for sending (Optional)

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

When omitted, the request is submitted to all the hosts registered in the Transfer Group of the Receive Management Information.

MSG0=message0 to MSG5=message5

Messages to be transmitted to sending host (Optional)

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

When omitted, no message will be transmitted to the host on the sending side.

You can specify 6 messages at maximum. For example, to transmit message 0, specify a string for "MSG0=" parameter.

MSGL0=lmessage0 to MSGL1=lmessage1

Long message to be transmitted to the sending host (Optional)

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

When omitted, no message will be transmitted to the host on the sending side.

You can specify 2 messages at maximum. For example, to transmit long message 0, specify a string for "MSGL0=" parameter.

SYNC

Synchronous Transfer Request (Optional)

When omitted, Send Request is issued in Asynchronous mode.

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 receiving. 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 applies the value of Socket Read Timeout (SOCKTIME) specified in the System Environment Settings file.

G

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

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages that the Send Request 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 Request command and specifies the CL variable name to set the error code value (Optional)

The CL variable name must immediately follow 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.

Note

To assign messages that are specified for the parameters from MSG0 to MSG5 and from MSGL0 to MSGL1, you must specify "1", "2", or "3", for Message Dynamic Parameter Specification (MSGDYNPARM) in the System Environment Settings.

Depending on the language setting of a remote host, the messages may not be assigned properly and the replacement messages may cause transfer to end with an error.

For notes on message transmissions, refer to Administration Manual.
HULFT handles the replacement messages that are assigned by parameters from MSG0 to MSG5 and from MSGL0 to MSGL1 in accordance with the CCSID (Coded Character Set Identifier) that is specified for HULFT Character Set (HULCHARSET) of the System Environment Settings. When you want to handle the data using the same character set as the one used in HULFT for IBMi lower than Ver.8, modify the value of the Character Set Options for Messages (CHARSETOPTMSG) of the System Environment Settings.

For details of settings, refer to the explanation on the System Environment Settings in Administration Manual.

Command interface

UTLRECV FILEID( ) HOSTNAME( ) MSG0( ) MSG1( ) MSG2( ) MSG3( ) MSG4( ) MSG5( )
   MSGL0( ) MSGL1( ) SYNC( ) WAITTIME( ) LIBRARY( ) MSG( ) FILE( ) MBR( )

Explanation of parameters

FILEID

File ID that is used for receiving (Mandatory)

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

HOSTNAME

Name of remote host to which you submit a request for sending (Optional)

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

When omitted, the request is submitted to all the hosts registered in the Transfer Group of the Receive Management Information.

MSG0 to MSG5

Messages to be transmitted to sending host (Optional)

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

When omitted, no message will be transmitted to the host on the sending side.

MSGL0 to MSGL1

Messages to be transmitted to sending host (Optional)

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

When omitted, no message will be transmitted to the host on the sending side.

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 applies the value of Socket Read Timeout (SOCKTIME) specified in the System Environment Settings file.

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.