The ADD-LIST-OBJECTS statement specifies the scope of list output. All instances of this statement which occur between START-LIST-GENERATION and PRINT-LIST are collected and taken into account when the PRINT-LIST statement is issued. Similarly, all instances of the REMOVE-LIST-OBJECTS statement are registered and taken into account.
Due to the complexity of the statement, it is advisable to use multiple ADD-LIST-OBJECTS statements when many different objects are to be selected.
Format
ADD-LIST-OBJECTS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
GLOBAL-INFORMATION = *NONE / *INF / *STD / *OVERVIEW / *ALL-MEMORY-AREAS / *PARAMETERS(...)
This operand is used to select global (as opposed to task-specific) areas for list output.
GLOBAL-INFORMATION = *NONE
The list output is not to include any global memory areas.
GLOBAL-INFORMATION = *INF
The list output should contain general information relating to the object to be analyzed.
GLOBAL-INFORMATION = *STD
A minimal scope list is output. This list will generally contain all the data required for preliminary diagnosis (see section "Components and scope of the output lists" "Components and scope of the output lists").
GLOBAL-INFORMATION = *OVERVIEW
A system overview is output (see section "Components and scope of the output lists" for the contents of this overview).
GLOBAL-INFORMATION = *ALL-MEMORY-AREAS
A complete list is output (see the section "Components and scope of the output lists" for the contents of this list). In particular, all the pages saved by CDUMP are output to the list in the case of system, user and area dumps.
GLOBAL-INFORMATION = *PARAMETERS(...)
This operand allows global areas to be selected individually.
TRACES = *NONE / *ALL / list-poss(2): *SYSTEM-TRACE-TABLE /*TRACE-MANAGER-TABLES
This operand specifies the system traces to be output.
TRACES = *NONE
No system traces are to be output. This is the default value.
TRACES = *ALL
All the system traces are to be output.
TRACES = list-poss(2): *SYSTEM-TRACE-TABLE / *TRACE-MANAGER-TABLES
The system trace table and an overview of the traces managed by the trace manager can be selected individually or in the form of a list.
MAPS = *NONE / *ALL / list-poss(2): *CSECT-MAPS / *CONCISE-REP-INFORMATION
This parameter specifies the information to be output on loaded CSECTs and on the correction status of the system.
MAPS = *NONE
No maps are to be output.
MAPS = *ALL
Both CSECT maps and the REPLOG are to be output if they exist in the diagnosis object.
MAPS = list-poss(2): *CSECT-MAPS / *CONCISE-REP-INFORMATION
The CSECT maps and the REPLOG can be selected individually or in the form of a list.
CONTROL-BLOCKS = *NONE / *ALL / list-poss(2): *XVT / *AUDIT-TABLES
This operand specifies which tables are to be output.
CONTROL-BLOCKS = *NONE
No tables are to be output.
CONTROL-BLOCKS = *ALL
The XVT and AUDIT tables are to be output.
CONTROL-BLOCKS = list-poss(2): *XVT / *AUDIT-TABLES
The global system table XVT and the AUDIT tables can be selected individually or in the form of a list.
If the XVT is selected, it is output in unedited form. In the case of the AUDIT tables, any processor-local linkage AUDIT tables are to be output.
MEMORY-AREAS = *NONE / *ALL / list-poss(9): *CL1 / ... / *CL4-NON-PRIVILEGED
This parameter specifies certain global areas of the virtual address space which are identified by their memory class and which are to be output in their entirety in standard dump format. The default value specifies that none of these areas are to be output. The operand *ALL combines all the memory areas listed.
CL1: | resident system modules |
PAGES = *NONE / <x-string 1..8>(...) / *INTERVAL(...)
Direct selection of memory pages or memory areas in the address space. The default setting does not specify any particular pages for output.
PAGES = <x-string 1..8>(...)
Direct selection of a memory page.
SPACE = *VIRTUAL-MEMORY / *REAL-MEMORY / *ABSOLUTE_MEMORY/*PAM-PAGES/*HARDWARE-SYSTEM-AREA / *PROCESSOR-SAVED-STATUS(...) / *ALET(...) / *SPID(...)
This operand specifies the memory type referred to by the page specification.
SPACE = *VIRTUAL-MEMORY
If no specification is made, VIRTUAL-MEMORY is assumed, i.e. virtual memory is used by default.
SPACE = *REAL-MEMORY(...)
This operand indicates that the main memory is to be used (real address space).
SEGMENT = x'0' / <x-string 1..8>
Indicates the 4 GB segment (0,1,...) associated with the real page. Segment 0 is the default.
SPACE = *ABSOLUTE-MEMORY(...)
This operand indicates the host-absolute addresses (e.g. in the case of a complete VM2000 SLED file).
SEGMENT = x'0' / <x-string 1..8>
Indicates the 4 GB segment (0,1,...) associated with the absolute page. Segment 0 is the default.
SPACE = *PAM-PAGES
The page specification refers to PAM pages.
SPACE = *HARDWARE-SYSTEM-AREA
This operand indicates that the hardware system area HSA is to be used (this area contains, for instance, tables used for communication between the CPU and the I/O processor). The specified page must lie within the HSA.
SPACE = *PROCESSOR-SAVED-STATUS(...)
The page specification refers to a processor saved status area.
CPU-NUMBER = <integer 0..31>
If page 0 of the processor saved status area is to be output, the CPU number must be specified in decimal format.
CPU-NUMBER = <x-string 1..2>
If page 0 of the processor saved status area is to be output, the CPU number must be specified in hexadecimal format.
SPACE = *ALET(...)
This operand indicates that pages from data spaces are to be used (data spaces are extensions of the system’s virtual address space). The ALET (access list entry token) is used to identify the data space for the system address space.
IDENTIFIER = <x-string 1..8>
The 4-byte ALET is specified in hexadecimal format.
SPACE = *SPID(...)
This operand indicates that pages from data spaces are to be used (data spaces are extensions of the system’s virtual address space). The SPID (space identification) is used to identify the data space throughout the system.
IDENTIFIER = <x-string 1..16>
The 8-byte SPID is specified in hexadecimal format.
PAGES = *INTERVAL(...)
This parameter allows a number of memory pages to be specified by means of an interval.
FROM = <x-string 1..8>
This operand indicates the first memory page of the memory area.
TO = <x-string 1..8>
This operand indicates the last memory page of the memory area.
SPACE = *VIRTUAL-MEMORY / *REAL-MEMORY(...) / *ABSOLUTE-MEMORY(...) / *PAM-PAGES / *HARDWARE-SYSTEM-AREA / *PROCESSOR-SAVED-STATUS(...) / *ALET(...) / *SPID(...)
This operand specifies the type of memory to which the page specification refers.
SPACE = *VIRTUAL-MEMORY
If no specification is made, VIRTUAL-MEMORY is assumed, i.e. virtual memory is used by default.
SPACE = *REAL-MEMORY(...)
This operand indicates that the main memory is to be used (real address space).
SEGMENT = x'0' / <x-string 1..8>
Indicates the 4 GB segment (0,1,...) associated with the real page.
Segment 0 is the default.
SPACE = *ABSOLUTE-MEMORY(...)
This operand indicates the host-absolute addresses (e.g. in the case of a complete VM2000 SLED file).
SEGMENT = x'0' / <x-string 1..8>
Indicates the 4 GB segment (0,1,...) associated with the absolute page.Segment 0 is the default.
SPACE = *PAM-PAGES
The page specification refers to PAM pages.
SPACE = *HARDWARE-SYSTEM-AREA
This operand indicates that the hardware system area HSA is to be used. The specified pages must lie within the HSA.
SPACE = *PROCESSOR-SAVED-STATUS(...)
The page specification refers to a processor saved status area.
CPU-NUMBER = <integer 0..31>
If page 0 of the processor saved status area is to be output, the CPU number must be specified in decimal format.
CPU-NUMBER = <x-string 1..2>
If page 0 of the processor saved status area is to be output, the CPU number must be specified in hexadecimal format.
SPACE = *ALET(...)
This operand indicates that pages from data spaces are to be used (data spaces are extensions of the system’s virtual address space). The ALET (access list entry token) is used to identify the data space for the system address space.
IDENTIFIER = <x-string 1..8>
The 4-byte ALET is specified in hexadecimal format.
SPACE = *SPID(...)
This operand indicates that pages from data spaces are to be used (data spaces are extensions of the system’s virtual address space). The SPID (space identification) is used to identify the data space throughout the system.
IDENTIFIER = <x-string 1..16>
The 8-byte SPID is specified in hexadecimal format.
MODULE = *NONE / <name 1..32>
This operand specifies the entire memory area occupied by the specified system module. The default setting specifies that this area is not output.
TASK-INFORMATION = *NONE / *PARAMETERS(...)
This operand is used to select task-specific areas.
TASK-INFORMATION = *NONE
The list output is to contain no task-specific memory areas.
TASK-INFORMATION = *PARAMETERS(...)
Selection of specified task-specific memory areas.
SELECT = *ERROR-TASK / *ALL-TASKS / <x-string 1..8> / <alphanum-name 1..4> / <c-string 1..4>
Selection of the task for which memory areas are to be output.
SELECT = *ERROR-TASK
Selection of the error task. For system, user and area dumps, this is the only task contained in the dump file. With SLEDs, the error task is defined by the automatic preanalysis within DAMP.
SELECT = *ALL-TASKS
In the case of a SLED, task editing is carried out for all active tasks.
SELECT = <x-string 1..8>
The required task is specified by the 4-byte TID in hexadecimal format.
SELECT = <alphanum-name 1..4>
The required task is identified by an alphanumeric name which is interpreted as the task’s TSN.
SELECT = <c-string 1..4>
The required task is identified by a character string which is interpreted as the task’s TSN.
INFORMATION = *STD / *INF / *OVERVIEW / *ALL-MEMORY-AREAS /*PARAMETERS(...)
This operand controls the scope of output for task-specific data.
INFORMATION = *STD
A minimal scope list is output. This list will generally contain all the data required for preliminary diagnosis (see section "Components and scope of the output lists" "Components and scope of the output lists").
INFORMATION = *INF
The output list contains general information on the selected task.
INFORMATION = *OVERVIEW
A system overview is output (see section "Components and scope of the output lists" for the contents of this overview).
INFORMATION = *ALL-MEMORY-AREAS
A complete list is output (see section "Components and scope of the output lists" for the contents of this list). In particular, all the pages saved by CDUMP are output to the list in the case of system, user and area dumps.
INFORMATION = *PARAMETERS(...)
This operand allows task-specific areas to be selected individually.
TRACES = *NONE / *SYSTEM-TRACE-TABLE
This operand defines whether task-specific information is to be output from the system trace table. Default: no output.
MAPS = *NONE / *USER-CSECTS
This operand controls the output of information on the loaded user CSECTs.Information on user CSECTs can only be output for user and area dumps if the binder/loader information in class 5 memory is contained in the object. Default: no output.
CONTROL-BLOCKS = *NONE / *ALL / list-poss(5): *TCB / ... / *AUDIT-TABLES
This operand specifies whether the task-specific control blocks are to be output in standard dump format.
CONTROL-BLOCKS = *NONE
The task-specific control blocks are not output. This is the default setting.
CONTROL-BLOCKS = *ALL
All task-specific control blocks are to be output.
CONTROL-BLOCKS = list-poss(5): *TCB / *PCBS / *SPL-STACKS / *TFTS /*AUDIT-TABLES
This operand allows explicit selection of task-specific control blocks. The blocks can be selected individually or in the form of a list. TCB (task control block), PCBS (process control blocks), SPL-STACKS, (TPR program manager stacks), TFTS (task file tables), and AUDIT-TABLES (hardware AUDIT and linkage AUDIT).
If PCBS is specified, the PCBs are additionally output in edited format.
MEMORY-AREAS = *NONE / *ALL / list-poss(7): *CL5 / ... /*CL6-MEMORY-POOLS
This parameter specifies certain areas of the virtual task address space which are identified by their memory class and which are to be output in their entirety in standard dump format.
MEMORY-AREAS = *NONE
No special areas of the virtual task address space are selected.
MEMORY-AREAS = *ALL
All memory areas of class 5 and class 6 memory are to be output in standard dump format.
MEMORY-AREAS = list-poss(7): *CL5 / *CL5-PARTIAL-PAGES /*CL5-FULL-PAGES / *CL5-MEMORY-POOLS / *CL6 / *CL6-FULL-PAGES / *CL6-MEMORY-POOLS
The class 5 and class 6 memory segments can be selected individually or in the form of a list.
CL5: | complete class 5 memory |
PAGES = *NONE / <x-string 1..8>(...) / *INTERVAL(...)
Direct selection of memory pages to be output.
PAGES = *NONE
If no specification is made, *NONE is assumed, i.e. no specific memory pages are output.
PAGES = <x-string 1..8>(...)
This operand directly selects one specific memory page via a hexadecimal page specification.
SPACE = *VIRTUAL-MEMORY / *ALET(...)
This operand specifies the memory type referred to by the page specification.
SPACE = *VIRTUAL-MEMORY
If no specification is made, VIRTUAL-MEMORY is assumed, i.e. virtual memory is used by default.
SPACE = *ALET(...)
This operand indicates that pages from data spaces are to be used (data spaces are extensions of the system’s virtual address space). The ALET (access list entry token) is used to identify the data space for the task address space.
IDENTIFIER = <x-string 1..8>
The 4-byte ALET is specified in hexadecimal format.
PAGES = *INTERVAL(...)
This parameter allows a number of memory pages to be specified by means of an interval.
FROM = <x-string 1..8>
This operand indicates the first memory page of the memory area.
TO = <x-string 1..8>
This operand indicates the last memory page of the memory area.
SPACE = *VIRTUAL-MEMORY / *ALET(...)
This operand specifies the memory type referred to by the page specification.
SPACE = *VIRTUAL-MEMORY
If no specification is made, VIRTUAL-MEMORY is assumed, i.e. virtual memory is used by default.
SPACE = *ALET(...)
This operand indicates that pages from data spaces are to be used (data spaces are extensions of the system’s virtual address space). The ALET (access list entry token) is used to identify the data space for the task address space.
IDENTIFIER = <x-string 1..8>
The 4-byte ALET is specified in hexadecimal format.
MODULE = *NONE / <name 1..32>
This operand specifies the name of a module from the loaded user program, which is to be output in its entirety in standard dump format. If no specification is made, *NONE is assumed, i.e. no module is assigned.
USER-LIST-PROCEDURE = *NONE / <name 1..32 with under> / <structured-name 1 .. 32>
This operand specifies the name of a PRODAMP program located in the currently set user PRODAMP object library. This program is started automatically once output of this list has been completed.
WINDOW = *NONE / <integer 4..99>
The specified window is output to a list using the current layout. Windows 4 - 9 and 21 - 99 are supported; windows 10 - 20 are 'reserved'. Only windows using standard format (dump format, hexadecimal format, character format, assembled or symbolic) can be output.
DUMP-DIAGNOSIS = *NONE / *PREANALYSIS(...)
This operand indicates whether automatic preanalysis of the diagnostic data is to be performed.
It is equivalent to entering DIAG=YES/NO in the LIST window, i.e. the preanalysis procedure DIAG is either started or is not started.
The results of analysis regarding diagnosis-relevant memory pages, error causes, error environment and error localization influences the scope of the subsequent lists.
DUMP-DIAGNOSIS = *NONE
No preanalysis is to be performed.
DUMP-DIAGNOSIS = *PREANALYSIS(...)
The preanalysis procedure DIAG is to be started. DIAG is a PRODAMP procedure from the system PRODAMP library.
The automatic preanalysis of user and area dumps is currently not supported.
ERROR-DESCRIPTION = *NO / *YES
Indicates whether the error descriptors are to be output in the format of the retrieval system SIS at the beginning of the output list for the system overview. These descriptors can then be used to search for duplicates with SIS.
ERROR-DESCRIPTION = *NO
No error descriptors are to be output. However, the memory pages referenced during preanalysis and relevant to diagnosis are automatically included in output for any subsequent minimum evaluation.
ERROR-DESCRIPTION = *YES
Error descriptors are to be output.
This is equivalent to entering DESCR=YES in the LIST window, i.e. the preanalysis procedure DESCR is started. DESCR is a PRODAMP procedure from the system PRODAMP library.
Example
START-LIST-GENERATION
ADD-LIST GLOBAL-INFORMATION=*PAR(CONTROL-BLOCKS=*XVT)—————————————————— (1)
ADD-LIST GLOBAL-INFORMATION=*PAR(MEMORY-AREAS=(*CL1,*CL3))————————————— (2)
ADD-LIST TASK-INFORMATION=*PAR(X'00040333,
INFO=(CONTROL-BLOCKS=*TCB,PAGES=X'14'(*ALET=X'05'))))————————— (3)
ADD-LIST TASK-INFORMATION=*PAR(3UVW,INFO=*PAR(MEM=*CL6))——————————————— (4)
PRINT-LIST
(1)/(2) | Output of global system information: XVT, class 1 and class 3 memory. |
| (3) | The TCB and page 14 from the data space with ALET X'00000005' is to be output for the task with TID X'00040333'. |
(4) | Class 6 memory is to be output for the task with TSN 3UVW. |
See the PRINT-LIST statement on "PRINT-LIST Start list output".