User-requested dumps

You can request a dump of a CICSPlex® SM address space at any time by:

Using the MVS DUMP command

You can issue the MVS DUMP command from the console to dump an Environment Services System Services (ESSS) address space, a CMAS, or a CICS®/ESA or CICS/MVS MAS. Use the ASID= keyword to identify one or more address spaces and the DSPNAME= keyword to request data space dumps.

If you request a dump of data spaces, you must also dump the DMDS sysid data space and the ESSS address space, because that component owns all CICSPlex SM data spaces. Data space names take the form:

cmpnsysid

where:

cmp
Is either the three-character identifier of the component that uses the data space or DMDS, for the data cache master data space, which has controlling information for all data spaces. For a list of component identifiers, see Major components of CICSPlex SM.
n
Is the sequential number of a component data space.
sysid
Is the four-character system ID of the associated CMAS.
Note:
You can use the MVS DISPLAY ACTIVE command to display the ASID of the ESSS address space (EYUX140) and the names of data spaces.

A sample dump command for a CMAS might look like this:

DUMP COMM=(CMAS DUMP)
R xx,ASID=(2A,55),CONT
R xx,DSPNAME=(55.DMDSHTC1,55.QUE1HTC1),END

Using the ISPF end-user interface

You can use the SNAP action command on the CICSRGN view to request a system dump for a MAS in those CICS releases that support it..

For example, if you want a system dump for the MAS called EYUMAS1A, do the following:

  1. Issue the CICSRGN view command.
  2. Either issue the SNAP primary action command from the COMMAND field, as shown in Figure 14, or enter the SNA line action command in the line command field next to EYUMAS1A.
    Figure 14. Requesting a system dump from CICSRGN
     27FEB2005 11:30:30 --------- INFORMATION DISPLAY ------------------------------
     COMMAND  ===>  SNAP EYUMAS1A                               SCROLL ===> PAGE
     CURR WIN ===> 1         ALT WIN ===>
      W1 =CICSRGN=CICSRGN==EYUPLX01==EYUCSG01==27FEB2005==11:30:30=CPSM======3======
     CMD CICS     Job      MVS  Act    CICS   CPU      Page     Page     Total
     --- System-- Name---- Loc  Task-- Status Time---- In------ Out----- SIO-----
         EYUMAS1A CICPRODA SYSA     34 ACTIVE 12345678  1234567  1234567 12345678
         EYUMAS2A CICAOR1P SYSA     22 ACTIVE      567  1234567  1234567    10678
         EYUMAS1B CICAOR2A SYSB     18 ACTIVE       10  1234567  1234567       25
     
  3. When the CICS SNAP input panel appears, as shown in Figure 15, specify:
    Figure 15. The CICS SNAP input panel
     ----------------------------- CICS SNAP ---------------------------------------
     COMMAND  ===>
     
     Specify the options to be used for this dump of CICS:
     
     Dump  Code ===> NORMAL          1- to 8-character dump code
     
     Caller     ===> NO              1- to 8-character caller ID
     
     
                               TITLE (79 characters)
     
     
     
    Press Enter to continue CICS dump with the options specified.
    Type END or CANCEL to terminate dump request.

The following message appears in the window to confirm the dump request:

EYUEI0568I  Dump Taken for EYUMAS1A, assigned DUMPID is nn/nnnn

where nn/nnnn is the dump ID assigned by MVS.

In the job log for EYUMAS1A you will see:

10.03.05 JOB00221  +DFHDU0201 EYUMAS1A ABOUT TO TAKE SDUMP. DUMPCODE: code, DUMPID: nn/nnnn
10.03.12 JOB00221  IEA794I SVC DUMP HAS CAPTURED:
                   DUMPID=005 REQUESTED BY JOB (EYUMAS1A)
                   DUMP TITLE=CICSDUMP: SYSTEM=EYUMAS1A CODE=code ID=nn  /nnnn
 
10.03.05 JOB00221  +DFHDU0202 EYUMAS1A SDUMP COMPLETE.

[[ Contents Previous Page | Next Page Index ]]