What can prevent a switch to non-RLS access mode?

You cannot open a data set in non-RLS access mode if there are any ACBs open against it in RLS access mode.

To switch from RLS to non-RLS access mode, first ensure that all files that are open against the data set are closed. You can use the quiesce function for this purpose. As discussed in Quiescing RLS data sets, the VSAM RLS quiesce mechanism causes each CICS region in the sysplex to close any RLS ACBs that are open against a specified data set. Once closed under the quiesce mechanism, data sets can only be opened in non-RLS mode. To re-enable quiesced data sets to be reopened in RLS mode, all open non-RLS ACBs must be closed and then the data sets must be unquiesced.

The quiesce mechanism cannot inform batch programs that have the data set open in RLS access mode about the quiesce request. If you have such programs, use the access method services SHCDS LIST subcommand to check whether any non-CICS jobs have ACBs open in RLS mode against the data set. For information about the SHCDS LIST subcommand, see z/OS DFSMS: Access Method Services for ICF.

Quiescing a data set sets the quiesce flag in the ICF catalog so that the data set can be opened in non-RLS mode only. This way of making data sets available for batch programs without having to shut down all the CICS regions is particularly suited to the Parallel Sysplex® environment. Note that if you do shut CICS regions down, it is best to avoid immediate shutdowns when you have not specified a shutdown transaction, because this could cause large numbers of locks to be retained. A shutdown transaction can enable you to perform a quick but controlled shutdown.

Even if a data set has been quiesced, you still cannot open it for update in non-RLS access mode if SMSVSAM is holding retained locks against the data set. This is because the locks are needed to preserve data integrity: they protect changes that are waiting to be either committed or backed out. It is possible to open a data set for input (read-only) in non-RLS mode even when there are retained locks, because a reader cannot corrupt the data integrity that such locks are preserving. Note that, when you are opening a data set in a batch job, there cannot be any active locks because, when an ACB is closed, any active locks are converted automatically into retained locks.

The remainder of this topic on switching to non-RLS access mode describes the options that are available if you need to switch to non-RLS mode and are prevented from doing so by retained locks.



dfht2c00215.html | Timestamp icon Last updated: Monday, 5 June 2017