z/OS DFSMS Managing Catalogs
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Operational Considerations

z/OS DFSMS Managing Catalogs
SC23-6853-00

Start of change
Although a catalog's VSAM share options are ignored when it is in RLS mode, they are still used when the catalog is quiesced from RLS use. Therefore, it is necessary to ensure that correct share options are specified. For example, a catalog to be shared across the sysplex in RLS mode needs to be defined with SHAREOPTIONS(3 4) so that it can continue to be shared across the sysplex correctly if it is ever switched out of RLS mode and back to either ECS mode or VVDS mode.
  • It is recommended that prior to enabling catalogs in RLS mode, all systems in the sysplex (including pre z/OS® 2.1 systems) have enabled SMSVSAM. The SMSVAM address space must be available in a fallback situation in order to switch catalogs out of RLS mode. It is also recommended that all systems in the sysplex have migrated to z/OS 2.1 prior to implementing RLS for Catalog to prevent accidentally accessing a catalog from a release that does not support RLS mode. If a system that does not support RLS for catalogs must remain in the sysplex, be aware that if a catalog in RLS mode is ever RLS-quiesced for any reason, the non-RLS system could start accessing the catalog in either ECS or VVDS mode. In this case, you will need to explicitly close the catalog from the non-RLS system before enabling the catalog back to RLS mode.
  • It is necessary to stop RLS mode for a catalog if access is needed by a system that does not support the RLS protocol. This can be temporarily accomplished by using the MODIFY CATALOG,RLSQUIESCE(catname) command. This does not nullify the LOG parameter, but does remove the catalog from RLS mode on all systems. It can only be returned to RLS mode by issuing a MODIFY CATALOG,RLSENABLE(catname) command. To switch all catalogs used by this system from RLS to non-RLS mode, issue MODIFY CATALOG,RLSQUIESCE,SYSTEM. To switch all RLS-eligible catalogs from non-RLS back to RLS mode, issue MODIFY CATALOG,RLSENABLE,SYSTEM.
  • The RLSENABLE and RLSQUIESCE interfaces are intended for you to enable your catalogs to RLS mode and only fallback to non-RLS mode during an emergency. They are not intended to be used to switch a catalog back and forth between RLS and non-RLS on a regular basis.
  • It is recommended that you dedicate a separate CF cache structure and lock structure for any catalog in RLS mode for better performance and failure isolation.
  • To protect catalog’s integrity, the SYSIGGV2 BCS resource will be held share by each SMSVSAM address space while a catalog is opened for RLS access. This is done to ensure that applications that explicitly raise the ENQ exclusive in order to have the exclusive access to the catalog can no longer do so. The SYSIGGV2 BCS resource will be released when the catalog is closed for RLS access.
  • If you plan to terminate the SMSVSAM address space for a long time, and your catalog requests cannot tolerate the prolonged down time, consider quiescing the catalogs from the RLS access before terminating the SMSVSAM address space. Otherwise, if the SMSVSAM address space is down, an IEC365D message will be displayed on the console to indicate that some catalog requests are still waiting for the SMSVSAM address space to be available. The catalog requests will be waiting on SYSZIGG5 BCS ENQ in the user’s address space as long as the SMSVSAM is not available. You may decide to ignore the message if the SMSVSAM address space is going to be available soon, or issue RLSQUIESCE to switch all catalogs used by this system out of RLS mode. In this case once the SMSVSAM address space is available, you may issue MODIFY, CATALOG,RLSENABLE,SYSTEM to switch all RLS-eligible catalogs back to RLS mode.
  • During a catalog hang, it is essential to capture the dumps from CAS, SMSVSAM, and MASTER address spaces from all systems in the sysplex. Simply issue MODIFY CATALOG,TAKEDUMP(SYSPLEX) to capture all dumps. You may need to increase your dump data sets to accommodate the addition of dumps from the SMSVSAM address space and its dataspaces, especially if there are buffers placed above the bar.
  • To identify which job(s) may be contributing to a catalog hang, use the combinations of the following console commands:
    MODIFY CATALOG,LIST 
    DISPLAY GRS,C 
    DISPLAY SMS,SMSVSAM,DIAG(CONTENTION)
    If a diagnosis is impossible, restart both the CAS and SMSVSAM address space from all involved systems.
  • Start of change Although a catalog's VSAM share options are ignored when it is in RLS mode, they are still used when the catalog is quiesced from RLS use. Therefore, it is necessary to ensure that correct share options are specified. For example, a catalog to be shared across the sysplex in RLS mode needs to be defined with SHAREOPTIONS(3 4) so that it can continue to be shared across the sysplex correctly if it is ever switched out of RLS mode and back to either ECS mode or VVDS mode. End of change
End of change

Go to the previous page




Copyright IBM Corporation 1990, 2014