DMACPRT report

The DMACPRT report shows the statistics of the common area information, the DMAC information, and the DMAC dump.

The DMACPRT report includes the following sections:

  • Area information
  • DMAC mapping
  • DMAC dump

This report is generated by the DMACPRT command.

Note: The header of each report is "DMACPRT report".

This report is not printed if you make one of the following specifications:

  • GLOBAL SCAN=SITE_CREATE
  • GLOBAL SCAN=SITE_REPORT

Area information

This section shows the statistics of the common area information. The area information for the second CI and DMCB are reported and the differences between them are shown with '*'.

The following figure is an example of an area information.

Figure 1. Example of an area information
IMS HPFP UTILITIES - FPA DMACPRT                          "DMACPRT report"                                             PAGE:       1
5698-FPP V2R1                                                                                                    2021-11-22 14:34:28 

 DMAC MAPPING FROM DATABASE:   DEDBJN21                                                                                    

   - AREA NO:     1  AREANAME: DB21AR0   DDNAME: DB22AR0   DSNAME: HPFP.MDB21AR0.ADSFP
                                         (JCL DD ALLOCATION)                                                               

   - AREA INFORMATION                                                                                                      
                                                                            *: DIFFERENCE DETECTED                         
                                 2ND CI                DMCB                                                                
                                --------------------- ---------------------                                                
       - IMS VERSION             141                   141                                                                 
       - DBDNAME                 DEDBJN21              DEDBJN21                                                            
       - AREA NAME               DB21AR0               DB21AR0                                                             
       - CI SIZE                 1024                  1024                                                                
       - ROOT                    (5,1)                 (5,1)                                                               
       - UOW                     (5,1)                 (5,1)                                                               
       - BASE                                                                                                              
         - NUMBER OF CI'S                                                                                                  
           - TOTAL CI'S          16                    16                                                                  
       - DOVF                                                                                                              
         - NUMBER OF CI'S                                                                                                  
           - TOTAL CI'S          4                     4                                                                   
       - IOVF                                                                                                              
         - NUMBER OF CI'S                                                                                                  
           - TOTAL CI'S          4                     4                                                                   
       - SDEP                                                                                                              
         - NUMBER OF CI'S                                                                                                  
           - TOTAL CI'S          463                   N/A                                                                 
         - START BLOCK#          32                    32                                                                  
         - RANGE                                                                                                           
           - FROM                X'00008000'           X'00008000'                                                         
           - TO                  X'0007BC00'           N/A                                                                 
         - LOGICAL BEGIN                                                                                                   
           - CYCLE COUNT         X'00000001'           N/A                                                                 
           - RBA                 X'00008000'           N/A                                                                 
         - LOGICAL END                                                                                                     
           - CYCLE COUNT         X'00000001'           N/A                                                                 
           - RBA                 X'00009400'           N/A                                                                 
         - LOGICAL BEGIN TS      X'D194CC50C010E341'   N/A  

DMAC mapping

This section shows the DMAC information that is obtained by using the IMS mapping macro. The DMACPRT report shows both the global section and the local section in DMAC. In this report:

  • OFFSET shows the offset from the second CI top address.
  • LABEL shows the name of the IMS DBFDMAC macro.
  • VALUE shows the value of the data.
  • COMMENT shows what the data, which is quoted from IMS DBFDMAC macro, is.

The following figure is an example of the global section of DMAC mapping.

Figure 2. Example of a DMAC mapping: DMAC global section
IMS HPFP UTILITIES - FPA DMACPRT                          "DMACPRT report"                                             PAGE:       2
5698-FPP V2R1                                                                                                    2021-11-22 14:34:28 

   - AREA NO:     1  AREANAME: DB21AR0   DDNAME: DB22AR0   DSNAME: HPFP.MDB21AR0.ADSFP

   - DMAC INFORMATION :  DMAC GLOBAL SECTION    
                                                                           
         OFFSET   LABEL      VALUE                    COMMENT                                                              
         ------  ---------  -----------------------  ----------------------------------------------------------------------
         000000  DMACVNO    141                      VERSION NUMBER                                                        
         000003  DMACLKID   8                        AREA LOCK ID                                                          
                                                     * DMACLKCD     C'8'  : AREA LOCK ID FOR AREA                          
         000004  DMACDBNM   DEDBJN22                 DATA BASE NAME                                                        
         00000C  DMACNAME   DB22AR0                  AREANAME FOR AREA                                                     
         000014  DMACDBRC   X'00'                    DBRC USAGE INDICATOR                                                  
                                                       DMACREGR     X'80' : AREA REGISTERED WITH DBRC                      
                                                       DMACWDUI     X'40' : DBRC USAGE INDICATOR CHANGED                   
                                                       DMACSDWRA..  X'08' : ALL LOCAL 2ND TIME.                            
                                                       (DMACSDWRAPLCL2)                                                    
                                                       DMACSDWRA..  X'04' : ALL LOCAL 1ST TIME.                            
                                                       (DMACSDWRAPLCL1)                                                    
                                                       DMACSDW2     X'02' : COMPAT WRAP 2ND TIME.                          
                                                       DMACSDW1     X'01' : COMPAT WRAP 1ST TIME.                          
         000015  DMACDUI    X'10306F0836128F'        DBRC USAGE INDICATOR                                                  
         00001C  DMACSYSI                            IMS SUBSYSTEM ID                                                      
         000024  DMACOCNT   2           X'00000002'  COUNT OF UNUSED INDEPENDENT OVERFLOW CI'S                             
         000028  DMACCUSN   X'001C'                  DMAC CUSN                                                             
         00002A  DMACFLG4   X'88'                    FLAG BITS...                                                          
                                                     * DMACF4SH     X'80' : AREA HAS A SHARABILITY                         
                                                       DMACF4CC     X'40' : DEDB CONVERSION COMPLETED                      
                                                       DMACF4FC     X'20' : FORCE CLOSE DUE TO IRLM FAIL                   
                                                       DMACF4LR     X'10' : LOCK REJECT AT COMMIT-ROLB AND RETRY THE LOCK AT CALL
                                                     * DMACF4SD     X'08' : AREA HAS SDEP SEGMENT                          
                                                       DMACF4CS     X'04' : AREA HAS A CACHED DEVICE WHICH RECEIVED AN I/O ERROR
                                                       DMACCHG      X'02' : OLC AREA LEVEL CHANGE                          
                                                       DMACF4RC     X'01' : MADS IOT RECOVERY STARTED    
......
......
......

The following figure is an example of the local section of DMAC mapping.

Figure 3. Example of a DMAC mapping: DMAC local section
   - DMAC INFORMATION :  DMAC LOCAL SECTION     
                                                                           
         OFFSET   LABEL      VALUE                    COMMENT                                                              
         ------  ---------  -----------------------  ----------------------------------------------------------------------
         00009C  DMACFLG1   X'05'                    FLAG BITS...                                                          
                                                       DMACF1AF     X'80' : SEQUENTIAL DEP. PART FULL                      
                                                       DMACF1EP     X'40' : I/O ERROR                                      
                                                       DMACF1ST     X'20' : AREA STOP REQUEST                              
                                                       DMACF1RE     X'10' : AREA RESTART REQUEST                           
                                                       DMACF1ER     X'08' : ERROR RECOVERY NEEDED.                         
                                                     * DMACF1CP     X'04' : WAIT FOR W-M-C                                 
                                                       DMACF1BK     X'02' : TEMPORARY BIT FOR BACKOUT.                     
                                                     * DMACF1OP     X'01' : AREA IS OPEN                                   
         00009D  DMACFLG3   X'80'                    FLAG BITS...                                                          
                                                     * DMACF3SP     X'80' : AREA CLOSE IN PROCESS                          
                                                       DMACNTFY     X'40' : NOTIFY HAS BEEN SENT TO DBRC                   
                                                       DMACF3ER     X'20' : DMAC LOG EXIST DURING ERE                      
                                                       DMACF3RN     X'10' : AREA RECOVERY NEEDED REQUEST                   
                                                       DMACF3CR     X'08' : CREATE IS IN PROCESS SDEP                      
                                                       DMACARCB     X'04' : AVA. PHASE REACH BIT                           
                                                       DMACANYC     X'02' : AVA. PHASE NOT YET COMPLETED                   
                                                       DMACF3AS     X'01' : ADS STOP IN PROCESS                            
         00009E  DMACFLG6   X'05'                    FLAG BYTE 6                                                           
                                                       DMACF6FU     X'80' : FORCE DMAC SYNC 2ND CI UPD.                    
                                                       DMACF6RV     X'40' : CLOSE BY IRLM REVERIFICATION                   
                                                       DMACF6OP     X'20' : AOCE REOPEN PENDING                            
                                                       DMACF6WT     X'10' : MFLG WAITING FOR WTCT                          
                                                       DMACF6IP     X'08' : DMAC INTERNAL STOP REQUEST                     
                                                     * DMACF6CS     X'04' : DMAC CTL BLK SYNC REQUEST                      
                                                       DMACF6RQ     X'02' : LB RECOVERY REQUEST                            
                                                     * DMACF6UP     X'01' : ACCESS INTENT IS UP/EX        
......
......
......

DMAC dump

The following figure shows the DMAC dump that has the DMACLEN length. The length depends on the version of the IMS system. When the report is for the available area data sets, EQE INFORMATION, CUSN, and RBA are also reported.

Figure 4. Example of a DMAC dump
IMS HPFP UTILITIES - FPA DMACPRT                          "DMACPRT report"                                             PAGE:       6
5698-FPP V2R1                                                                                                    2021-11-22 14:34:28 

   - AREA NO:     1  AREANAME: DB21AR0   DDNAME: DB22AR0   DSNAME: HPFP.MDB21AR0.ADSFP
   - 2ND CI DUMP                                                                                                           
     - CI-RBA: 1024  (X'0400')                                                                                             
     000000  F1F4F1F8 C4C5C4C2 D1D5F2F1 C4C2F2F1   C1D9F040 0010306F 0836128F 00000000   *1418DEDBJN21DB21AR0 """ """ """"*
     000020  00000000 00000002 001C8800 000001EF   00000000 00000001 00009400 00000001   *""""""""""h"""" """""""""" """""*
     000040  00008000 00000000 00000001 00008000   00000001 00009000 00009000 00000001   *"" """"""""""" """"""" """ """""*
     000060  00000000 00000000 00000020 00000000   01C10004 00010005 00780002 00000400   *"""""""""""""""""A""""";" """"""*
     000080  00000016 0000001B 00000001 00000000   00000000 00018000 00000000 05800503   *"""""""""""""""""""""" """""; ;"*
     0000A0  03A08002 00000001 00000000 00000002   00000000 00000000 40000000 D194CC50   *"  """"""""""""""""""""" """^Wam*
     0000C0  C010E341 00000000 00000000 00000000   00000000 00000000 00000000 40404040   * & """""""""""""""""""""""""    *
     0000E0  0007BC00 000003C7 00000000 00000000   00000000 00008000 00000000 00000000   *"" """"G"""""""""""""" """""""""*
     000100  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     000120  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     000140  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     000160  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     000180  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     0001A0  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     0001C0  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     0001E0  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     000200  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     000220  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     000240  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     000260  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     000280  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     0002A0  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     0002C0  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     0002E0  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     000300  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     000320  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     000340  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     000360  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     000380  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     0003A0  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     0003C0  00000000 00000000 00000000 00000000   00000000 00000000 00000000 00000000   *""""""""""""""""""""""""""""""""*
     0003E0  00000000 00000000 00000000 00000000   00000000 1C000004 000003F9 03F90000   *"""""""""""""""""""""""""""9"9""*

   - EQE INFORMATION               (START RBA: X'03C7')                                                                    
     - EQE COUNTER              : 0                                                                                        

     0003C0                 00 00000000 00000000   00000000 00000000 00000000 00000000   *       """""""""""""""""""""""""*
     0003E0  00000000 00000000 00000000 00000000   000000                                *"""""""""""""""""""             *

   - CI SUFFIX INFORMATION                                                                                                 
     - CUSN                     : X'001C'                                                                                  
     - RBA                      : X'00000400'   

     0003E0                                              00 1C000004 00