Use this command to:
- Specify areas of main storage to be included in or omitted from the dump
for a particular system error
- Define a new storage area that is normally omitted from system storage
dumps and associate a keyword with the storage area
- Bypass the processing of a particular system error or force a dump of the
entire system virtual memory (SVM)
- Display the current storage or overrides for a system error
- Display the errors being suppressed or overridden.
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
- Online help information is available for this command. To display
the help information, enter one of the following:
ZIDOT HELP
ZIDOT ?
- An entry in the dump override table associates a system error with a list
of one or more storage areas to be included in the dump for the system
error. The storage areas are identified by user-defined
keywords.
- The facility for including or omitting storage areas from individual dumps
is intended for use as a temporary bypass. Permanent dump overrides
should be installed in the TPF system by coding one or more IDOTB macro calls
in CUDP copy member of the CCUEXT user exit (CIDP in CCCPSE for IBM
overrides).
- Entries created using this command are processor- and image-unique.
Performing an IPL with a different image will cause entries created on the
current image to be ignored. See the IDOTB macro description in TPF System Macros for more information.
- Dump overrides have no effect on OPR dumps unless you set the LONG option
for the ZASER command, or unless a particular SERRC macro has the SYSDUMP=YES
parameter coded. Conversely, system storage is always included in CTL
dumps except when SYSDUMP=NO is coded for the SERRC macro.
- Overrides for full manual dumps (OPR-I030000) are ignored by system error
processing. Overrides for specially defined system errors that never
produce a dump (for example, ZRIPL) are also ignored.
- If a static override was defined for the system error using the IDOTB
macro, this command uses this override as a starting point. Storage
areas included using the IDOTB macro can be selectively omitted using this
command. Overrides created using this command take priority over those
created using the IDOTB macro.
- Some storage areas may have been designated for inclusion in every dump
when they were defined (REQUIRED=YES parameter on the IDATG macro).
These areas are included by default whenever a dump override is
created. The inclusion of these default areas cannot be overridden
using this command.
- You can create overlapping overrides using this command or other overrides
in the TPF system. When overlapping overrides are created using this
command, overlapping areas will only be dumped once.
- If a specified storage area has been defined as MDBF subsystem-unique or
I-stream unique, all copies of the data structure are included in the
dump. However, if a static override exists and the storage area is
included in the static override, all copies are included only if COPIES=ALL
was coded for the IDOTB macro that was used to define the static
override.
- Selective memory dump table (SMDT) entries generated by IDATG
KEYWORD=DUMMY macro calls are used to store the information for created
keywords. The number of created keywords that are allowed is determined
by the number of DUMMY entries allocated using IDATG.
- The ZIDOT command uses bit maps to identify storage areas to be included
or omitted. These bit maps depend on the arrangement of the IDATG macro
calls that are used to define the dump keywords (see the IDATG macro
description in TPF System Macros). If the
number or ordering of the defined keywords changes, the ZIDOT bit maps will no
longer be valid.
- As a precaution, restart program CVRN compares the number of defined
keywords with the number defined before the last IPL of the TPF system.
If the number of keywords has changed, all ZIDOT overrides are deleted and the
ZIDOT records on file are reinitialized.
- Changing the order of the keywords after the ZIDOT function is used is not
recommended. However, if it cannot be avoided, the ZAREC command can be
used to clear the record ID from the dump override table file records (see the
SYSEQ macro). This will clear and reinitialize the records during the
next IPL of the TPF system.
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