Edit CICS system initialization parameters

  1. Specify the following CICS® system initialization (SIT) parameters:
    CPSMCONN=LMAS
    Only required if your system uses CICSPlex® SM. Specifies that you want CICS to initialize the region as a CICSPlex SM locally managed application system (LMAS) connected to the maintenance point CMAS.

    If you are installing CICS Configuration Manager into an existing CICSPlex SM WUI region, then do not alter the existing specification of CPSMCONN=WUI.

    CSDACC=READWRITE
    Required.
    CSDDISP
    Required. You must specify this parameter and the related CSDDSN parameter. Whether you specify CSDDISP=OLD or CSDDISP=SHR depends on your site-specific requirements.
    CSDDSN=name
    You must specify the CSD file via the SIT parameter CSDDSN, not via the ddname DFHCSD in the CICS region startup JCL.

    The CICS Configuration Manager server dynamically modifies the DFHCSD data set name each time it needs to access a CSD file. Specifying the ddname in JCL prevents the server from dynamically allocating the ddname, and causes the CICS Configuration Manager server to report an error.

    CSDLSRNO=value
    The values of CSDLSRNO that you can specify depends on the release of CICS Transaction Server that runs the CICS Configuration Manager server region:
    • V3.2, or earlier: you can specify any value allowed by CSDLSRNO
    • From V4.1: you can specify any value allowed by CSDLSRNO, with the following exception: if you specify the SIT parameter TRANISO=YES, then you cannot specify CSDLSRNO=NONE
    CSDRLS=YES or NO
    No restriction on this value. This value has no effect on whether CICS Configuration Manager uses VSAM record-level sharing (RLS) mode to access other CSD files.

    After completing installation, if you define a CICS configuration that refers to this CSD file (so that you can use CICS Configuration Manager to manage its resource definitions), then, as for any CICS configuration that refers to a CSD file, you must specify an appropriate RLS access option. For details, see Defining CICS configurations that refer to CSD files.

    See also the related RLS parameter.

    ENCRYPTION=STRONG (recommended)
    When saving to a CSD file resource definitions that contain cipher codes (such as URIMAP and TCPIPSERVICE), CICS restricts the set of cipher-code hex pairs to the set of values consistent with the CICS region's ENCRYPTION parameter value:
    • The CICS Configuration Manager server must use an ENCRYPTION value that is equal to or higher than the highest level of any encryption required by the CICS-CSD or CICSPlex SM systems that the server manages.
    • It is recommended that the CICS Configuration Manager server specifies ENCRYPTION=STRONG, so that it can save any of the permissible (valid) cipher values for URIMAP or TCPIPSERVICE.
    GRPLIST=lists
    One of the lists specified by this parameter must be the list to which you added the group CCV510, in Define CICS resources.
    ICVR
    The CICS Configuration Manager server uses CICS file control mass delete (delete with generic key) to purge data from its work files. When processing very large data requests, this delete operation might exceed the CICS region's ICVR (default runaway task time) limit, resulting in a task abend for the CWBA CICS Web support transaction. These errors might appear as an ASP9 abend in the MSGUSR output data set of the CICS region. If these conditions occur, increase the CICS region's ICVR value.
    KEYRING=keyring
    Only required if you want the CICS Configuration Manager server and its client to communicate via a port that uses the secure sockets layer (SSL).
    PLTPI=xx
    If you updated the PLTPI: ensure that this parameter refers to the suffix of the PLTPI that you updated or created earlier for the program CCVIINIT, in Optional: Update the PLTPI.
    RLS=YES or NO
    If you specified CSDRLS=YES, or you want CICS Configuration Manager to access CSD files using RLS, then specify RLS=YES.

    Even if you specified CSDRLS=NO for this CICS region, if you want CICS Configuration Manager to access the CSD files for other CICS regions using RLS, then specify RLS=YES.

    RRMS=YES
    Required by the CICS Configuration Manager journal housekeeping batch program.

    To run the journal housekeeping batch program, in addition to specifying this parameter, you also need to ensure that the Resource Recovery Services (RRS) are running on the MVS™ system that hosts this CICS region. For more information on the journal housekeeping batch program, see Unloading and loading journal records.

    SEC=YES or NO
    If you want to authenticate CICS Configuration Manager users, and be able to restrict user access to API commands and resource definitions, then SEC=YES is required. For details, see Authenticating the client user and Restricting access to API commands and resource definitions.
    SSL-related parameters
    If you want the CICS Configuration Manager server to listen for clients on an SSL port, then you must specify various SSL-related parameters.

    CICS Configuration Manager has the following specific requirements for SSL-related parameters, depending on the release of CICS Transaction Server that runs the CICS Configuration Manager server region:

    • V2.3, or earlier: specify SSLTCBS=2 or greater. (SSLTCBS is obsolete in later releases.)
    • V3.1, or later: either do not specify MAXSSLTCBS (to use the default value of 8), or specify MAXSSLTCBS=8 or greater.

    For more information on SSL-related parameters, see the CICS documentation.

    TCPIP=YES
    Activates CICS TCP/IP services. These services are required for CICS Web support, which the CICS Configuration Manager server uses to communicate with clients.
  2. (Optional.) If you want to use the CICS Configuration Manager agent to perform actions on active CSD-based CICS regions, then specify the following CICS system initialization parameters:
    • VTAM=YES
    • IRCSTRT=YES
    • ISC=YES

    These parameters are required for the MRO or ISC links that allow the CICS Configuration Manager server to communicate with agents. Other steps for configuring for the agent are described later, in Optional: Configure the agent for CSD-based CICS regions.


Information Information

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//ccv-install-sit.htm