Taking a dump of CICS IA

For certain types of problem, you might be asked to supply a dump of CICS® IA. To request a dump of a CICS IA address space and its associated data space, use the MVS™ DUMP command.

You can issue the MVS DUMP command from the console. Use the ASID= keyword to identify the address space and the DSPNAME= keyword to identify the data space.

The data space name takes the form nnnnnINT, where nnnnn is a five-character number that can be obtained from the CICS IA Operations Statistics Menu, CIU150, shown in Figure 1. It is usually 00000INT.

Figure 1. Collector Statistics Menu panel, CIU150, showing the CICS IA data space name
 CIU150        CICS Interdependency Analyzer for z/OS - V5R1M0        2012/07/31
                             Statistics Menu for                      01:16:31PM
                                                                                
          CICS Sysid   : Z518     CICS Applid   : IYDZZ518                      
                                                                                
   CINT state . . . . . . . . : STOPPED      Collecting Dependencies            
   Records written last save. : 88           Number of pauses . . . : 0         
   Total records on file. . . : 88           Number of saves. . . . : 1         
                                                                                
                                                                                
                                                                                
   Date/time of last start. . : 2012/07/30 12:54:17PM                           
   Date/time of last save . . : 2012/07/30 12:55:00PM                           
   Date/time of last change . : 2012/07/30 12:54:54PM                           
                                                                                
   Total time RUNNING . . . . : 0000:00:41  (HHHH:MM:SS)                        
   Total time PAUSED. . . . . :             (HHHH:MM:SS)                        
                                                                                
   Table dataspace name . . . :                  % full                         
                                                                                
 CICS Sysid:  Z518   CICS Applid:  IYDZZ518   TermID:  TC45                     
                                                                                
 F1=Help      F2=           F3=End       F4=          F5=Refresh  F6=           
 F7=          F8=           F9=          F10=         F11=         F12=         
To obtain the data space name for the CICS address space in which CICS IA is active, use the MVS DISPLAY ACTIVE command:
/D A,cicsname
where cicsname is the name of the CICS address space.
Figure 2 shows some example output from the MVS DISPLAY ACTIVE command. In this example, the cicsname is CICSTS0A, the ASID is 00A8 and the data space name is 00000INT. The data space name is also available from the CICS IA Operations Statistics Menu, shown above. In the following examples a dump for CICS region CICSTS0A has been taken, where CICSTS0A is the name of the CICS address space. The CICS applid for this region is IYCYZC3A and the CICS sysid is TS0A.
Figure 2. Example output from an MVS DISPLAY ACTIVE command, showing a data space name of 00000INT
RESPONSE=MV2E                                                           
 IEE115I 14.59.54 2011.309 ACTIVITY 001                                 
  JOBS     M/S    TS USERS    SYSAS    INITS   ACTIVE/MAX VTAM     OAS  
 00006    00089    00006      00034    00041    00006/00090       00053 
  CICSTS0A CICSTS0A CICS     NSW  SO  A=00A8   PER=NO   SMC=000         
                                      PGN=N/A  DMN=N/A  AFF=NONE        
                                      CT=005.849S  ET=01.55.31          
                                      WUID=STC00974 USERID=CTOOLUSR     
                                      WKL=GENERAL  SCL=STCUSER  P=1     
                                      RGP=N/A      SRVR=YES QSC=NO      
                                      ADDR SPACE ASTE=04937A00          
                                      DSPNAME=DFHDT001 ASTE=5EA66400    
                                      DSPNAME=00000INT ASTE=049CCC80   
To dump this data space, use the following command, where nn and mm are the outstanding reply numbers:
/DUMP COMM=(IA DUMP) 
/R nn,JOBNAME=CICSTS0A,CONT 
/R mm,DSPNAME=('CICSTS0A'.00000INT),END

Formatting the CICS IA Dump

If you use the MVS interactive problem control system (IPCS) to format and analyze CICS system dumps, you can use the CICS IA system dump formatting routine to format the CICS IA Collector data areas and trace, the dump formatting routine accessible to IPCS, as described in CICS IA supplied modules required in the MVS link list. When your CICS system dump is formatted by the CICS release-dependent formatting routine, the CICS IA Collector data areas and trace are also formatted under the heading "CICS Interdependency Analyzer Control Blocks".

Use the IPCS command:
IPCS VERBX DFHPDnnn 'ft'
where nnn is the CISC TS version; for example DFHPD650. This command invokes the feature table and routine for a CICS TS dump. The CICS IA feature routines are called CIUIADUF and CIUICDUF, and can be located in the output by searching on =CIUIADUF (or =CIUICDUF).
For example:
 =CIUIADUF: Feature routine                                                                                                                                    
 ===IA: CICS Interdependency Analyser Control Blocks                                                                                                            
Collector status: FAILING                Collecting: INTERDEPENDENCIES         
Date last started: 20110125              Time last started: 145212             
Date last saved:                         Time last saved:                      
Saves: 0     Records last save: 0        Pauses: 0     Records total: 146        

Concept Concept

Feedback


Timestamp icon Last updated: Friday, 22 November 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///ciuug9r.html