Configure CICS DA

You must configure the CICS® DA server properties file, the CICS DA environment variable file, the CICS DA template files, and the CICS DA server start procedure. Sample files are provided during the product installation in the z/OS® UNIX directory /usr/lpp/cicsda/v530 that was created during the SMP/E process, and these files can be tailored for your environment.

It is good practice to copy the sample files and place them in a different location before you change them. You can choose to save the server properties, environment variables, and template files anywhere in your z/OS UNIX file system. However, a practical solution might be to create a directory in the same folder you created for the server files. That way, all files are in the same place.

Before you begin

If you want to configure the CICS DA server to use SSL security, you must first set up the Java™ keystore. The location of the Java keystore is required when you configure the CICS DA environment variables in step 2.

Procedure

  1. Configure the CICS DA properties.

    The CICS DA properties file contains the properties for the CICS DA V5.3 server process. A sample file, cphprops is provided in the z/OS UNIX directory /usr/lpp/cicsda/v530/samples/ that was created during the SMP/E process. The comments in the sample cphprops file provide details of the properties that must be set.

  2. Configure the CICS DA environment variables.

    The CICS DA environment variable file contains the environment variables for the CICS DA V5.3 server process, including the variables for using SSL security. A sample file, cphenvar, is provided in the z/OS UNIX directory /usr/lpp/cicsda/v530/samples/ that was created during the SMP/E process. The comments in the sample file provide details of the environment variables that must be set.

    Note: The environment variable CPH_USER defines the location of the CICS DA server workspace. The server workspace contains the system model. If the model becomes corrupted, any start policies, stop policies, or tags that you added to the model might be lost. You should back up the workspace regularly. The workspace is in the path /workspace/ defined by the environment variable.
  3. Configure the CICS DA template files.

    The CICS DA template files are used when you create a CICSplex maintenance facility. A CICSplex maintenance facility consists of a new CMAS and WUI server. CICS DA creates these linked CICS regions by using the parameters and definitions in the template files. You must tailor the templates for your organization.

    The templates are in the z/OS UNIX directory /usr/lpp/cicsda/v530/templates/ that was created during the SMP/E process. There are three templates for each version of CICS that you can create: CICS TS version 5.3, CICS TS version 5.2, CICS TS version 5.1, CICS TS version 4.2, CICS TS version 4.1. You must edit each of the templates for the version of CICS that you want to use, and supply the required information as directed by the comments in the files. The templates are as follows:

    • CMAS410.xml - Template that is used to create a CICS TS V4.1 CMAS
    • CMAS420.xml - Template that is used to create a CICS TS V4.2 CMAS
    • CMAS510.xml - Template that is used to create a CICS TS V5.1 CMAS
    • CMAS520.xml - Template that is used to create a CICS TS V5.2 CMAS
    • CMAS530.xml - Template that is used to create a CICS TS V5.3 CMAS
    • WUI410.xml - Template that is used to create a CICS TS V4.1 WUI server
    • WUI420.xml - Template that is used to create a CICS TS V4.2 WUI server
    • WUI510.xml - Template that is used to create a CICS TS V5.1 WUI server
    • WUI520.xml - Template that is used to create a CICS TS V5.2 WUI server
    • WUI530.xml - Template that is used to create a CICS TS V5.3 WUI server
    • MF410.xml - Template that is used to create a CICS TS V4.1 maintenance facility
    • MF420.xml - Template that is used to create a CICS TS V4.2 maintenance facility
    • MF510.xml - Template that is used to create a CICS TS V5.1 maintenance facility
    • MF520.xml - Template that is used to create a CICS TS V5.2 maintenance facility
    • MF530.xml - Template that is used to create a CICS TS V5.3 maintenance facility
    Note: If an update is required to the management facility templates while the server is running, the server must be restarted before the changes take effect.

  4. Configure the JCL procedure that starts the CICS DA server.

    The JCL procedure CPHOESVR starts the CICS DA server. The procedure is a member in the SCPHINST library in the data set where CICS DA is installed during the SMP/E installation. The comments in the sample file provide details of the variables that must be set.

What to do next

Complete the remaining tasks to configure CICS DA. For more information, see the related tasks.


configure_cicsda.html | Timestamp icon Last updated: Friday, 11 December 2015