Receive Cancelation command
You can cancel the Receive processing.
Syntax for the Receive Cancelation 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 an alphanumeric character string 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 corresponding file IDs is canceled.
You cannot specify this parameter when you specify the parameter "-trid transfer-id" or "-a".
- -h hostname
-
Host name of the remote host for the Receive processing 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 you specify the parameter "-trid transfer-id" or "-a".
- -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 when you specify any of the following parameters: "-f fileid", "-h hostname", and "-a".
You cannot omit this parameter when you omit all of the following parameters: "-f fileid", "-h hostname", and "-a".
- -a
-
Parameter to cancel all the Receive processing that is in progress (Optional)
You cannot specify this parameter when you specify any of the following parameters: "-f fileid", "-h hostname", and "-trid transfer-id".
You cannot omit this parameter when you omit all of the following parameters: "-f fileid", "-h hostname", and "-trid transfer-id".
Note
-
When multiple records with the same host name and 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
-
Mail Interface
-
-
In the following cases, it may take time for the cancelation to actually take place:
-
When a long transfer interval is specified in the Send Management Information of the host on the sending side
-
When HULFT is waiting for data from a remote host
-
-
While HULFT is carrying out any of the processing listed below after HULFT completes transfer, you cannot cancel receiving:
-
When a Post-receive Job has started
-
When the processing for closing a Receive file has started
-