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
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.
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
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
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.
- 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.
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.
- Execute the command:
INGPLEX SVC sysname [REQ=LIST] OUTMODE=LINE - 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:
Keep the same format that is returned in the REQ=LIST output.PIPE ... | SAFE INGRX260 - Execute the command:
INGPLEX SVC sysname REQ=COMP OUTMODE=LINE - 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:
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.PIPE ... | LIT \dump title/sdata options/stropt\ |SAFE INGRX260 - Execute the command:
INGPLEX SVC sysname REQ=DUMP OUTMODE=LINE
"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"