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 daemon as well as the Send daemon and the Observe daemon 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.
Format of 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 a string of alphanumeric characters (and "_" if desired) that is within 50 bytes.
- -h hostname
-
Name of the remote host to which the Send Request is issued (Optional)
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
-
Messages to be transmitted to the host on the sending side (Optional)
Specify a 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 up to two long messages. For example, to transmit long message 0, specify the long message by using the -msgl0 parameter.
- -sync
-
Parameter to execute a Synchronous Transfer (Optional)
If omitted, HULFT executes the Send Request 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.'
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.
To specify this parameter, you must specify the parameter "-sync".
When you omit this parameter, the value that is set in Utility Timeout (utlwait) in the System Environment Settings file (hulenv.conf) is applied.
Note
-
When you specify the '-h hostname' parameter and omit the '-f fileID' parameter, HULFT executes the Resend Request.
-
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 the following:
HULFT10 for Linux/AIX Administration Manual :