Send File command
To send files, run the Send File command for the Send daemon.
Syntax for the Send File command
utlsend -f fileID [-p priority] [-file filename] [-t tgrp|-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 send (Mandatory)
Specify the parameter as an alphanumeric character string within 50 bytes.
- -p priority
-
Priority of the Send File (Optional)
Specify a value from '1' to '256.'
A smaller number means a higher priority.
If you omit this parameter, the priority registered in the Send Management Information is applied.
- -file filename
-
File name of the file to send (Optional)
Specify the file name as an alphanumeric character string within 200 bytes.
If you omit this parameter, the file name registered in the Send Management Information is set.
In HULFT8 Enterprise grade environments, you can specify a file that uses network resources. For details on networked files, refer to Administration Manual.
In order to specify this parameter, you must set Dynamic Parameter Specification (dynparam) in the System Environment Settings to 'Enable Dynamic Specification.' For details on Dynamic Parameter Specification, refer to Administration Manual.
- -t tgrp
-
Transfer group ID that is used for sending (Optional)
Specify the parameter as an alphanumeric character string within 50 bytes.
If you omit this parameter, the transfer group ID registered in the Send Management Information is set.
In order to specify this parameter, you must set Dynamic Parameter Specification in the System Environment Settings to 'Enable Dynamic Specification.' For details on Dynamic Parameter Specification, refer to Administration Manual.
- -h hostname
-
Host name of a remote host (Optional)
Specify the host name as an alphanumeric character string within 68 bytes.
If you omit this parameter, the transfer group ID registered in the Send Management Information is set.
In order to specify this parameter, you must set Dynamic Parameter Specification in the System Environment Settings to 'Enable Dynamic Specification.' For details on Dynamic Parameter Specification, refer to Administration Manual.
- -msg0 message to -msg5 message
-
Message to be transmitted to the host on the receiving 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 you omit this parameter, the message is not transmitted to the host on the receiving 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 receiving 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 you omit the parameter, the long message is not transmitted to the host on the receiving 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 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.'
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.
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 (hulenv.conf) is applied.
Note
-
When a Pre-send Job is registered in the Send Management Information, note the following points:
-
If the Pre-send Job ends unsuccessfully, the Send File is not executed and the command ends unsuccessfully.
-
Even in the case of multicasting (sending to multiple hosts), the Pre-send Job is executed only once.
-
Even when there is an error in the content of Send Management Information (such as when the transfer group or the host information is not registered), the Pre-send Job is executed.
-
-
When you specify a Synchronous Transfer and issue the Send File, if a communication error occurs and auto resending is carried out, it prevents the Send File command from ending until the completion of the resending.
-
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.
Remarks
You cannot specify the parameters -t and -h at the same time.