Function
Puts the object program into a halted state.
Format
HALT text
The text may be up to 40 characters long. Excess characters will be lost.
Forbidden contexts
NO CORE IMAGE,PROGRAM
(Note that HALT is not allowed when break-in occurs during a command
issued by an object program.)
Execution
The HALT command generates a pseudo program event of the category HALTED. The category of this event and the text, if any, specified in the command are written to the monitoring file system as output of the OBJECT category. In addition the category of the event and the text, together with the number of the current program member, are set up as the current program event message, overwriting information stored by a previous program event.
If HALT is issued during break-in and the break-in occurred while the object program was running, this run of the program will be terminated. This means that when the break-in finishes, the job will return to command level as if a program event had occurred.
Example
HALT
Error Messages
None