INGPLEX SDUMP

Purpose

The INGPLEX SDUMP command lets you control the default dump options sysplexwide.

Example

The dump functions can be invoked directly by specifying the commands, or from the dump panel of the INGPLEX command selecting the appropriate command. In addition, you can invoke the dump submenu from the main panel of the INGPLEX command selecting command 7. The panel shown in Figure 1 is displayed.
Figure 1. INGPLEX Dump Options Panel
 INGLX250                  SA z/OS  - Command Dialogs          
 Domain Id . : IPSFP   ------------ INGPLEX -------------   Date . . : 01/26/18
 Operator Id : NETOP1          Sysplex = KEY1PLEX           Time . . : 10:03:49

 SAplex  . . . . . . : KEY4PLEX

 Select the desired command:                                    INGPLEX ...

   1 Control default SDUMP options                                SDUMP
   2 Issue SVC dumps                                              SVCDUMP
   3 Control SLIP trap settings                                   SLIP
     Create a SLIP trap                                           SLIPCR









  Command ===>
  F1=Help     F2=End      F3=Return                                 F6=Roll
                                                                   F12=Retrieve
If you select option 1, the panel shown in Figure 2 is displayed. Option 4 is only available for screen sizes with more than 42 rows.
Figure 2. INGPLEX SDUMP Panel
 INGLX251                  SA z/OS  - Command Dialogs       Line   1   of 12
 Domain Id . : IPSFP   --------- INGPLEX SDUMP ----------   Date . . : 01/26/18
 Operator Id : NETOP1          Sysplex = KEY1PLEX           Time . . : 10:23:48

 SAplex  . . . . . ==> KEY4PLEX          Permission . . . . : ALL
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 Cmds: C change

    System   Dump options
    -------- -------------------------------------------------------------------
 __ KEY1     Q=     Type=       Buffers=   0K  MaxSpace=    2000M  MsgTime=   60
                                    CSA      LPA LSQA NUC PSA RGN           SQA
                           TRT
 __ KEY2     Q=     Type=       Buffers=   0K  MaxSpace=    2000M  MsgTime=   60
                                    CSA      LPA LSQA NUC PSA RGN           SQA
                           TRT
 __ KEY3     Q=     Type=       Buffers=   0K  MaxSpace=    2000M  MsgTime=   60                                   CSA      LPA LSQA NUC PSA RGN           SQA
                                    CSA      LPA LSQA NUC PSA RGN           SQA
                           TRT
 __ KEY4     Q=     Type=       Buffers=   0K  MaxSpace=    2000M  MsgTime=   60

   Command ===>
   F1=Help      F2=End       F3=Return                              F6=Roll
                F8=Forward   F9=Refresh                            F12=Retrieve
The following command code is available:
C change
Invokes the modification panel by providing the options of the selected system as input:
  • The Sysplex field shows the name of the sysplex.
  • The System field shows the name of the system in the sysplex.
  • The Permission field shows your authorization level.
  • The Dump options field shows the default SDUMP options of all systems in the sysplex. For each system the following details are displayed:
    Q=
    Shows whether or not SDUMP quiesces the system while dumping the contents of the SQA or CSA.
    TYPE=
    Causes SVC dump to dump the cross memory address spaces that the caller has when SVC dump gets control (XMEM) or when the error causing the dump occurs (XMEME).

    With z/OS version 2.3, MVS supports the option XMEMT. You can specify it alone, or together with XMEM or XMEME. If specified together, the INGPLEX SDUMP panel will display XMEM* or XMEME*.

    XMEMT sets the SDUMP system dump options list to cross memory of target ASIDs. Specifying TYPE=XMEMT causes the SVC dump to dump private storage (depending on the SDATA options that are in effect) from the active cross memory address spaces of the originally requested, non-exempt target address spaces specified on the ASID/JOBNAME and TSONAME parameters on the DUMP command. The added XMEMT ASIDs are listed in message IEA047I.

    BUFFERS=
    Shows the reserved storage exclusively used by SVC dump. This storage can be used while capturing the contents of the common area storage.
    MaxSpace
    Shows the maximum amount of virtual storage that SVC dump can use to capture volatile virtual storage data, summary dump data, and component-specific data before writing the dump to DASD.
    MsgTime
    Shows how long (mm) the message IEA793A is shown at the console. When the system deletes the message, it also deletes the captured dump.
The FIND and RFIND commands are supported. If you specify command code C, the panel shown in Figure 3 is displayed.
Figure 3. INGPLEX SDUMP Modification Panel
  INGLX252                  SA z/OS  - Command Dialogs          
  Domain Id . : IPSFP   --------- INGPLEX SDUMP ----------   Date . . : 01/26/18
  Operator Id : NETOP1          Sysplex = KEY1PLEX           Time . . : 10:24:49

  System  . . . . . . : KEY1              Recommended options are underlined.

  NODUMP ... ==> N    (all other options below are ignored)
  ALLNUC ... ==> _    ALLPSA(*)  ==> _    COUPLE ... ==> _    CSA ...... ==> Y 
  GRSQ ..... ==> _    LPA ...... ==> Y    LSQA ..... ==> Y    NUC ...... ==> Y
  PSA ...... ==> Y    RGN ...... ==> Y    SERVERS .. ==> _    SQA(*) ... ==> Y
  SUMDUMP(*) ==> _    SWA ...... ==> _    TRT ...... ==> Y    WLM ...... ==> _
  XESDATA .. ==> _    (*) = The NOxxx option is generated when not selected.

  Q(uiesce)  ==> ___      (YES / NO)
  Type ..... ==> _____    (XMEM / XMEME)
             ==> _____    (XMEMT)
  Buffers .. ==> 0K___    (nnnnK / nnnM)
  MaxSpace . ==> 2000____ (MB)
  MsgTime .. ==> 60___    (minutes)

  Command ===>
  F1=Help      F2=End       F3=Return    F4=Set SYS   F5=Undo all  F6=Roll
                                        F10=Set SYSS F11=Set SYSP F12=Retrieve
The modification panel allows you to modify all SDUMP options. Furthermore, you can delete SDUMP options. After entering your changes you can set the new options for:
  • The selected system
  • All systems in the sysplex
  • Selected systems in the sysplex
To set the options press the appropriate F-key. If you want to modify selected systems in the sysplex, you are prompted for the systems that the SDUMP options are being changed for. To reset the options to the state when the modification panel was invoked press F5 Undo all.
Note: The user must be authorized to change any SDUMP option. The authorization can be any of those that are used for controlling coupling facilities and couple data sets.

For further information about the panel fields refer to the online help.