Continue command file
Component: | BS2000 |
Functional area: | Editing command files |
Domain: | not allocated |
Privileges: | OPERATING |
Routing code: | E |
Function
The AGOGO command is used for processing a command file that has been placed in the wait state. Depending on the conditions for continuation, several AGOGO commands may be required, see the ASTOP command.
This command is intended for use in authorized user programs which need to be synchronized with the processing of a command file.
The operator should use this command only in the following situation:
If an authorized user program has been started from a command file and an error has occurred during its execution, the operator can use an AGOGO command (or several, if required) to shorten the wait time which would otherwise elapse before processing is continued. The wait time is 3 minutes, unless a different value has been set using the class 2 system parameter NBRUNWT.
The command must not be issued from a user task with the operating privilege.
The way this command works is described under “Command files for the operator” in the “Introduction to System Administration” [14].
Restrictions when using the “Operator LOGON” function
If the “Operator LOGON” function is used (incompatible mode; system parameter NBCONOPI=Y), the AGOGO 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 AGOGO command is also allowed if the RUN or AGOGO command was issued by an authorized user program with generated authorization names or if the command issuer has been disconnected. In all other cases, the AGOGO command is rejected with message NBR1013.
This restriction does not apply to the CMDFILE running at “SYSTEM READY” time or to any command sequences started from it.
Format
AGOGO |
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No errors | |
1 | 0 | EXC0916 | No command file in ASTOP state |
2 | 0 | NBR1008 | Command acknowledged. Another AGOGO command expected |
64 | NBR1013 | No authorization |