Setting up CMCI with CICSPlex SM

Planning for CMCI setup

1. For high availability, you can have multiple CICSPlex SM WUI regions.
2. To use enhanced client authentication in the CMCI such as multifactor authentication (MFA), the CMCI GraphQL API, or the CICS bundle deployment API (extra configuration needed), you must use the CMCI JVM server with the CMCI.
   Note: In CICSPlex SM, the CMCI uses the CMCI JVM server by default, as described in this CMCI configuration procedure. If you do not want to use the CMCI JVM server with the CMCI, it's possible to set the feature toggle com.ibm.cics.cmci.jvmserver=false to switch off the CMCI JVM server and use the instructions in Setting up CMCI with CICSPlex SM in the CICS TS 5.4 product information to set up the basic CMCI. However, this feature toggle will be removed in a future release of CICS TS; therefore, you are strongly encouraged to upgrade to the CMCI JVM server as soon as possible.
3. Estimate storage requirements for the CMCI.

   Estimate storage requirements for the CMCI.

   You can use the following values as an initial estimate for 24-bit and 31-bit storage:

   • 24-bit storage: 512 KB
   • 31-bit storage: 100 MB

   This is because the supplied JVM profile disables the use of the shared library region, which reduces the amount of non-CICS 31-bit storage required. By default, the JVMSERVER resource that is automatically created for the CMCI JVM server has a value of 15 for the THREADLIMIT attribute. As the workload changes, for example, if you change the number of threads, you need to recalculate the storage requirements as described in Calculating storage requirements for JVM servers.

   For 64-bit storage and auxiliary storage, calculate their requirements as described in Estimating storage requirements for CMCI.

Setup guide

Scenario 1: You want to set up the CMCI in a WUI region that does not have CMCI configured.

Follow the instructions in Configuring CMCI with CMCI JVM server in a WUI region.

Scenario 2: You have a WUI region that is already set up with the basic CMCI. You want to convert the WUI region to use the CMCI JVM server.

For instructions, see Converting a WUI region with basic CMCI to use CMCI JVM server.

Scenario 3: You want to have several CMCI JVM servers running in a CICSplex.

If you have several CMCI JVM servers running in a CICSplex, you can configure the single sign-on (SSO) support in Liberty to enable HTTP client users to authenticate once with one CMCI JVM server, thus having access to other CMCI JVM servers in the same CICSplex without re-authentication. For instructions, see Setting up for multiple CMCI JVM servers in a CICSplex.