You can enter the TEST keyword either in the PARM field of the
EXEC card that invokes the processor, or on a PARM command. By using
the PARM command, you can turn the TEST option on and off or change
the TEST option for different function commands.
The format of the PARM command follows.
PARM |
[TEST({[TRACE] |
|
[AREAS (areaid
[areaid...])] |
|
[FULL ((dumpid [ begin [ count
]]) [(dumpid...)....])]| |
|
OFF})] |
where:
- TEST({[TRACE] [AREAS (areaid[ areaid...])] [FULL ((dumpid[ begin [ count]])
[(dumpid...)...])]| OFF})
- Specifies the diagnostic aids to be used. After the TEST option
has been established, it remains in effect until it is reset by another
PARM command. The TRACE, AREAS, and FULL parameters may be used concurrently.
- TRACE
- Specifies that trace tables are to be listed whenever the built-in
dump points of the processor are encountered.
- AREAS(areaid [areaid...])
- Identifies modules that are to have selected variables dumped
at their dump points. areaid is a 2-character
area identifier defined within the implementation.
- FULL ((dumpid [ begin [ count]])
[(dumpid...)....])
- Specifies that a region dump, as well as the trace tables and
selected variables, is to be provided at the specified points. dumpid
specifies the 4-character identifier of the dump point.
- begin
- A decimal integer that specifies the number of times the program
is to go through the dump point before beginning the dump listing.
The default is 1.
- count
- A decimal integer that specifies the number of times through the
dump point that dumps are to be listed. The default is 1.
If the FULL keyword is used, an AMSDUMP DD statement
must be provided. For example:
//AMSDUMP DD SYSOUT=A
- OFF
- Specifies that testing is to stop.
Each time a PARM command is specified, the TEST parameters override
the TEST parameters in effect from the previous PARM command.
Figure 1 shows a portion
of the output from the command:
PARM TEST ( FULL (LCTP,2,1) )
and
a portion of the dump produced.
The trace tables and the selected area, DARGLIST, are printed each
time the dump point LCTP is encountered. A full region dump is produced
the second time that dump point LCTP is encountered.