Customizing contents through operator commands

The dump options list for SVC dumps can be customized through a DUMP operator command by all the ways shown in Table 1.

Note: The contents of SVC dumps requested by SLIP operator commands are controlled only by the SLIP operator command. They are not affected by the IEACMD00 parmlib member or the CHNGDUMP command.

Nucleus areas in dumps: Dump options control the parts of the nucleus that appear in a dump. A diagnostician seldom needs to analyze all the nucleus. An installation can eliminate nucleus areas from dumps. If the IBM-supplied defaults are used:

SVC dump for a SLIP operator command with ACTION=SVCD contains the read/write DAT-on nucleus
SVC dump for an SDUMP or SDUMPX macro contains the nucleus map and certain control blocks

If no nucleus changes have been made, an installation should obtain one copy of the DAT-off nucleus to use with all dumps. To obtain this nucleus, enter a DUMP operator command with SDATA=ALLNUC and no other SDATA options. The nucleus does not change from one IPL to another, so one dump can be used again and again.

DAT, dynamic address translation, is the hardware feature that enables virtual storage. In the DAT-on part of the nucleus, the addresses are in virtual storage; in the DAT-off part of the nucleus, the addresses are in central storage.

Table 1. Customizing SVC dump contents through operator commands
Customization	Effect	Example
Use SDATA=NODEFAULTS on SDUMP or SDUMPX macro	Change occurs: At dump request What changes: Excludes the following SDATA default options currently in effect: ALLPSA SQA SUMDUMP IO From all CHNGDUMP operator commands entered through the IEACMD00 parmlib member or through the console Exclusion is only for the dump being requested. Note that certain default system areas are not excluded; these areas are required for IPCS dump analysis. The CHNGDUMP operator command can override the NODEFAULTS option.	To minimize the amount of default data in the dump, code in the program: `SDUMPX SDATA=NODEFAULTS`
Replacing CHNGDUMP operator command in IEACMD00 parmlib member	Change occurs: At system initialization What changes: This command establishes the IBM-supplied dump options for SVC dumps for SDUMP or SDUMPX macros and DUMP operator commands; see Contents of SVC dumps for the list.	To add the link pack area (LPA) to all SVC dumps for SDUMP or SDUMPX macros and DUMP operator commands, while keeping the local system queue area (LSQA) and trace data, add the following command to IEACMD00: `CHNGDUMP SET,SDUMP=(LPA)`
Entering CHNGDUMP operator command with SDUMP parameter on a console with master authority	Change occurs: Immediately when command is processed What changes: For the ADD mode: CHNGDUMP options are added to the current SVC dump options list and to any options specified in the macro or operator command that requested the dump. The options are added to all SVC dumps for SDUMP or SDUMPX macros and DUMP operator commands until another CHNGDUMP SDUMPX operator command is entered. For the OVER mode: CHNGDUMP options are added to the current SVC dump options list. The system ignores any options specified in the macro or operator command that requested the dump. The options override all SVC dumps for SDUMP or SDUMPX macros and DUMP operator commands until a CHNGDUMP SDUMP,ADD operator command is entered. For the DEL option: CHNGDUMP options are deleted from the SVC dump options list. When more than one CHNGDUMP operator command with SDUMPX is entered, the effect is cumulative.	To add the LPA to all SVC dumps for SDUMP or SDUMPX macros and DUMP operator commands until changed by another CHNGDUMP SDUMP, enter: `CHNGDUMP SET,SDUMP=(LPA)` To add the CHNGDUMP SDUMPX options list to all SVC dumps: `CHNGDUMP SET,SDUMP,ADD` To override all SVC dumps with the CHNGDUMP SDUMPX options list: `CHNGDUMP SET,SDUMP,OVER` To remove LPA from the SDUMPX options list: `CHNGDUMP DEL,SDUMP=(LPA)`
Using an operator command parameter. Parameters on the DUMP operator command specify the contents for the dump being requested.	Change occurs: At dump request What changes: The DUMP operator command parameter options are added to the dump options list, but only for the dump being requested.	To add ALLNUC to this SVC dump, enter: `DUMP COMM=(MYDUMP1 5-9-88)` The system issues a message: `* 23 IEE094D SPECIFY OPERAND(S) FOR DUMP COMMAND` Enter in reply: `REPLY 23,JOBNAME=MYJOB1, SDATA=(ALLNUC),END`