TEST keyword

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.