INGPLEX CDS

Purpose

The CDS function displays information about all the couple data sets in the system, including details of the corresponding policies. For every CDS type that is required by the implementation INGPLEX CDS allows the operator to:
  • Switch from the primary to the alternate CDS
  • Define a new alternate CDS
  • Change the active policy (if applicable)

Actions are started by specifying an action code for a selected CDS type on the panel.

Actions

The possible action codes are:

*A: Allocate alternate CDS
Replaces the current alternate CDS for a selected CDS type with a new one. There are two options how to do this:
  • The alternate CDS is allocated automatically by SA z/OS.

    This automatic allocation requires that spare volumes have been defined, and that one of these spare volumes is available.

  • Specify the data set that is to be used as the new alternate CDS.

    If you specify your own data set, observe the following:

    • The data set must exist
    • It must have been formatted with the XCF formatting tool
    • It must be at least as large as the current primary CDS, which means that every value you have passed to the XCF formatting tool (for example, in the case of a sysplex CDS, the maximum number of systems supported) must be equal to or greater than the corresponding value of the primary CDS.
C: Display CHPIDs
Displays information about the channel paths for the selected CDS type.
D: Display CDS information
Displays detail information about the selected CDS type. This comprises the formatting parameters and the policies that are contained in the CDS, if applicable. When the CDSs of the selected type contain policies, the detail information panel provides further actions:
D: Display policy
Displays details about the selected policy.
S: Start policy
Makes the selected policy the active policy.

The policy switch must be confirmed before it is executed.

*P: Switch alternate CDS to primary CDS
Makes the alternate CDS the primary one. Because an alternate CDS is no longer available after the switch, SA z/OS shows a confirmation panel before the action is performed. On the panel, you can specify a new alternate CDS. When CDS recovery is switched on and you do not supply your own alternate CDS, SA z/OS tries to allocate a new alternate CDS automatically. The special requirements for manual and automatic creation of the new alternate CDS are the same as those for the replacement of the alternate CDS (action code A).

Examples

The following example illustrates the switch from the primary to the alternate CDS.

The following examples start with issuing INGPLEX CDS and pressing F8 on the CDS command dialog to scroll down the CDS list. The panel shown in Figure 1 is displayed.

Figure 1. INGPLEX CDS Command Dialog Panel
 INGKX300                  SA z/OS  - Command Dialogs       Line  13   of 21
 Domain Id . : IPSFP   ---------- INGPLEX CDS -----------   Date . . : 01/26/18
 Operator Id : NETOP1          Sysplex = KEY1PLEX           Time . . : 09:03:52

 SAplex  . . . . . ==> KEY4PLEX________  COUPLExx . . . . . : COUPLESY
 Interval  . . . . . : 900               OPNotify . . . . . : 900
 Maxmsg  . . . . . . : 99999             Cleanup  . . . . . : 30
 Retry . . . . . . . : 255               Classlen . . . . . : 956
 Max CFlevel . . . . : 20                Max SMlevel  . . . : 20
 SMREBLD . . . . . . : 1
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

 Cmds: A allocate alternate CDS  / C display CHPIDs
       D display CDS information / P switch alternate CDS to primary CDS

     Type        MS   Volume  Dev   Couple Dataset Name
     --------    --   ------  ----  --------------------------------------------
  _  LOGR
      PRIMARY..: 32   KEY1XP  483D  SYS1.KEY1PLEX.PLOGCDS
      ALTERNATE: 32   KEY1XA  583D  SYS1.KEY1PLEX.ALOGCDS
  _  SFM

 Command ===>
 F1=Help      F2=End       F3=Return                              F6=Roll
 F7=Backward  F8=Forward   F9=Refresh                            F12=Retrieve

The panel header contains sysplex-related information about the system that the INGPLEX command was executed on. The details are as follows:

  • The System field shows the name of the system.
  • The Interval field shows the system failure detection interval in seconds. This interval is the amount of time XCF lets elapse without a status update before assuming that the system failed.
  • The OPNotify field shows the number of seconds that XCF waits before notifying the operator of a potential system problem.
  • The Maxmsg field shows the default value for the maximum amount of kilobytes of message buffer space. This default value is used when MAXMSG is not specified on SETXCF START commands.
  • The Cleanup field shows the number of seconds that XCF waits for cleanup of members.
  • The Retry field shows the default value for the retry limit. This value is used when the RETRY keyword is not specified on SETXCF START commands.
  • The Classlen field shows the default length (in bytes) of messages allowed for a transport class. This value is used when CLASSLEN is not specified on the SETXCF START CLASSDEF command.
  • The Max CFlevel field shows the maximum CFLEVEL supported by this system. This system can connect to a coupling facility with a higher CFLEVEL than the value of Max CFlevel but would not be enabled to use any functions supported by the higher level coupling facility.
  • The COUPLExx field shows the COUPLExx Parmlib member used for system IPL.
  • The SMRBLD field shows whether (value 1) or not (value 0) system-managed rebuild has been activated in the CFRM couple data set.
  • The Max SMlevel field shows the maximum system-managed process level supported by this system.

The main part of the screen shows information about the primary and alternate CDSs for every CDS type. Press F8 to scroll and display further entries. The MS field shows the maximum number of systems that are supported by the CDS.