Unsent Status Queue Modification command

You can change the settings of the records in the Send Queue.

Format of command

utlschange -h hostname -f fileID -p priority [-i time] [-bl blocklen -bc blocks] 
or 
utlschange -h hostname -f fileID -i time [-p priority] [-bl blocklen -bc blocks] 
or 
utlschange -h hostname -f fileID -bl blocklen -bc blocks [-p priority] [-i time]

Explanation of the parameters

-h hostname

Name of the host on the receiving side for the record in the Send Queue whose settings are to be modified (Mandatory)

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

-f fileID

File ID of the file in the Send Queue whose settings are to be modified (Mandatory)

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

To modify the settings of instant transfer records in the Send Queue, specify "-f _INSTANT_TRANSFER_".

-p priority

Priority (Optional)

Specify a value from '1' to '256.' A smaller number means a higher priority.

-i time

Transfer Interval (milliseconds) (Optional)

Specify a value from '0' to '32760.'

-bl blocklen

Transfer Block Length (Optional)

Specify '0' or a value from '128' to '65520.' However, the product of the Transfer Block Length and the Transfer Block Count cannot exceed 65520.

-bc blocks

Transfer Block Count (Optional)

Specify '0' or a value from '1' to '99.' However, the product of the Transfer Block Length and the Transfer Block Count cannot exceed 65520.

Note

  • If more than one record that matches the host name or the file ID exists in the Send Queue, HULFT searches the queue for the host name or for the file ID from the top and retrieves only the first candidate that the application finds.

  • You cannot specify only -bl or only -bc. Be sure to specify both of the parameters.

  • You can omit the following parameters, but not all of them at the same time. You must specify at least one of them.

    • -p

    • -i

    • -bl and -bc

  • If you specify '0' for both -bl blocklen and -bc blocks, HULFT automatically calculates the size of the Transfer Unit (Transfer Block Length x Transfer Block Count).

    However, if you specify '0' for either -bl blocklen or -bc blocks, an error occurs.