When the CICS® Configuration Manager server starts, it looks in the repository for a system options record. Among other data, this record specifies:
Before starting the server, you need to initialize the repository by creating this system options record and supplying initial values for the system options.
Edit and submit the JCL in the following member of the sample library SCCVSAMP:
The system options are represented in the member by the following parameters:
XFACILIT is the default value for
both of these system options. If you decide to use a different resource
class, see Requirements for a resource class for security checking.
The values of SAFClass and its related
option SAFPrefix are only used when CICS Configuration Manager security checking
for server API commands and CICS region security checking are both active (system option SecurityActive=Y
and SIT parameter SEC=YES).
The values of ObjectSAFClass
and its related option ObjectSAFPrefix are only used when CICS Configuration Manager security checking
for resource definition keys and CICS region security checking are both active (system option
ObjectSecurityActive=Y and SIT parameter SEC=YES).
For more information about CICS Configuration Manager security checking,
see Restricting access to API commands and resource definitions.
For details on the format of these security keys, see Security keys for API commands.
For details on the format of these security keys, see Security keys for resource definitions.
The 1- to 8-character name of the local CMAS that manages the MAS in which the CICS Configuration Manager server runs. Typically, this CMAS would be a maintenance point (MP), but this is not a requirement. (For details on MP locations, see Location of maintenance point CMAS.)
This name must match the CICSPlex SM system parameter NAME of the local CMAS (specified in the extrapartition transient data queue COPR, ddname EYUPARM).
Furthermore, the CICSPlex SM system parameter CMASSYSID of the MAS must match the SYSID of the local CMAS.
The following figure illustrates these values and their relationships:
The CICS Configuration Manager server uses this CMAS name to send requests to the CICSPlex SM API.
If these values are inconsistent, then, when CICS Configuration Manager attempts to send a CICSPlex API request to the CMAS, CICSPlex SM responds with an exception: return code 1028 (INVALIDPARM), reason code 1282 (CONTEXT).
If you decide not to specify a particular port type, then delete the associated parameters from the JCL.
You cannot share port numbers between port types. Ask your network administrator for spare port numbers that you can allocate to CICS Configuration Manager.
The port "names" are the names of the TCPIPSERVICE resource definitions that the CICS Configuration Manager server dynamically defines for each port when the server initializes. (You do not need to define these resource definitions statically in the CSD file.) The default names for the unauthenticated, authenticated, and SSL ports are CCVNONE, CCVBASIC, and CCVSSL, respectively. If you specify a port number without a name, then the port is defined with the default name. However, if you specify a port name without a number, then the name is ignored, and the port is not defined.
Proxy servers not supported: You might not be able to connect to a CICS Configuration Manager server via a proxy server.
Changing system options after installation
To change the system options for the CICS Configuration Manager server IP address, ports, or CICSPlex SM MP name after installing CICS Configuration Manager:
CEMT SET FILE(CCVDDD) CLO
Running this job overwrites all CICS Configuration Manager system options, not just the system options for the parameters that you specify in the job. If you re-run this job, specify all parameters again, not just the ones you want to change. Before re-running the job, use CICS Configuration Manager ISPF dialog option 1.1 System Options to view current system option values.
To change all other system options, you can use the CICS Configuration Manager ISPF dialog option 1.1 System Options.