Send Cancelation command

You can cancel the Send processing that is currently in progress or the Send processing in the Send Queue.

Format of command

utlscan {[-f fileID] [-h hostname] |-trid transfer-id|-a}

Explanation of the parameters

-f fileID

File ID of the file for which the Send processing is being carried out or that is placed in the Send Queue, which is to be canceled (Optional)

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

To cancel the sending-side transferring for instant transfer, specify "-f _INSTANT_TRANSFER_".

When you omit this parameter, all the Send processing that is in progress for the corresponding file IDs or that is placed in the Send Queue is canceled.

You cannot specify this parameter when either "-trid transfer-id" or "-a" is specified.

-h hostname

Name of the host on the receiving side for the Send processing that is in progress or that is placed in the Send Queue, which is to be canceled (Optional)

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

When you omit this parameter, all the Send processing that is in progress for the corresponding host names or that is placed in the Send Queue is canceled.

You cannot specify this parameter when either "-trid transfer-id" or "-a" is specified.

-trid transfer-id

Transfer ID of the sending-side transferring instance that is in progress or placed in the Send Queue, which is to be canceled (Optional)

Specify the transfer ID as a 64-byte alphanumeric character string.

You cannot specify this parameter if "-f fileID", "-h hostname", or "-a" is specified.

This parameter is mandatory if you omit all of the "-f fileID", "-h hostname", and "-a" parameters.

-a

Parameter to cancel all the Send processing that is in progress or in the Send Queue (Optional)

You cannot specify this parameter if "-f fileID", "-h hostname", or "-trid transfer-id" is specified.

This parameter is mandatory if you omit all of the "-f fileID", "-h hostname", and "-trid transfer-id" parameters.

Note

• If multiple records with the same host names or file IDs exist, all relevant Send processing is canceled.

• When the Send processing is canceled, the processing shown below will not be carried out:

  • Activation of Post-send Jobs

  • Outputting of Send Control file

• In the following cases, it may take time for the cancelation to actually take place:

  • When a long transfer interval is set

  • When waiting for a response from a remote host

• While HULFT is carrying out processing in any of the situations listed below, you cannot cancel sending:

  • When the Post-send Job execution has started

  • When the successful job is being executed on the host on the receiving side and Notification (JOBWAIT) in the Receive Management Information is set as 'Successful Job Completion' (J)

  • When CSV format conversion is in progress on the host on the receiving side