Cancel processing of command file
Component: | BS2000 |
Functional area: | Editing command files |
Domain: | not allocated |
Privileges: | OPERATING |
Routing code: | E |
Function
The CANCEL-RUN-PROCESS command cancels processing of a command file that has already been started. In order to execute it, the operator must specify a RUN-ID. This is assigned to each command file started by means of the RUN command. Command files that are started from another RUN sequence are assigned the same RUN-ID as the generating command file. When a command file is canceled by means of CANCEL-RUN-PROCESS all the command files generated by it are canceled automatically.
This command must not necessarily be entered at the same console as the RUN command. However, it does require the routing code E.
The command must not be issued from a user task with the operating privilege.
Restrictions when using the “Operator LOGON” function
If the “Operator LOGON” function is used (system parameter NBCONOPI=Y), the command is not accepted after “SYSTEM READY” unless the originating task is running under TSOS or under the user ID which entered the RUN command. The command is also allowed if the RUN command was issued by an authorized user program with generated authorization names or if the RUN command issuer has been disconnected. In all other cases, If this condition is not met, the command is rejected with message NBR0002.
Format
CANCEL-RUN-PROCESS |
RUN-ID = <alphanum-name 1..4> |
Operands
RUN-ID = <alphanum-name 1..4>
ID of the command file to be canceled. A unique RUN-ID is assigned to each command file started by means of the RUN command. If no RUN-ID or an unknown RUN-ID is specified, the command is rejected.
For information on using command files, see the section on “Command files for the operator” in the “Introduction to System Administration” [14].
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | CMD0202 | Syntax error | |
64 | NBR0001 | Specified RUN-ID not found | |
64 | NBR0002 | No authorization |