With the %SYMLIB command you direct AID to open or close PLAM libraries. AID accesses open PLAM libraries if symbolic memory references located in a program for which no LSD records have been loaded are addressed in a command.
With qualification-a-lib you open or close one or more libraries in which object modules and their associated LSD records are stored. In order to dynamically load LSD records, any library can be assigned to the current program or to a dump file by specifying the appropriate base qualification.
Command | Operand |
%SYMLIB | [qualification-a-lib][,...] |
When this command is executed AID checks only whether the specified library can be opened; it does not check whether the contents of the library match the program being processed. Thus it is possible to initially open all libraries which you might need later during a test run. AID does not check whether the object module of the program which has been addressed matches that of the PLAM library until the dynamically loaded LSD records are accessed.
If several libraries have been opened for a base qualification, AID scans them in the order in which they were specified in the %SYMLIB command.
If the AID search is not successful or if no library with %DUMPFILE is open, you may assign the correct library by way of a new %SYMLIB command after the corresponding message has been issued. You then repeat the command for whose execution the LSD records were lacking.
A library remains open until it is closed by:
a new %SYMLIB command for the same base qualification
a %SYMLIB without an operand
a %DUMPFILE command with which the file is closed
or by /LOGOFF or /EXIT-JOB.
If a new command contains new file names, these libraries are assigned and opened.
The %SYMLIB command does not alter the program state.
qualification-a-lib |
is a base qualification and/or the file name of a PLAM library.
If you enter a base qualification and a file name, AID assigns the specified library for this base qualification and opens it. Previously assigned libraries for the same base qualification are closed.
If you specify a file name only, AID assigns the library for the base qualification which is currently applicable (see %BASE command) and opens it. All libraries previously assigned for the current base qualification will be closed.
If you specify a base qualification only, all open libraries for this qualification will be closed.
AID can handle up to 15 library assignments. A library which is concurrently assigned for several base qualifications is counted as often as it is specified.
qualification-a-lib-OPERAND - - - - - - - - - - - - - - - - - - - - - - - -
[•][E={VM|Dn}•][filename]
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
•
If the period is in the leading position it denotes a prequalification, which must have been defined with a preceding %QUALIFY command and can only stand for a base qualification.
E=VM
%SYMLIB applies for the loaded program (see also %BASE command).
E=Dn
%SYMLIB applies for a memory dump in a dump file with the link name Dn (see %BASE and %DUMPFILE commands).
filename
is the BS2000 catalog name of a PLAM library which is assigned for the base qualification specified with prequalification or entered explicitly. If the qualification is omitted, the library is assigned for the base qualification which currently applies.
Example
%SYMLIB E=D5.PLAMLIB,COBOLOUTPUT
If AID requires LSD records for processing a memory dump in the dump file with the link name D5, AID attempts to load these records from the PLAMLIB library.
The COBOLOUTPUT library is assigned for the currently set base qualification. If no %BASE command has been issued, AID uses this library to dynamically load LSD records for the program being executed.
%TRACE 5 R %INSTR
5 program commands are executed and logged. After this, the program continues without logging.
%C1 %CALL IN S=TESTPROG <%TRACE 1 R>
All subroutine calls by the TESTPROG module are logged. The program continues after each respective CALL instruction is executed and logged.