The REMOVE-LIST-OBJECTS statement allows users to exclude from output areas previously assigned by means of the ADD-LIST-OBJECTS command.
The options available for canceling selected objects are, however, of a relatively general nature. If only specific areas are to be excluded from output for a given task, the entire task must first be canceled using the REMOVE-LIST-OBJECTS statement. The areas to be output must then be assigned by way of the ADD-LIST-OBJECTS statement. The areas not required for output are not assigned during this process.
Format
REMOVE-LIST-OBJECTS |
GLOBAL-INFORMATION = *NONE / *ALL / *TRACES / *MAPS / *CONTROL-BLOCKS / *MEMORY-AREAS / *PAGES / *MODULE ,TASK-INFORMATION = *NONE / *ALL / <x-string 1..8> / <alphanum-name 1..4> / <c-string 1..4> ,USER-LIST-PROCEDURE = *NONE / *ALL / <name 1..32 with-under> / <structured-name 1..32> ,WINDOW = *NONE / *ALL / <integer 4..99> ,DUMP-DIAGNOSIS = *NONE / *ALL |
Operands
GLOBAL-INFORMATION = *NONE / *ALL / *TRACES / *MAPS / *CONTROL-BLOCKS / *MEMORY-AREAS / *PAGES / *MODULE
Output of global information can be suppressed entirely or for specific areas.
GLOBAL-INFORMATION = *NONE
If no selection is made, the areas declared by way of ADD-LIST-OBJECTS are output.
GLOBAL-INFORMATION = *ALL
This specification excludes not only the areas declared by means of ADD-LIST-OBJECTS, but also the default areas (see brief report).
GLOBAL-INFORMATION = *TRACES
The global traces declared by means of ADD-LIST-OBJECTS are not output.
GLOBAL-INFORMATION = *MAPS
Information on the loaded CSECTs and the correction status of the system selected by the ADD-LIST-OBJECTS statement is not output.
GLOBAL-INFORMATION = *CONTROL-BLOCKS
All control blocks selected for output by the ADD-LIST-OBJECTS statement are not output.
GLOBAL-INFORMATION = *MEMORY-AREAS
The areas of the virtual address space selected for output by the ADD-LIST-OBJECTS statement are not output.
GLOBAL-INFORMATION = *PAGES
Pages or areas of the address space (virtual, main memory, HSA, ...) selected for output by the ADD-LIST-OBJECTS statement are not output.
GLOBAL-INFORMATION = *MODULE
The memory area of the specified module selected for output by the ADD-LIST-OBJECTS statement is not output.
TASK-INFORMATION = *NONE / *ALL / <x-string 1..8 > /<alphanum-name 1..4> / <c-string 1..4>
Output of task-specific information can be suppressed entirely or for individual tasks.
TASK-INFORMATION = *NONE
If no selection is made, the information declared in ADD-LIST-OBJECTS for the specified tasks is output.
TASK-INFORMATION = *ALL
This specification excludes not only the information declared in ADD-LIST-OBJECTS for the tasks specified there, but also the information for the default tasks.
TASK-INFORMATION = <x-string 1..8 >
The specified hexadecimal value is interpreted as the TID of the task for which information is not to be output.
TASK-INFORMATION = <alphanum-name 1..4>
The specified alphanumeric name is interpreted as the TSN of the task for which information is not to be output.
TASK-INFORMATION = <c-string 1..4 >
The specified character string is interpreted as the TSN of the task for which information is not to be output.
USER-LIST-PROCEDURE = *NONE / *ALL / <name 1..32 with-under> <structured-name 1..32>
This operand specifies the name of a PRODAMP program located in the current PRODAMP object library. This program is to be started automatically when list output is complete.
USER-LIST-PROCEDURE = *NONE
If no specification is made, the user programs declared by means of ADD-LIST-OBJECTS are started automatically after the list has been output.
USER-LIST-PROCEDURE = *ALL
None of the user programs declared with ADD-LIST-OBJECTS are started when list output is complete.
USER-LIST-PROCEDURE = <name 1..32 with-under> / <structured-name 1..32>
The specified user program is not started when list output is completed.
WINDOW = *NONE / *ALL / <integer 4..99>
This specifies a window whose layout was selected for output to a list using the ADD-LIST-OBJECTS statement.
The user can exclude all windows or specify individual windows for exclusion.
WINDOW = *NONE
All the windows declared by means of ADD-LIST-OBJECTS are output.
WINDOW = *ALL
None of the windows declared by means of ADD-LIST-OBJECTS is output.
WINDOW = <integer 4..99>
The specified window is not output. Windows 4 - 9 and 21 - 99 are supported; windows 10 - 20 are 'reserved'.
DUMP-DIAGNOSIS = *NONE / *ALL
Invocation of automatic preanalysis can be deactivated (*ALL).
The information set in the status window (W2) in INF mode can be output.
Example
REMOVE-LIST-OBJECTS TASK-INFORMATION=X'0004000E',WINDOW=*ALL
Once the PRINT-LIST statement has been issued, the selection of the areas to be output is reset to the default. However, the scope of the standard output list can be restricted even further by means of the REMOVE-LIST-OBJECTS statement (see the description of the GLOBAL-INFORMATION and TASK-INFORMATION operands).