VERBEXIT GRSTRACE subcommand — format Global Resource Serialization data

Specify the GRSTRACE, QCBTRACE, or Q verb name on the VERBEXIT subcommand to format diagnostic data from the major control blocks for global resource serialization.

Syntax

  VERBEXIT GRSTRACE [ 'parameter [,parameter]...' ]

The parameters are:

     Data Selection Parameters:

                [DETAIL]
                [SUMMARY]
                
     Time format Parameters:

                [TIME(LOCAL|GMT|UTC)] 

     Additional Filter Parameters:

                [START(mm/dd/yy,hh.mm.ss.dddddd)]
                [STOP(mm/dd/yy,hh.mm.ss.dddddd)]
                [SYSNAME(sysname)]                            
                [QNAME(qname)]                                
                [RNAME(rname)]                                
                [STEP] [ SYSTEM] [ SYSTEMS]
                [JOBNAME(jobname)]                            
                [ASID(asid)]                                  
                [TCB(tcb)]                                    
                [RESERVE]
                [CONTENTION]   

     SETDEF-Defined Parameters:
        Note: You can override the following SETDEF parameters.         
                                                                                    
                [DSNAME(dsname) | DATASET(dsname) ]                
                [FILE(ddname) | DDNAME(ddname)    ]                
                [PATH(path-name)     ]                             
                [FLAG(severity)]                            
                [PRINT | NOPRINT]                             
                [TERMINAL | NOTERMINAL]                       
                [TEST | NOTEST]

Data Selection Parameters
DETAIL

Provides a detailed GRSTRACE report. The detailed report contains ENQ diagnostic data in addition to all the important ENQ context information that the summary report displays.

SUMMARY

Provides a summary GRSTRACE report. The summary report contains all the relevant context information such as QName, RName, Sysname, Scope, Jobname, Asid, Tcb, Disposition, ownership status, wait and grant times. SUMMARY is the default.
Time format Parameters
TIME(LOCAL|GMT|UTC)
Specifies the time format to use for the GRSTRACE report.
- LOCAL: All ENQ relevant times should be formatted in local time.
- GMT: All ENQ relevant times should be formatted in GMT time.
- UTC: All ENQ relevant times should be formatted in UTC time. This is the exact store clock timestamp.
Additional Filter Parameters
Use these parameters to limit the scope of the data in the report. If no data selection parameter is selected, the default is NO FILTERING. At least one requestor in a resource chain must match all of the filtering options in order for a resource to be displayed. Wildcard values are allowed for the SYSNAME, JOBNAME, QNAME, and RNAME filters. Use * to match zero or more characters and ? for exactly one character. See here for an example.
START(mm/dd/yy,hh.mm.ss.dddddd)
Specifies the date and time used to display ENQ resources with requests that occurred at or after this time. The time format must match the time format specified with the TIME keyword. When you do not specify START, IPCS starts with the oldest ENQ request. Specify the date and time in mm/dd/yy,hh.mm.ss.dddddd format.
Note: The following rules apply to the date and time specifications:
The month and day can be specified in single or double digits.

Separate the date from the time with a comma.

The time can be local, by default or specified in a TIME(Local) parameter, or GMT or UTC, if specified in a Time(GMT) or Time(UTC) parameter.

Hours, minutes, and seconds can be specified in single or double digits.

The time can be truncated anywhere on the right.

The time can be left off completely, in which case, it defaults to 00:00:00.000000 (midnight).
STOP(mm/dd/yy,hh.mm.ss.dddddd)

Specifies the date and time used to display ENQ resources with requests that occurred up to or before this time. The time format must match the time format specified with the TIME keyword. When you do not specify STOP, IPCS ends with the newest ENQ request.
See the START parameter for guidelines on how to specify the time and date.

SYSNAME(sysname)

Displays all ENQ resources with the given specified system name. Note in GRS=STAR, resource requests from other systems are not maintained in local storage. Thus, a query specifying another system name may only receive data back from GRSDATA, not GRSTRACE.

QNAME(qname)

Displays all ENQ resources with the specified QNAME (major name).

RNAME(rname)

Displays all ENQ resources with the specified RNAME (minor name).

[STEP] [ SYSTEM] [ SYSTEMS]

Displays all ENQ resources with a scope of STEP, SYSTEM, or SYSTEMS.

JOBNAME(jobname)

Displays all ENQ resources associated with the specified job name.

ASID(asid)

Displays all ENQ resources associated with the specified address space ID.

TCB(tcb)

Displays all ENQ resources associated with the specified task

RESERVE

Displays only RESERVE requests that have not been converted to global ENQs.

CONTENTION

Displays only ENQ resources that are in ENQ contention. Device RESERVE contention is not taken into consideration.
Example: Match any resource requests that have the following:
- A QNAME starting with SYS, followed by zero or more characters until an R is found, followed by two specific characters and ending in an F (for example, SYSZRACF)
- RNAME is SOMESPECIFICRNAME
- SCOPE=SYSTEMS
- JOBNAME starts with DB2®
- Action
```
	IP VERBX GRSTRACE ‘QNAME(SYS*R??F) RNAME(SOMESPECIFICRNAME) 
    SYSTEMS JOBNAME(DB2*)’      
```
- Result
  For an example of GRSTRACE output, see the global serialization resource component in z/OS MVS Diagnosis: Reference.