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
- 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.
- 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.
- 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.
- 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.