Reviewing values returned by the EXEC CICS ASSIGN command in the application-owning region

Review the values returned by the PRINSYSID and USERID options when you use the EXEC CICS ASSIGN command, because the values are taken from a number of sources.

PRINSYSID
This option returns the system identifier (SYSID) of the principal facility to the transaction. The value returned is the name of the remote connection or terminal defined in this system. If the connection or terminal has been shipped, the name is the original name defined in the terminal-owning region (TOR). If the principal facility is not an APPC session, the INVREQ condition is issued.
USERID
For a routed transaction, CICS® takes the user ID from one of several sources, depending on how you specified your security requirements. For more information, see Transaction routing security with LU6.2.
Table 1 explains the value that is returned by the USERID option. The values are as follows:
  • If the connection is defined with the ATTACHSEC(LOCAL) option, and SEC=YES or MIGRATE is specified in the system initialization parameters of the application-owning region (AOR), CICS returns a value that depends on the connection type:
    • For ISC over SNA and IPIC connections, the value returned is either the USERID attribute, if this attribute is specified in the SESSIONS definition, or the value of the SECURITYNAME attribute that is specified in the CONNECTION definition.
    • For MRO connections, the RACF® user ID of the TOR.
  • If the connection is defined with the ATTACHSEC(LOCAL) option, and SEC=NO is specified in the system initialization parameters of the AOR, CICS returns the DFLTUSER value from the AOR.
  • If the connection is defined with the ATTACHSEC(IDENTIFY) option or, for APPC connections, the VERIFY, PERSISTENT, or MIXIDPE option, and SEC=YES or MIGRATE is specified in the system initialization parameters of the TOR, CICS returns the user ID sent at attach time.
  • If the connection is defined with the ATTACHSEC(IDENTIFY) option, or, for APPC connections, the VERIFY, PERSISTENT, or MIXIDPE option, and SEC=NO is specified in the system initialization parameters of the TOR, CICS returns the DFLTUSER value from the TOR.
Table 1. Values returned by the USERID option of EXEC CICS ASSIGN, for routed transactions
System initialization parameter SEC= value in TOR ATTACHSEC value in CONNECTION definition

IDENTIFY
VERIFY
PERSISTENT
MIXIDPE

LOCAL
System initialization parameter SEC=YES or MIGRATE value in AOR System initialization parameter SEC=NO value in AOR

YES
or
MIGRATE

User ID sent at attach   ISC over SNA and IPIC:
  1. USERID of session
  2. SECURITYNAME of connection
  MRO: RACF user ID of TOR
DFLTUSER of AOR
NO User ID sent at attach (DFLTUSER of TOR)


dfht12u.html | Timestamp icon Last updated: Monday, 5 June 2017