IGWRH0131E
False lock contention has been detected. The current false contention rate is FCRate.FCFrac%.

Explanation

Check (VSAMRLS_CFLS_FALSE_CONTENTION_RATE) found that the system may experience performance degradation because the current false contention rate has exceeded the health check's false contention rate threshold of ThRate.ThFrac%

In the message text:
FCRate.FCFrac
The false lock contention rate.

VSAM RLS assigns locked resources to an entry value in the lock table, and uses this entry value to quickly check whether a resource is already locked. If the lock structure (and thus the lock table) is too small, many locks can be represented by a single value, making 'false' lock contention possible. False lock contention occurs when two different locks on different resources attempt to use the same lock entry. The second lock requester is suspended until VSAM RLS determines that there is no real lock contention on the resource. False contention can be a problem for workloads with heavy R/W interests among systems.

For the best performance, you want to achieve the least possible amount of global lock contention, both real and false. The amount of real lock contention is application-dependent; it depends on record access patterns. False lock contention is almost entirely determined by the size of the lock table, with a larger lock table having less false lock contention than a smaller one. A good goal is to have total (real and false) global lock contention of less than one percent. Start of changeThe false contention component of the total global lock contention should be less than five percent, and ideally, should be substantially less than this. The documentation references one half of one percent as the false contention rate to be aware of. However, in some scenarios, a false contention rate of more than one half of one percent may be normal and will not cause performance degradation.End of change

Start of changeThRate.ThFracEnd of change
Start of changeThe false lock contention rate threshold.End of change

System action

The system continues processing.

System programmer response

If false contention becomes a problem, try the following ways:
  • If possible, reduce the amount of real lock contention in your applications.
  • Specify a larger size for the lock structure and manually rebuild it.
  • Ensure that the MAXSYSTEM parameter of the couple data set utility is not too large for the number of members in the parallel sysplex.

Problem determination

You can determine the amount of false contention by using either the resource measurement facility (RMF™) or the DISPLAY SMS,CFLS command.

Source

DFSMS VSAM RLS

Module

IGWRDLSC

Routing code

See note 35.

Descriptor code

3 is the default set by this check. See note 1.

Reference Documentation

For additional information, see "Defining the CF Lock Structure" in z/OS DFSMSdfp Storage Administration.