Controlling list output in batch or procedure mode

There are three stages involved in controlling the scope of a list:

1. start list generation with the START-LIST-GENERATION statement

2. select memory areas with the ADD-LIST-OBJECTS and REMOVE-LIST-OBJECTS statements

3. start list output using the PRINT-LIST statement

Any number of ADD-LIST-OBJECTS and REMOVE-LIST-OBJECTS statements can be inserted in any sequence between the START-LIST-GENERATION and PRINT-LIST statements. The selected areas are added together and take effect only when the final PRINT-LIST statement is issued.

The START-LIST-GENERATION statement contains all the specifications regarding the input medium, in other words the names of the dump files to be evaluated. The PRINT-LIST statement defines the output medium (SYSLST or file).
Please refer to the relevant statement descriptions for details.

Every list generated by DAMP includes at the end of the report a list of the objects selected in the form of ADD-LIST-OBJECTS statements. Thus, for instance, the required options can be set interactively by marking them and then the corresponding statements can be taken from the generated list.

Examples of statement sequences

The following examples are intended to illustrate the possible structure of a statement sequence in batch or procedure mode in DAMP.
The statement sequences, which start with START-LIST-GENERATION and end with PRINT-LIST, could, of course, be stored in a file, which is then assigned at execution time using the DAMP statement START-STATEMENT-SEQUENCE.

Example 1

/BEGIN-PROCEDURE
/ASSIGN-SYSDTA TO-FILE=*SYSCMD
/MODIFY-JOB-SWITCHES ON=5
/START-DAMP
START-LIST-GENERATION FILES-TO-EVALUATE=DUMP.HUGO —————————————————————  (1) 
ADD-LIST-OBJECTS TASK-INFORMATION=*PARAMETERS(SELECT=C'RP01', -
                 INFORMATION=*PARAMETERS(CONTROL-BLOCKS=*TCB, -
                 PAGES=*INTERVAL(FROM=X'0',TO=X'FFF'))) ———————————————  (2) 
ADD-LIST-OBJECTS GLOBAL-INFORMATION=*PARAMETERS(CONTROL-BLOCKS=*XVT, -
                    MODULE=DOPEN) —————————————————————————————————————  (3) 
PRINT-LIST OUTPUT=#REPORT —————————————————————————————————————————————  (4) 
END
/MODIFY-JOB-SWITCHES OFF=5
/END-PROCEDURE

(1) (2) (3) (4)

The dump file to be analyzed is specified with START-LIST-GENERATION. The TCB and pages 0 to FFF are to be output for the task SRPM. The global XVT objects and the module DOPEN are to be output. Output is sent to the temporary file #REPORT.

Example 2

/BEGIN-PROCEDURE
/ASSIGN-SYSDTA TO-FILE=*SYSCMD
/ADD-FILE-LINK FILE=SYSDUMP.FROM.YESTERDAY, LINK=#1 ———————————————————  (1) 
/MODIFY-JOB-SWITCHES ON=5
/START-DAMP 
OPEN-DIAGNOSIS-OBJECT OBJECT=*#1 ——————————————————————————————————————  (2) 
START-LIST-GENERATION —————————————————————————————————————————————————  (3) 
PRINT-LIST ————————————————————————————————————————————————————————————  (4) 
END
/MODIFY-JOB-SWITCHES OFF=5
/END-PROCEDURE

(1)	/ADD-FILE-LINK assigns the dump file to be evaluated.
(2)	The OPEN-DIAGNOSIS-OBJECT statement opens the dump file for processing by DAMP.
(3)	List output is started. A FILE-TO-EVALUATE assignment (as seen in example 1) can be omitted, since the file opened and the file to be output are one and the same.
(4)	Output is directed to SYSLST.

DAMP selects the areas to be output (minimum output).