gtpo1m76Operations

ZIDOT-Display or Modify Dump Override Table

Use this command to:

Requirements and Restrictions

None.

Format




Include
includes the specified areas of main storage in the dump for the specified system error.

If you specify a keyword that was created using this command, the storage area associated with the keyword is printed in both hexadecimal and EBCDIC format in the dump.

Omit
omits the specified areas of main storage from the dump for the specified system error.

prefix.error
is the prefix and 6-digit system error number as it displays in Messages (System Error and Offline) and Messages (Online). Leading zeros can be omitted.
Note:
Specify an asterisk (*) for the prefix if no prefix is associated with error number. This condition occurs when the dump is issued from the perror or exit C function.

ALL
overrides the list of storage areas included in all dumps. Overrides entered with this parameter take precedence over any conflicting overrides entered for a specific system error number.

MD
overrides the list of storage areas included in a selective manual dump.

PGM-progname
is the name of an ECB-controlled program. The override takes effect only if the system error occurred in the specified program.

keyword
is one or more keywords that identify a particular storage area. The keywords are defined in the IDATB macro. For more information about the IDATB macro, see TPF System Macros.

You can use the ZIDOT DISPLAY command to display a list of valid keywords.

CReate
creates a new keyword and associates a storage range and printable description with it.
Note:
The storage associated with the keyword is not included in dumps until you enter the ZIDOT command and specify the INCLUDE parameter.

newkeyword
is a new keyword that does not exceed 36 alphanumeric characters.

START-address END-address
are starting and ending addresses for a range of storage. The addresses must be a valid range in the system virtual memory (SVM) of the main I-stream. Addresses from X'00'-X'FFF' are not accepted.

TEXT=$descriptor$
is a description for the new keyword. You can substitute a single quotation (') for the dollar sign ($).

DELete keyword
deletes a keyword you created using this command.

DELete ALL
deletes all the keywords that you created using this command.

Display
displays a list of all valid keywords, including those created using this command.

The addresses of the storage associated with each keyword are also displayed. If a keyword is subsystem-unique, the address for the basic subsystem (BSS) is displayed. If the keyword is I-stream unique, the address for the main I-stream is displayed.

Display SUppress
displays a list of all the system errors that were suppressed.

Display Storage
displays the list of storage areas that are included in the dump when the specified system error occurs.
Note:
If you specify the PGM parameter, the storage that is displayed is the storage for the program without any specific version code.

Display Overrides
displays the storage areas that were included or omitted from the specified dump using this command.

Display List prefix.error
displays a list of all system error number and program name combinations for the specified system error for which overrides exist.

Display List ALL
displays a list of system error numbers and program name combinations for which overrides exist.

Display Create
displays a list of all the keywords that were created using the ZIDOT command.

CLear
clears the dump override table entry for the specified system error. Any overrides created using this command are removed.

CLear ALL keyword
cancels an INCLUDE ALL or OMIT ALL request. The specified storage is no longer included in or omitted from all dumps.

SUPPress
suppresses the dump for the specified system error.

STORAGE
forces a dump of the entire system virtual memory (SVM) for the specified system error. This takes place for only one dump.
Note:
In a production environment, a full dump could cause the TPF system to be masked for several minutes and cause a large spike in system activity when the dump ends.

Reset
resets the SUPPRESS or STORAGE parameter for the specified system error. If a list of keywords was previously in effect, the list is restored. Otherwise the dump override table entry is cleared.

Additional Information

Examples

In the following example, the control program and the CLH control tables are included in system error I00000D.

+--------------------------------------------------------------------------------+
|User:   ZIDOT INCLUDE I.00000D ICP ICLH                                         |
|                                                                                |
|System: IDOT0002I 14.26.27 KEYWORD ICP INCLUDED FOR ERROR I00000D               |
|        IDOT0002I 14.26.27 KEYWORD ICLH INCLUDED FOR ERROR I00000D              |
|        IDOT0001I 14.26.27 COMPLETED                                            |
+--------------------------------------------------------------------------------+

In the following example, the ABCD keyword is created for the storage area beginning at address X'1F0000' and ending at address X'1F0FFF'. This storage area is included in all dumps.

+--------------------------------------------------------------------------------+
|User:   ZIDOT CR ABCD START-1F0000 END-1F0FFF TEXT-$ALLOCATION TABLE SUBSET$    |
|                                                                                |
|System: IDOT0004I 14.26.27 KEYWORD ABCD CREATED START-001F0000 END-001F0FFF     |
+--------------------------------------------------------------------------------+

The following example displays a list of the storage areas that were included or omitted from the dump for the I00000D system error using this command.

+--------------------------------------------------------------------------------+
|User:   ZIDOT D OVERRIDES I.D                                                   |
|                                                                                |
|System: IDOT0013I 13.39.46 OVERRIDES VIA ZIDOT FOR ERROR I00000D                |
|        ICP      - CONTROL PROGRAM                       *INCLUDED*             |
|        ICLH     - CLH BLOCK MGMT TABLES                 *INCLUDED*             |
|        IDOT0011I 13.39.46 DISPLAY COMPLETE                                     |
+--------------------------------------------------------------------------------+

Related Information