The %BASE command is used to specify the base qualification. All subsequently entered memory references without their own base qualification assume the value declared via %BASE. The %BASE command also defines the AID work area.
With the base operand the user designates either the virtual memory area of the program which has been loaded or a dump in a dump file.
Command | Operand |
%BASE | [base] |
With the %BASE command the user also defines the location of the AID work area. When debugging COBOL programs, the AID work area corresponds to the area which the load unit occupies in virtual memory or in a dump file. If the user fails to enter a %BASE command during a debugging session or enters %BASE without any operands, the base qualification E=VM applies by default and the AID work area corresponds to the non-privileged part in virtual memory which is occupied by all connected subsystems from the loaded program (AID standard work area).
A %BASE command is valid until the next %BASE command is given, until /LOGOFF or /EXIT-JOB, or until the dump file declared as the base qualification is closed (see
%DUMPFILE).
The current base qualification is added to all memory references in a command, and also in a subcommand, immediately on input, i.e. a %BASE command has no effect on subcommands specified previously.
%BASE can only be entered as an individual command, it must never be part of a command sequence or subcommand.
%BASE does not alter the program state.
|
defines the base qualification. All subsequently entered memory references without a separate base qualification assume the value declared with the %BASE command.
|
E=VM | The virtual memory area of the program which has been loaded is declared as the base qualification. VM is the default value. |
E=Dn | A dump in a dump file with the link name Dn is declared as the base qualification. Before declaring a dump file as the base qualification, the user must assign the corresponding dump file a link name and open it, using the %DUMPFILE command. |