Receive Cancelation command

You can cancel the Receive processing.

Format of command

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

Explanation of the parameters

-f fileID

File ID of the file for which the Receive processing is being carried out, which is to be canceled (Optional)

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

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

When you omit this parameter, all the Receive processing that is in progress for the corresponding file IDs is canceled.

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

-h hostname

Name of the remote host for the Receive processing that is in progress, 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 Receive processing that is in progress for the corresponding host names is canceled.

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

-trid transfer-id

Transfer ID of the receiving-side transferring instance that is in progress, 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 Receive processing that is in progress (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 name or file ID exist, all the relevant Receive processing is canceled.

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

    • Activation of Post-receive Jobs

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

    • When a long transfer interval is set in the Send Management Information of the host on the sending side

    • When HULFT is waiting for data from a remote host

  • You cannot cancel receiving while HULFT is carrying out processing in any of the situations listed below after HULFT completes transfer:

    • When the Post-receive Job has started

    • When the processing for closing a Receive file has started