INGPLEX SVCdump

Purpose

The INGPLEX SVCDUMP function allows you to issue a multisystem dump of up to 15 address spaces of a single system including their data spaces and structures.

Example

Figure 1. INGPLEX SVCDUMP Target System Selection Panel
 INGLX26S                  SA z/OS  - Command Dialogs       Line   1   of 2
 Domain Id . : IPSFP   -------- INGPLEX SVCDUMP ---------   Date . . : 01/26/18
 Operator Id : NETOP1          Sysplex = KEY1PLEX           Time . . : 10:30:23

 The following systems of the sysplex are registered to the automation.
 Use any non-blank character to select one system and then press ENTER.

     Sel.  System
     ----  --------
      __   KEY1
      __   KEY4











  Command ===>
  F1=Help      F2=End       F3=Return                             F6=Roll
                                                                 F12=Retrieve
  • The Sel field lets you select a system that a multisystem dump is issued from.
  • The System field shows the name of the system having joined the same XCF group the operator is logged on to.
For further information about the panel fields refer to the online help. After selecting a system and pressing Enter, the panel shown in Figure 2 is displayed.
Figure 2. INGPLEX SVCDUMP Address Space Selection Panel
 INGLX260                  SA z/OS  - Command Dialogs       Line  1    of 86
 Domain Id . : IPSFP   -------- INGPLEX SVCDUMP ---------   Date . . : 01/26/18
 Operator Id : NETOP1          Sysplex = KEY1PLEX           Time . . : 10:29:11

 System  . . . . . ==> KEY4
 SAplex  . . . . . ==> KEY4PLEX
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 Cmds: D/S de-/select job names for the SVC dump (up to 15 can be specified)

    Jobname   ASID  WorkUnitID  Userid
    --------  ----  ----------  --------
 __ TNF       0024
 __ TRACE     0004
 __ TSO       003B   STC05983   STCUSER
 __ VLF       0019
 __ VMCF      0025
 __ VTAM      001E   STC05982   STCUSER     selected
 __ WATS      0217   TSU06587   _           selected
 __ WLM       000B
 __ XCFAS     0006


  Command ===>
  F1=Help      F2=End       F3=Return               F5=NextPnl     F6=Roll
               F8=Forward   F9=Refresh                            F12=Retrieve
If, for example, you select the VTAM® address space and the WATS address space (which is a user), press Enter and then press F5, the panel shown in Figure 3 is displayed.
Figure 3. INGPLEX SVCDUMP Address Space Detail Panel
 INGLX261                  SA z/OS  - Command Dialogs       Line   1   of 20
 Domain Id . : IPSFP   -------- INGPLEX SVCDUMP ---------   Date . . : 01/26/18
 Operator Id : NETOP1          Sysplex = KEY1PLEX           Time . . : 10:36:02

 System  . . . . . . : KEY4
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 Cmds: D/S de-/select the areas to be dumped (max. 113 structures)
           A selection of the job name includes all related areas. If you make
           a selection press ENTER to confirm your selection before you proceed.

    Jobname   ASID  T Data Space/XCF Group Member/Structure
    --------  ----  - -------------------------------------------
 __ VTAM      001E
 __                 D IST90C95
 __                 D 00012IXL
 __                 D 00013IXL
 __                 L ISTGENERIC selected
 __                 M ISTCFS01.KEYB.VTAM.IPXVH___DEIBMIPS           selected
 __                 M ISTXCF.KEYB.VTAM.IPXVH___DEIBMIPS             selected
 __ WATS      0217

  Command ===>
  F1=Help      F2=End       F3=Return   F4=PrevPnl  F5=NextPnl     F6=Roll
               F8=Forward   F9=Refresh                            F12=Retrieve
   
This panel displays details of the address spaces that you selected in the previous panel. Each scrollable line shows either the job name and its address space identifier or the type and name of related information:
 T  Data Space/XCF Group Member/Structure  
 _  _____________________________________                                     
 C  Cache structure                                                            
 D  Data space                                                                   
 L  List structure                                                   
 M  XCF group member in the format:                                  
    o   XCF group name                                                
    o   System name                                                    
    o   Job name                                                         
    o   XCF member name

Any character that represents a NetView panel control character is replaced with an underscore.

In this example panel, address space VTAM has some data spaces (D), one list structure (L) and some XCF group members (M). TSO user WATS has nothing.

The following command codes are supported:
D
Deselects the previous selection.
S
Selects a local address space, data space, structure, or XCF group member address space for the SVC dump.

You may now select the related information you want to be dumped. A selection or deselection on the job name line will select or deselect all related information.

After you have made your selection, press the function key F5 to proceed. This will lead you to the final panel showing the dump options that are being used for the dump. A multi-system dump is taken if any XCF group member is selected. The dump service will issue a dump on every system that has been selected.

Function key F4 returns you to the previous panel without clearing your selection on the previous panel.

Figure 4. INGPLEX SVCDUMP Dump Option Panel
 INGLX262                  SA z/OS  - Command Dialogs
 Domain Id   = IPSFP   ---------- INGPLEX SVC -----------   Date . . : 01/26/18
 Operator Id = NETOP1          Sysplex = KEY1PLEX           Time . . : 10:40:36
 System  . . . . . . : KEY4

 Title .... ==>                                                   
            ==>                                                   

 SDATA Dump Options (recommended options are underlined)
 ALLNUC ... ==> _    ALLPSA(*)  ==> Y    COUPLE ... ==> _    CSA ...... ==> Y
 GRSQ ..... ==> Y    LPA ...... ==> _    LSQA ..... ==> _    NUC ...... ==> Y
 PSA ...... ==> _    RGN ...... ==> Y    SERVERS .. ==> _    SQA(*) ... ==> Y
 SUMDUMP(*) ==> Y    SWA ...... ==> _    TRT ...... ==> Y    WLM ...... ==> _
 XESDATA .. ==> _    (*) = The NOxxx option is used when not selected.

 Structure Dump Options (SUMMARY and ADJUNCT/ENTRYDATA are mutually exclusive)
 COCLASS .. ==>      EMCONTROLS ==>      LISTNUM .. ==>      STGCLASS . ==>  
 ADJUNCT .. ==>      ENTRYDATA  ==>      SUMMARY .. ==>  

 Command ===>
 F1=Help      F2=End       F3=Return    F4=PrevPnl  F5=Dump       F6=Roll
                                                                 F12=Retrieve

The panel shows the default dump options that are set on invocation. After specifying the dump title, press F5 to issue the dump. When the dump is taken, the function returns to the address space selection panel with all selections cleared. The SORT, FIND and RFIND commands are supported for selection panels only. For further information about the panel fields refer to the online help.

Executing this command in line-mode requires the following 5 steps:
  1. Execute the command:
    INGPLEX SVC sysname [REQ=LIST] OUTMODE=LINE
  2. Remove the first 5 lines and the last line from the output. Then select the address spaces that you want to dump and save the entries using a PIPE command:
    PIPE ... | SAFE INGRX260
    Keep the same format that is returned in the REQ=LIST output.
  3. Execute the command:
    INGPLEX SVC sysname REQ=COMP OUTMODE=LINE
  4. Again remove the first 5 lines and the last line from the output. Then select the address spaces and the associated components, such as data spaces, XCF group members, and cache and list structures and save these entries using a PIPE command:
    PIPE ... | LIT \dump title/sdata options/stropt\ |SAFE INGRX260
    Keep the same format that is returned in the REQ=COMP output. The dump options passed by the LIT stage correspond exactly to the values in Figure 4.
  5. Execute the command:
    INGPLEX SVC sysname REQ=DUMP OUTMODE=LINE
Figure 5. INGPLEX SVC Line Mode Sample
"PIPE NETV INGPLEX SVC "sysname" OUTMODE=LINE" ,                   
   "| SEP" ,                                                       
   "| NOT TAKE 5" ,                                                
   "| NOT TAKE LAST" ,                                             
   "| STEM z."                                                     
                                                                   
"PIPE STEM z.",                                                    
   "| LOCATE 1.6 /RASP  /" , /* locate RASP and     */             
            "1.6 /TRACE /" , /* TRACE address space */             
   "| SAFE INGRX260"                                               
                                                                   
"PIPE NETV INGPLEX SVC "sysname" REQ=COMP OUTMODE=LINE" ,          
   "| SEP" ,                                                       
   "| NOT TAKE 5" ,                                                
   "| NOT TAKE LAST" ,                                             
   "| STEM z."                                                     
                                                                   
dumpopt = 'Dump RASP and TRACE in line mode' || ,                  
          '/ALLNUC ALLPSA CSA GRSQ LSQA PSA RGN SQA SWA TRT'       
                                                                   
"PIPE STEM z.",                                                    
   "| NLOC 17.1 /M/" ,       /* don't process XCF group members */ 
   "| LIT \"dumpopt"\" ,                                           
   "| SAFE INGRX260"                                               
                                                                   
"PIPE NETV INGPLEX SVC "sysname" REQ=DUMP OUTMODE=LINE" ,          
   "| CONS ONLY"