%STOP

With the %STOP command you direct AID to halt the program, to switch to command mode and to issue a STOP message. This message indicates the statement and the level of the call hierarchy where the program was interrupted.

If the command is entered at the terminal or from a procedure file, the program state is not altered, since the program is already in the STOP state. In this case you may employ the command to obtain localization information on the program interrupt point by referring to the STOP message.

Command	Operand
%STOP

If the %STOP command is contained in a command sequence or subcommand, any commands following it will not be executed.

If you set a dump file as a basic qualification with %BASE and then enter a %STOP command, AID outputs a STOP message containing localization information for the address at which the program was interrupted when the dump file was written.

If the program has been interrupted by pressing the K2 key, the program interrupt point need not necessarily be within the user program, it may also be located in the runtime system routines.

The %STOP command alters the program state.

A %STOP in a subcommand always refers to the loaded program.

Example

/%IN PROG=SORT.S'20EXI' <%D TAB; %STOP>
/%RESUME

TAB( 1: 9)

( 1)  Jimmy   ( 2)  Maria   ( 3)  Jamie   ( 4)  Lesly   ( 5)  Jonny
( 6)  Donna   ( 7)  Marie   ( 8)  Carol   ( 9)  Frank
STOPPED AT SRC_REF: 20EXI , SOURCE: SORT , PROC: SORT

%INSERT sets a test point for statement EXIT from line 20. The subcommand comprises the %DISPLAY and %STOP commands. After TAB has been output, AID halts the program and writes a STOP message indicating the source reference and program of the current interrupt point.