Default language.

SENQ


SENQ
[TYPE=S|D|A|E]
[,RESOURCE=(majorName|(majorName,minorName)]
[,SYSNAME=sysname]

OverviewThis control statement collects data on all enqueue conflicts or the status of enqueues for specific resources. The default is to record detail information for all resources experiencing contention. Data is recorded in SMF79 subtype 7 records.

The data collected reflects the resource contention at the time the record is created. Contention that occurs solely between recording intervals is not recorded.

Parameters

This statement has the following parameters:

TYPE

specifies the enqueue activity to measure and the level of detail recorded

Possible values are as follows:

  • S
    collects summary data for the resource specified on the RESOURCE parameter
    If the RESOURCE parameter is omitted, data is collected for all resources experiencing contention.
    For each resource, the following information is recorded:
    • resource major and minor name
    • scope of the enqueue
    • number of tasks that own the resource
    • number of tasks awaiting exclusive ownership of the resource
    • number of tasks awaiting shared use of the resource
  • D
    collects detail data for the resource specified on the RESOURCE parameter
    If the RESOURCE parameter is omitted, data is collected for all resources experiencing contention.
    For each resource, the following information is recorded:
    • resource major and minor name
    • scope of the enqueue
    • name of each job that either owns or awaits use of the resource
  • A
    collects data on all resources held by jobs on the system specified on the SYSNAME parameter
  • E
    collects data on all resources held exclusively by jobs on the system specified on the SYSNAME parameter

RESOURCE

specifies the resources for which summary or detail data is collected

This parameter is valid only when TYPE=S or TYPE=D. The maximum length of majorName is 8. The maximum length of minorName is 44.

Specify majorName alone to record all contention for a given majorName (Qname). Specify both majorName and minorName to record contention for a specific majorName/minorname (Qname/Rname) combination.

When both majorName and minorName are specified, they must be enclosed in parentheses.

SYSNAME

specifies the system for which data is collected when TYPE=A or E

Examples

SENQ TYPE=A,SYSTEM=SYSB

Data is collected for all resources held by SYSB.

SENQ TYPE=D,RESOURCE=(SYSDSN,LGS3.CNTL)

Detail data is collected on contention experienced by the data set LGS3.CNTL.




 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Ops Monitor for CMF 6.4