Send Request command

To issue a Send Request to a remote host from the host on the receiving side, run the Send Request command and send a request for sending to the remote host.

To run the Send Request command, it is necessary to activate the Receive process, the Send process, and the Observe process of the remote host in advance.

To carry out the sending, it is also necessary to appropriately register the management information required by the remote host in advance.

Syntax for the Send Request command

utlrecv -f fileid [-h hostname] 
             [-msg0 message] [-msg1 message] [-msg2 message] 
             [-msg3 message] [-msg4 message] [-msg5 message] 
             [-msgl0 message] [-msgl1 message] 
             [-sync [-w time]]

Explanation of the parameters

-f fileid

File ID of the file to be received (Mandatory)

Specify an alphanumeric character string within 50 bytes.

-h hostname

Name of the remote host to which the Send Request is issued

Specify the host name as an alphanumeric character string within 68 bytes.

If omitted, requests are sent to all the hosts in the transfer group that is registered in the Receive Management Information.

-msg0 message to -msg5 message

Message to be transmitted to the host on the sending side (Optional)

Specify an alphanumeric character string within 50 bytes.

When you specify spaces or meta characters in a message, place the entire message within double quotation marks (").

If omitted, the message is not transmitted to the host on the sending side.

You can specify from message 0 to message 5, for a total of up to six messages. For example, to transmit message 0, specify the message by using the -msg0 parameter.

-msgl0 message to -msgl1 message

Long messages to be transmitted to the host on the sending side (Optional)

Specify a character string within 200 bytes.

When you specify spaces or meta characters in a long message, place the entire message within double quotation marks (").

If omitted, the long message is not transmitted to the host on the sending side.

You can specify a maximum of two long messages. For example, to transmit long message 0, specify the message by using the -msgl0 parameter.

-sync

Parameter to carry out a Synchronous Transfer (Optional)

If omitted, HULFT executes the Send Request 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.'

When it reaches the time that you specified, HULFT 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.

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 (hulenv.cnf) is applied.

Note

  • When you specify the parameter '-h hostname' and omit the parameter '-f fileID,' HULFT executes the Resend Request.

    The purpose of this behavior is to maintain compatibility with lower versions.

  • If you specify '-msg0 message' to '-msg5 message' or '-msgl0 message' to
    '-msgl1 message,' HULFT may not be able to replace the variables with the messages correctly and the transfer may fail, depending on the language settings on the remote host.

    For points to be noted on message transmission, refer to Administration Manual.