VERBEXIT GRSTRACE subcommand output

The IPCS VERBEXIT GRSTRACE subcommand produces diagnostic reports about global resource serialization from dumps. z/OS MVS IPCS Commands gives the syntax of the VERBEXIT GRSTRACE subcommand and z/OS MVS IPCS User's Guide explains how to use the GRSTRACE option of the IPCS dialog.

The dump may also contain component trace data for global resource serialization and latch contention statistics. See the component trace chapter of z/OS MVS Diagnosis: Tools and Service Aids for information on how to format global resource serialization component trace data.

The VERBEXIT GRSTRACE report displays local, global, and step queues with outstanding global resource serialization requests. An asterisk next to a minor name indicates resource contention for that minor name.
 * * * * *  GLOBAL RESOURCE SERIALIZATION CONTROL BLOCK PRINT  * * * * *
                                                                        
Options list:                                                          
                                                                       
  Report................. GRSTRACE                                     
                                                                       
  Level of detail........ SUMMARY                                      
                                                                       
  Requested time format.. LOCAL                                        
                                                                       
  Filter(s) in use:                                                    
    NONE                                                               
* * * * * * * * * * * * * * DIAGNOSTIC DATA * * * * * * * * * * * * *  
GVT                          00000000_00FE1000                         
GVTX                         00000000_006EB000                         
GQHT                         00000021_F8F00000                         
SGHT                         00000000_00000000                         
LQHT                         00000021_F8E00000                         
STHT                         00000000_7F5B8000                         
RPT                          00000000_7F5F7F40                         
                                                                       
* * * * * * * * * * * * * * CONFIGURATION INFORMATION * * * * * * * *  
GRS Mode                         RING                                  
Current RESMIL Value               19                                  
Minimum RESMIL Value               15                                         
Maximum RESMIL Value               19                                         
RESMIL Self Tuning                 On                                         
TOLINT Value                      180                                         
ACCELSYS Value                     99                                         
Synchres Setting                  Yes                                         
Active Exits                     None                                         
CTRACE Buffer size (K)           4096                                         
The EQDQ monitor is               Off                                         
ENQMAXA                        250000                                         
ENQMAXU                         16384                                         												
                               ***************************************************
                               ***************************************************
                               *****                                         *****
                               *****   STEP QUEUE (STHT) CONTROL BLOCK PRINT *****
                               *****                                         *****
                               ***************************************************
                               ***************************************************
                                                                              
                                                                              
 MAJOR NAME: SPFUSER                                               
                                                                   
     MINOR NAME: SPFUSER                                           
       SCOPE: STEP      SYSNAME: S4        STATUS: *EXCLUSIVE* /OWN
         ASID: 0000002A   TCB: 006F8650    JOBNAME: SPFUSER        
         Critical ENQ Time(s):                                     
           Request:     07/09/2007 13:03:16.053994                 
           Grant:       07/09/2007 13:03:16.054019                 
                                                                   
 MAJOR NAME: SYSBLSDI                                              
                                                                   
     MINOR NAME: 0005F610                                     *..6.
       SCOPE: STEP      SYSNAME: S4        STATUS: *SHARED*    /OWN
         ASID: 0000002A   TCB: 006F8328    JOBNAME: SPFUSER        
         Critical ENQ Time(s):                                     
           Request:     07/09/2007 13:08:48.776676                 
           Grant:       07/09/2007 13:08:48.776689   
              
                               ***************************************************
                               ***************************************************
                               *****                                         *****
                               *****  LOCAL QUEUE (LQHT) CONTROL BLOCK PRINT *****
                               *****                                         *****
                               ***************************************************
                               ***************************************************
                                                                              
                                                                              
 MAJOR NAME: SYSDSN                                                 
                                                                    
     MINOR NAME: SYS1.BRODCAST                                      
       SCOPE: SYSTEM    SYSNAME: S4        STATUS: *SHARED*    /OWN 
         ASID: 00000001   TCB: 006E97B0    JOBNAME: *MASTER*        
         Critical ENQ Time(s):                                      
           Request:     07/09/2007 12:27:54.361651                  
           Grant:       07/09/2007 12:27:54.361743                  
                                                                    
     MINOR NAME: SYS1.DAE                                           
       SCOPE: SYSTEM    SYSNAME: S4        STATUS: *SHARED*    /OWN 
         ASID: 00000005   TCB: 006FFB00    JOBNAME: DUMPSRV         
         Critical ENQ Time(s):                                      
           Request:     07/09/2007 12:29:05.519990                  
           Grant:       07/09/2007 12:29:05.520012                  
                                                                    
     MINOR NAME: SYS1.UADS                                          
       SCOPE: SYSTEM    SYSNAME: S4        STATUS: *SHARED*    /OWN 
         ASID: 0000002A   TCB: 006FFB00    JOBNAME: SPFUSER         
         Critical ENQ Time(s):                                      
           Request:     07/09/2007 13:02:37.259848                  
           Grant:       07/09/2007 13:02:37.345562                  
                                                                    
 MAJOR NAME: SYSIEA01                                               
                                                                    
                                                                    
 *   MINOR NAME: SDUMPENQ                                            
       SCOPE: SYSTEM    SYSNAME: S4        STATUS: *EXCLUSIVE* /OWN  
         ASID: 00000005   TCB: 006FCC98    JOBNAME: DUMPSRV          
         Critical ENQ Time(s):                                       
           Request:     07/09/2007 13:35:33.770814                   
           Grant:       07/09/2007 13:35:33.770842                                  
       SCOPE: SYSTEM    SYSNAME: S4        STATUS: *EXCLUSIVE* /WAIT 
         ASID: 00000007   TCB: 006FFD90    JOBNAME: GRS              
         Critical ENQ Time(s):                                       
           Request:     07/09/2007 13:35:33.851154                   
           Contention:  07/09/2007 13:35:33.851219      
                               ***************************************************
                               ***************************************************
                               *****                                         *****
                               ***** GLOBAL QUEUE (GQHT) CONTROL BLOCK PRINT *****
                               *****                                         *****
                               ***************************************************
                               ***************************************************
                                                                              
                                                                              
 MAJOR NAME: SYSDSN                                                  
                                                                     
     MINOR NAME: AFOSTER.USER.LOAD                                   
       SCOPE: SYSTEMS   SYSNAME: SYSTEM02  STATUS: *SHARED*    /OWN  
         ASID: 00000006   TCB: 006FFB00    JOBNAME: XCFAS            
         Critical ENQ Time(s):                                       
           Request:     07/09/2007 12:29:01.924808                   
         Some ENQ information is unavailable for this remote request 
       SCOPE: SYSTEMS   SYSNAME: S4        STATUS: *SHARED*    /OWN  
         ASID: 00000006   TCB: 006FFB00    JOBNAME: XCFAS            
         Critical ENQ Time(s):                                       
           Request:     07/09/2007 12:29:40.935860                   
           Grant:       07/09/2007 12:29:41.044668                   
       SCOPE: SYSTEMS   SYSNAME: SYS3      STATUS: *SHARED*    /OWN  
         ASID: 00000006   TCB: 006FFB00    JOBNAME: XCFAS            
         Critical ENQ Time(s):                                       
           Request:     07/09/2007 12:29:53.538074                   
         Some ENQ information is unavailable for this remote request 
       SCOPE: SYSTEMS   SYSNAME: SYSTEM02  STATUS: *SHARED*    /OWN  
         ASID: 00000019   TCB: 006FFB00    JOBNAME: LLA              
         Critical ENQ Time(s):                                       
           Request:     07/09/2007 12:29:57.821468                   
         Some ENQ information is unavailable for this remote request 
       SCOPE: SYSTEMS   SYSNAME: S4        STATUS: *SHARED*    /OWN  
         ASID: 00000019   TCB: 006FFB00    JOBNAME: LLA              
         Critical ENQ Time(s):                                       
           Request:     07/09/2007 12:30:47.855738                   
           Grant:       07/09/2007 12:30:47.906647                   
       SCOPE: SYSTEMS   SYSNAME: SYS3      STATUS: *SHARED*    /OWN  
         ASID: 00000019   TCB: 006FFB00    JOBNAME: LLA                    
         Critical ENQ Time(s):                                             
           Request:     07/09/2007 12:30:56.855009                         
         Some ENQ information is unavailable for this remote request       
       SCOPE: SYSTEMS   SYSNAME: A         STATUS: *SHARED*    /OWN        
         ASID: 00000006   TCB: 006FFB00    JOBNAME: XCFAS                  
         Critical ENQ Time(s):                                             
           Request:     07/09/2007 12:55:58.354763                         
         Some ENQ information is unavailable for this remote request       
       SCOPE: SYSTEMS   SYSNAME: A         STATUS: *SHARED*    /OWN        
         ASID: 00000019   TCB: 006FFB00    JOBNAME: LLA                    
         Critical ENQ Time(s):                                             
           Request:     07/09/2007 12:56:24.260937                         
         Some ENQ information is unavailable for this remote request                                                     
  MINOR NAME: ARTMVS.EXITS.LOADLIB                                      
       SCOPE: SYSTEMS   SYSNAME: SYSTEM02  STATUS: *SHARED*    /OWN        
         ASID: 00000006   TCB: 006FFB00    JOBNAME: XCFAS                  
         Critical ENQ Time(s):                                             
           Request:     07/09/2007 12:29:01.454510                         
         Some ENQ information is unavailable for this remote request       
       SCOPE: SYSTEMS   SYSNAME: S4        STATUS: *SHARED*    /OWN        
         ASID: 00000006   TCB: 006FFB00    JOBNAME: XCFAS                  
         Critical ENQ Time(s):                                             
           Request:     07/09/2007 12:29:40.609526                         
           Grant:       07/09/2007 12:29:40.718159                         
       SCOPE: SYSTEMS   SYSNAME: SYS3      STATUS: *SHARED*    /OWN        
         ASID: 00000006   TCB: 006FFB00    JOBNAME: XCFAS                  
         Critical ENQ Time(s):                                             
           Request:     07/09/2007 12:29:53.081204                     
         Some ENQ information is unavailable for this remote request   
       SCOPE: SYSTEMS   SYSNAME: SYSTEM02  STATUS: *SHARED*    /OWN    
         ASID: 00000019   TCB: 006FFB00    JOBNAME: LLA                
         Critical ENQ Time(s):                                         
           Request:     07/09/2007 12:29:57.426946                     
         Some ENQ information is unavailable for this remote request   
       SCOPE: SYSTEMS   SYSNAME: S4        STATUS: *SHARED*    /OWN    
         ASID: 00000019   TCB: 006FFB00    JOBNAME: LLA                
         Critical ENQ Time(s):                                         
           Request:     07/09/2007 12:30:47.597027                     
           Grant:       07/09/2007 12:30:47.649343                     
       SCOPE: SYSTEMS   SYSNAME: SYS3      STATUS: *SHARED*    /OWN    
         ASID: 00000019   TCB: 006FFB00    JOBNAME: LLA                
         Critical ENQ Time(s):                                         
           Request:     07/09/2007 12:30:56.409462                     
         Some ENQ information is unavailable for this remote request   
       SCOPE: SYSTEMS   SYSNAME: A         STATUS: *SHARED*    /OWN    
         ASID: 00000006   TCB: 006FFB00    JOBNAME: XCFAS              
         Critical ENQ Time(s):                                         
           Request:     07/09/2007 12:55:58.032551                     
         Some ENQ information is unavailable for this remote request   
       SCOPE: SYSTEMS   SYSNAME: A         STATUS: *SHARED*    /OWN    
         ASID: 00000019   TCB: 006FFB00    JOBNAME: LLA                
         Critical ENQ Time(s):                                         
           Request:     07/09/2007 12:56:23.991724                     
         Some ENQ information is unavailable for this remote request                                                     
The following fields might appear in the report depending on the VERBEXIT GRSTRACE SUMMARY or DETAIL report type and GRS environment. See individual field descriptions more for information.
DIAGNOSTIC DATA
GVT
Starting address of the global vector table (GVT)
GVTX
Starting address of the global vector extension (GVTX)
GQHT
Starting address of the global hash table (GQHT)
SGHT
Starting address of the system global hash table in STAR mode. (SGHT)
LQHT
Starting address of the local hash table (LQHT)
STHT
Starting address of the step queue hash table (STHT).
RPT
Starting address of the resource pool table (RPT)
CONFIGURATION INFORMATION
GRS Mode
GRS mode at the time of the dump. The possible values are NONE, RING, and STAR.
Present RESMIL Value
Present value of RESMIL in milliseconds. This field is only displayed in RING mode.
Minimum RESMIL Value
Minimum value of RESMIL in milliseconds. This field is only displayed in RING mode.
Maximum RESMIL Value
Maximum value of RESMIL in milliseconds. This field is only displayed in RING mode.
RESMIL Self Tuning
Setting of RESMIL self tuning. Possible values are ON or OFF. This field is only displayed in RING mode.
TOLINT Value
Value of TOLINT displayed in seconds. This field is displayed in RING mode.
ACCELSYS Value
ACCELSYS value. This field is displayed in RING mode.
Synchres setting
Setting of the synchronous reserve processing. Possible values are Yes, No, and Disabled.
Active Exits
List of the current global resource serialization installation exits. For complete installation exit information, see z/OS MVS Installation Exits. Possible values of this field include:
  • NONE - There were no active exits
  • ISGNQXIT - The ENQ/DEQ installation exit was active.
  • ISGNQXITBATCH - The ENQ/DEQ batch installation exit was active.
  • ISGNQXITQUEUED1 - The ENQ/DEQ queued installation exit was active.
  • ISGNQXITFAST - The fast ENQ/DEQ installation exit was active.
  • ISGENDOFLQCB - The ENQ/DEQ end of local QCB installation exit was active.
  • ISGNQXITPREBATCH - The ENQ/DEQ pre batch installation exit was active.
  • ISGNQXITBATCHCND - The ENQ/DEQ batch conditional installation exit was active.
  • ISGCNFXITSYSTEM - The contention notification filter installation exit for system-scope resources was active.
  • ISGCNFXITSYSPLEX - The contention notification filter installation exit for sysplex-scope resources was active.
GRSQ Setting
The GRSQ setting. Possible values are LOCAL, CONTENTION, or ALL. Only displayed in STAR mode.
CNS
System name of the Contention Notification System. Only displayed in STAR mode. A value of 'Unavailable' is displayed if the required information is not present in the dump.
CTRACE Buffer size (k)
Value of the CTRACE buffer size in bytes.
The EQDQ monitor is
Status of the ENQ/RESERVE/DEQ monitor. Possible values are ON or OFF.
ENQMAXA
Value of the system wide ENQMAXA.
ENQMAXU
Value of the system wide ENQMAXU.
Outstanding ENQ/RESERVE breakdown sections
MAJOR NAME
The major name of a resource
MINOR NAME
The minor name of a resource (with * if resource contention exists)
RESOURCE CREATION TIME
The Resource Creation Time is the time that global resource serialization last acknowledged interest in the resource. The requester who caused the acknowledgment might have dequeued. Global resource serialization removes all knowledge of the resource when there are no interested parties. The Time is displayed in the request Time(Local|GMT|UTC) format. This field is displayed only when DETAIL is specified.
LAST MOVEWAITER TIME
The last time when this resource was affected by an ISGADMIN MOVEWAITER request. See z/OS MVS Programming: Authorized Assembler Services Guide and z/OS MVS Programming: Authorized Assembler Services Reference EDT-IXG for information specific to the ISGADMIN service. The Time is displayed in the request Time(Local|GMT|UTC) format. This field is displayed only when DETAIL is specified.
SCOPE
Scope of the resource - SYSTEM, SYSTEMS, or STEP
SYSNAME
Name of the system requesting the resource
STATUS
Type of access to resource requested - SHARED or EXCLUSIVE
ASID
Address space identifier (ASID) for address space where request was issued
TCB
The address of the task control block (TCB) requesting the resource
JOBNAME
The name of the job requesting the resource
MASID
Address space identifier (ASID) for address space where the MASID target request was issued. This field is displayed only for MASID ENQ users.
MTCB
The address of the task control block (TCB) targeted by the MASID ENQ request. This field is only displayed for MASID ENQ requests.
Note: A non-zero MTCB value with a zero MASID value indicates that the original ENQ request specified MASID= MTCB=, but GRS converted this request to a regular (non-MASID) ENQ.
Reserve Device
Displays the EBCDIC device number for this UCB. In GRS RING, if the request originated from a remote system message, Reserve from remote system, is displayed. If data is not available through the IOSVIEDN service, the UCB address is displayed in message, "Reserve UCB at xucbaddr unavailable."
Volser
Displays the Volser for this UCB. In GRS RING, if the request originated from a remote system, message, "Reserve from remote system" is displayed. If data is not available via the IOSVIEDN service, the UCB address is displayed in message, "Reserve UCB at xucbaddr unavailable."
Synchronous Reserve status
Displays the state of the GRS managed Reserve. This field is blank until the ENQ is owned by this requester. One of the following states can occur:
SYNCHRES COMPLETE
Either the device was already reserved by this system and GRS incremented the usage count or GRS completed the I/O necessary to reserve the device.
NOT SYNCHRES
The device was not already reserved by this system and GRS did not make any attempt to reserve the device. The system will reserve the device when I/O request by the requester is complete.
WAITING FOR SYNCHRES TO COMPLETE
The device was not already reserved by this system and GRS has started the I/O necessary to reserve the device; however, the I/O has not yet completed. The device might be reserved by another system.
INCOMPLETE REQUEST: STATE UNKNOWN .
GRS has not finished determining whether to attempt a synchronous reserve for this request. The state is unknown.
Critical ENQ Times
ENQ request, contention, grant, and ISGADMIN movewaiter times. The outputs are formatted according to the Time(Local|GMT|UTC) specification. Local is the default time format.
Request - The time the ENQ request was issued. For GRS RING globals originating on a system where the current dump was not taken, it's the time the dumped system received this request. Other possible values include:
  • 0, QEL BEING FREED - The QEL is in the act of being freed.
The following fields are presented only for requests originating on the dumped system. The requests include all local requests, all GRS=STAR global requests known to the dumped system, and GRS RING requests originating on the dumped system. For GRS RING requests originating from another system, the following message is issued:
Some ENQ information is unavailable for this remote request
  • Contention - Time that GRS detected resource contention for the overall request originating on the dumped system. The Contention field is only displayed if contention was ever detected by GRS for this particular request. Other possible values include: 0, BUT IS WAITING - Small timing window where GRS has marked the requester as waiting but GRS has not yet set the wait time.
  • Started I/O - Time that GRS either incremented the usage count for a RESERVE already held by this system or started the I/O to RESERVE the device because of the request.
  • Grant - Time that the overall request was granted access to all resources. Other possible values include: 0, BUT NOT WAITING - Small timing window where GRS has granted access to all resources in the request, but the grant time has not yet been set.
  • Delta Time Waiting - Amount of time that the requestor spent waiting for access to all resources. This field is set when the contention time and grant time are both non-zero. If the requestor is still waiting at the time of the dump, this field is not set.
  • Movewaiter - Time that a waiting request was moved by the ISGADMIN MOVEWAITER function. See z/OS MVS Programming: Authorized Assembler Services Guide and z/OS MVS Programming: Authorized Assembler Services Reference EDT-IXG for information specific to the ISGADMIN service.
OWN
This indicates that the requester is an owner of this ENQ resource. However, for synchronous RESERVE requests, the I/O for the device RESERVE might not have completed, and the requester might still be waiting.
WAIT
This indicates that the requester is a waiter for the ENQ resource. If this is a reserve request, the hardware reserve is issued after the waiter becomes the owner of the ENQ resource.
USE
This indicates that the requester is a MASID owner of the resource. That is, another requester is the owner and this MASID requester is also allowed to use the resource in the requested state.
The following fields are only displayed when DETAIL is specified:
Caller PSW
Eight-byte Program Status Word (PSW) at the time of SVC or PC interruption on entry into ENQ. Caller PSW contains the return address back to the calling ENQ/ISGENQ/RESERVE program. The PSW address combined with the ASID and requesting TCB address can help identify which program issued this ENQ/ISGENQ/RESERVE request.
Caller TCB
Task control block (TCB) address of the ENQ/ISGENQ/RESERVE issuer, when different from the owning ENQ task. It directed ENQ where the owning task is different from the requesting task.
Request Type
The type of ENQ/ISGENQ/RESERVE linkage specified by the invoker of ENQ. Possible values are LINKAGE=ISGENQ, LINKAGE=SYSTEM, LINKAGE=SVC. For GRS RING mode, two other displays are possible: LINKAGE=SYSTEM (or ISGENQ) or Request created by queue merge processing.
RNL Processing Actions
Displays the RNL processing sequence with respect to this request. Possible values are INCL, INCL EXCL, EXCL, CON, or RNL = NO, where INCL=Promoted to SYSTEMS ENQ by RNL processing, EXCL=Demoted to SYSTEM ENQ by RNL processing, and CON=Converted to SYSTEMS ENQ without a hardware device RESERVE.
Affected by ISGNQXIT/FAST
This request was altered by an ISGNQXIT or ISGNQXITFAST exit routine. See z/OS MVS Installation Exitsfor specific information about these dynamic exit routines.
Affected by ISGNQXITBATCH/CND
This request was altered by an ISGNQXITBATCH or ISGNQXITBATCHCND exit routine. See z/OS MVS Installation Exits for specific information about these dynamic exit routines.
Managed by an Alternate Serialization Product
This request is managed outside the scope of GRS processing by an alternate serialization product.
ISGENQ Userdata
Displays printable hexadecimal digits and the actual EBCDIC text of the ISGENQ Userdata as specified on the ISGENQ REQUEST=OBTAIN macro invocation.
QEL
The address of the queue element (QEL) for the request
QXB
The address of the queue extent block (QXB) for the request
QCB
The address of the queue control block (QCB) for the request
ECB
The address of the event control block (ECB) as specified on an ENQ ECB= or ISGENQ WAITTYPE=ECB invocation
SVRB
The address of the supervisor control block (SVRB) created on entry to the SVC ENQ routine that is ENQ LINKAGE=SVC.
Note: The SVRB is only valid when this ENQ is actively being processed or waited on for contention resolution by GRS.
RB
The address of the request block (RB) that issued the ENQ LINKAGE=SYSTEM or ISGENQ request

The output from VERBEXIT GRSTRACE might also contain the information shown in Figure 1.

Figure 1. Example: VERBEXIT GRSTRACE output - additional information
                    Latch Statistics


   Latch Set Name: LS1.XMITDAT.LATCH.SET

   Creator Jobname: MYJOB1
   Creator ASID: 0024


   Latch Number  | Fast Obtains | Slow Obtains| Ratio (slow/total)
   --------------|--------------|--------------|-------------------
                0            320              1     00.31%
                1        209,989             33     00.02%
                2      5,530,998      3,294,036     37.33% *
                3        611,721         24,967     03.92%
                4        211,574         11,987     05.36% *
   --------------- -------------- -------------- -------------------

   Summary:            6,564,602      3,341,024     33.73% *
     Total number of latches in above latch set: 5
     Number of latches with non-zero statistics: 5


   Latch Set Name: LS2.TRANDAT.LATCH.SET
   Creator Jobname: MYJOB2    Creator ASID: 001D

   Latch Number  | Fast Obtains | Slow Obtains | Ratio (slow/total)
   --------------|--------------|--------------|-------------------
                2          4,357            376     07.94% *
                3         79,551              3     00.00%
                7        549,933             36     00.01%
   --------------- -------------- -------------- -------------------
   Summary:              633,841            415     00.07%
      Total number of latches in above latch set: 8
      Number of latches with non-zero statistics: 3
Latch Set Name
The name that the latch set creator assigned to the latch set displayed in the output.
Note: Latch set names are unique within any given address space. See the documentation provided by the latch creator for more information about the latch set.
Creator Jobname
The name of the job associated with the primary address space where the latch set was created
ASID
The address space identifier (ASID) of the job that was running in the primary address space at the time the latch set was created
Latch number
The number of the latch for which statistics are displayed. See the latch creator documentation as to what this latch is used for.
Fast Obtains
The number of times that tasks or SRB routines called the Latch_Obtain service to obtain a latch when the latch manager granted control of the latch to the requesting task or SRB routine immediately (no contention for the latch existed at the time of the call). The system might display one of the following letters with this number:
G
(giga) - The actual number, when rounded down to a multiple of one billion, is one billion times the number displayed.
K
(kilo) - The actual number, when rounded down to a multiple of one thousand, is one thousand times the number displayed.
M
(mega) - The actual number, when rounded down to a multiple of one million, is one million times the number displayed.
Slow Obtains
The number of times that tasks or SRB routines called the Latch_Obtain service to obtain a latch when the latch manager could not grant control of the latch immediately (contention for the latch existed at the time of the call). The system may display the letter G, K, or M with this number, as described under “Fast Obtains” above.
Ratio
The percentage of the total number of Latch_Obtain requests that are slow obtains.
  • The system rounds the percentage ratio to the nearest hundredth of a percent.
  • The value 00.00 appears in this field if the contention ratio is less than 0.005%.
  • An asterisk follows the contention ratio if it exceeds 5%.
  • The system does not display latches for which the number of slow obtains and the number of fast obtains are both zero.
Summary
A line that displays:
  • The total number of fast and slow obtains; if either of these numbers is too large for the system to display, the summary line contains a message indicating that the data is not available
  • The contention ratio for all latches in the latch set
  • The total number of latches in the latch set
  • The number of latches in the latch set that received at least one obtain request (the number of latches with non-zero statistics).
The system might display one of the following letters with the listed numbers:
G
(giga) - The actual number, when rounded down to a multiple of one billion, is one billion times the number displayed.
K
(kilo) - The actual number, when rounded down to a multiple of one thousand, is one thousand times the number displayed.
M
(mega) - The actual number, when rounded down to a multiple of one million, is one million times the number displayed.

An asterisk follows the summary contention ratio if it exceeds 5%.

Note: If the counters in the display of latch statistics wrap, the statistics are not meaningful. When testing your application, you can obtain meaningful statistics by dumping the application's address space periodically (before the latch statistics wrap).