Send File command

To send files, run the Send File command.

Format of 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 a string of alphanumeric characters (and "_" if desired) that is 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 set.

-file filename

File name of the file to send (Optional)

Specify characters within 200 bytes.

If you omit this parameter, the file name registered in the Send Management Information is set.

In HULFT10 Server grade environments, you can specify a file that uses network resources. For details on networked files, refer to the following:

HULFT10 for Windows Administration Manual : Networked files

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 the following:

HULFT10 for Windows Administration Manual : Send and Receive

-t tgrp

Transfer group ID that is used for sending (Optional)

Specify a string of alphanumeric characters (and "_" if desired) that is within 50 bytes.

If you omit this parameter, the transfer group ID that is registered in the Send Management Information is set.

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 the following:

HULFT10 for Windows Administration Manual : Send and Receive

-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 that is registered in the Send Management Information is set.

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 the following:

HULFT10 for Windows Administration Manual : Send and Receive

-msg0 message to -msg5 message

Message to be transmitted to the host on the receiving 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 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 this parameter, the long message is not transmitted to the host on the receiving side.

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

-sync

Parameter to carry out a Synchronous Transfer (Optional)

If omitted, HULFT executes the Send File 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 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 Socket Read Timeout (socktime) in the System Environment Settings file (hulenv.cnf) is applied.

Note

  • When a Pre-send Job is registered in the Send Management Information, note the following points:

    • When 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 a 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 resending is complete.

  • 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 Windows Administration Manual : Message transmission

Remarks

You cannot specify -t and -h at the same time.