VSAMRLS_DIAG_CONTENTION

Description:

Checks for VSAM RLS contention by looking at registered resources. Check displays a contention table if detected.

Reason for check:

IBM® recommends monitoring VSAM RLS contention.

z/OS® releases the check applies to:

z/OS V1R8 and up.

Type of check (local or remote):

Local

User override of IBM values:

The following shows the default keywords for the check, which you can override on either a POLICY statement in the HZSPRMxx parmlib member or on a MODIFY command. This statement may be copied and modified to override the check defaults:

UPDATE CHECK(IBMVSAMRLS,VSAMRLS_DIAG_CONTENTION)                      
       SEVERITY(HI)                                                          
       INTERVAL(00:05)                                                       
       DATE('date_of_the_change')
       PARMS('ROWS(20),FILTER(0)')                                           
       REASON('Your reason for making the update.')

Debug support:

Verbose support:

Parameters accepted:

Yes:

PARM(ROWS): Specify an integer, minimum 1, indicating the maximum number of rows to be displayed in the contention table.
PARM(FILTER): Specify an integer from 0 to 3600 to filter out rows in the contention table with an elapsed time of 0-3600 seconds, leaving only the rows which have a TIME value (in seconds) greater than or equal to the FILTER value specified.
Note that the system looks at the ROWS parameter before the FILTER parameter, so the FILTER value will only be in effect on the number of rows specified in the ROWS parameter. So, if there were 500 rows and the ROWS value is 200, it will show at most 200 rows in the contention table.
A value of 0 disables the filter, and a value of 1 filters out all rows with an elapsed time of 0 seconds.

Reference:

For additional information see VSAM RLS Latch Contention in z/OS DFSMSdfp Diagnosis.

Messages:

This check issues the following exception messages:

IGWRH0102E

See the IGWRH messages in z/OS MVS System Messages, Vol 9 (IGF-IWM).

SECLABEL recommended for multilevel security users:

SYSLOW - see z/OS Planning for Multilevel Security and the Common Criteria for information on using SECLABELs.