Determining the agent user ID for CICSPlex SM components

You need to know the user ID that is used by components of CICSPlex® SM, such as the CMAS, MAS, WUI, and SMSS so that you can set up the right authorization in RACF.

What governs the agent user ID?

The agent user ID depends on the following factors:
  • The release of CICS®, but irrespective of the release of CICSPlex SM
  • How the agent was initialized.
  • Whether the PLTPIUSR system initialization parameter is set (to initialize the agent at the initialization of the CICS region)
The agent user IDs for the CMAS, MAS, or WUI run under the PLTPIUSR user ID only when the SIT parameter SEC=YES and at least one of the following SIT parameter values are set. Otherwise, the agent user ID continues to run under the CICS region user ID.
  • PLTPI=YES or PLTPI=name
  • MQCONN=YES
  • DB2CONN=YES
  • DBCTLCON=YES
For CMAS and WUI regions, use the CPSMCONN SIT parameter instead of the PLTPI SIT parameter. Do not specify the MQCONN=YES, DB2CONN=YES, or DBCTLCON=YES SIT parameters in these regions.

For details of SIT parameters, see System initialization parameter descriptions and summary.

Use the tables to determine which ID is used:
Table 1. CMAS agent user ID
CICSPlex SM release How was the CMAS agent initialized? PLTPIUSR in system initialization table? CMAS agent user ID
Any in-service release At initialization of the CICS region (CPSMCONN only) Not applicable (no effect) CICS region user ID
5.5 or earlier At initialization of the CICS region (PLT entry only) No CICS region user ID
5.5 or earlier At initialization of the CICS region (PLT entry only) Yes PLTPIUSR (see details in What governs the agent user ID?)
Table 2. MAS agent user ID
CICSPlex SM release How was the MAS agent initialized? PLTPIUSR in system initialization table? MAS agent user ID
Any in-service release At initialization of the CICS region (CPSMCONN only) Not applicable CICS region user ID
5.4 or later Using the COLM transaction Not applicable CICS region user ID
5.3 or earlier Using the COLM transaction Not applicable Signed-on user ID that initiated COLM
5.5 or earlier At initialization of the CICS region (PLT entry only) No CICS region user ID
5.5 or earlier At initialization of the CICS region (PLT entry only) Yes PLTPIUSR (see details in What governs the agent user ID?)
Table 3. WUI agent user ID
CICSPlex SM release How was the WUI agent initialized? PLTPIUSR in system initialization table? WUI agent user ID
Any in-service release At initialization of the CICS region (CPSMCONN only) Not applicable CICS region user ID
Any in-service release Using the COVC transaction Not applicable Signed-on user ID that initiated COVC
5.5 or earlier At initialization of the CICS region (PLT entry only) No CICS region user ID
5.5 or earlier At initialization of the CICS region (PLT entry only) Yes PLTPIUSR (see details in What governs the agent user ID?)