With the %JUMP command you define a continuation address at which the program is to continue with %CONTINUE, %RESUME or %TRACE. With this address you deviate from the coded program sequence. The command is acknowledged with a message reporting execution of the branch.
With continuation you designate the position in the program where AID is to continue following termination of command input. continuation can only be the address of a COBOL statement.
Command | Operand |
%JUMP | continuation |
%JUMP can only be used for programs which were compiled with the COBOL compiler. For compilation purposes, you must specify the SDF option PREPARE-FOR-JUMPS=YES or the COMOPT statement SEPARATE-TESTPOINTS=YES.
The continuation address must be located in the same program as the current interrupt point, otherwise the command results in an error because essential initializations have not been carried out.
The user must ensure that the prerequisites (e.g. index or counter states, file status) for error-free execution of program as of continuation have been fulfilled. This is especially important if you use the %JUMP command to reach an address which comes logically before the interrupt point in the course of program execution.
You may not enter the %JUMP command in the following cases:
immediately after the LOAD-EXECUTABLE-PROGRAM command
if the program has been interrupted by the system, e.g. because a file to be opened has not yet been assigned
if the K2 key has been used to interrupt the program.
The %JUMP command does not alter the program state.
|
defines the position at which the program is to be continued. continuation must be the address of an executable statement within the current program. If the %JUMP command is part of a subcommand, continuation must designate a statement in the program in which the current interrupt point for test-point or event has occurred.
continuation-OPERAND - - - - - - - - - - - - - - - - - - - - - - - - - - -
{ statement-name | source-reference }
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
statement-name
designates the address of the first instruction in a section or paragraph in the PROCEDURE DIVISION.
{ L'section' | L'paragraph' [IN L'section'] }
An alphanumeric section or paragraph name can be specified without L’...’ since this name cannot be confused with a data name in this command.
If a paragraph name is not unambiguous within a program, it must be identified by the section name of the section in which it was defined: L'paragraph' IN L'section'
source-reference
continuation can only be the address of the first instruction in a section or paragraph in the PROCEDURE DIVISION and can thus only be specified with the following source reference:
S’n’
for lines with paragraph or section names if they do not include a COBOL verb. This means that no %JUMP source-reference is possible for a program that has been compiled with STM-REFERENCE=COLUMN1-T0-6.
Example
%JUMP S'67'
%JUMP PUTOUT
Both commands refer to the example in section “Source listing”.
Statement line 67 contains only the paragraph name PUTOUT. Thus the same continuation address is declared with both commands, namely the first executable statement in the PUTOUT paragraph.