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 sample shows the defaults for customizable values for this check. Use this sample to make permanent check customizations in an HZSPRMxx parmlib member used at IBM Health Checker for z/OS startup. If you just want a one-time only update to the check defaults, omit the first line (ADDREPLACE POLICY) and use the UPDATE statement on a MODIFY hzsproc command. Note that using non-POLICY UPDATEs in HZSPRMxx can lead to unexpected results and is therefore not recommended. End of change

ADDREPLACE POLICY[(policyname)] [STATEMENT(name)]
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.