XSIS gate, SET_SECURITY_DOMAIN_PARMS function

At CICS startup, loads information for the security domain from the system initialization table (SIT) into the security state data.

Input Parameters

APPLID
The application identifier for the CICS region.
ESMEXITS
Determines whether installation data is to be passed via the RACROUTE interface to the ESM for use in user exits written for the ESM.
Values:
  • NO
  • YES
PSBCHK
Determines whether DL/I security checking is to be performed for a remote terminal initiating a transaction with transaction routing.
Values:
  • NO
  • YES
SECURITY
Determines whether security is active for this CICS region.
Values:
  • NO
  • YES
XAPPC
Determines whether session security checking is used when establishing APPC sessions.
Values:
  • NO
  • YES
CMDSEC
Optional
Determines whether or the CICS region uses the CMDSEC option specified on a transaction resource definition.
Values:
  • ALWAYS
  • ASIS
EJBROLE_PREFIX
Optional
Prefix that qualifies the security role defined in an enterprise bean deployment descriptor.
KEYRING
Optional
Fully qualified name of the key ring that contains the keys and X.509 certificates used to support the secure sockets layer (SSL).
PREFIX
Optional
Prefix applied to the resource name in any authorization requests sent to the external security manager.The value is 1 through 8 alphanumeric characters, or the single character '*', which indicates that the CICS region user ID is to be used as the prefix.
RESSEC
Optional
Determines whether the CICS region uses the RESSEC option specified on a transaction resource definition.
Values:
  • ALWAYS
  • ASIS
XCMD
Optional
Determines whether EXEC CICS commands are checked by the ESM.
Values:
  • NO
  • YES
  • name where name is the resource class name for EXEC CICS commands.
XDB2
Optional
Determines whether CICS performs DB2ENTRY security checking.
Values:
  • NO
  • YES
  • name where name is the resource class name for DB2 entries.
XDCT
Optional
Determines whether destination control entries are checked by the ESM.
Values:
  • NO
  • YES
  • name where name is the resource class name for destination control entries.
XFCT
Optional
Determines whether file control entries are checked by the ESM.
Values:
  • NO
  • YES
  • name where name is the resource class name for file control entries.
XJCT
Optional
Determines whether journal entries are checked by the ESM.
Values:
  • NO
  • YES
  • name where name is the resource class name for journal entries.
XPCT
Optional
Determines whether EXEC-started transactions entries are checked by the ESM.
Values:
  • NO
  • YES
  • name where name is the resource class name for EXEC-started transaction entries.
XPPT
Optional
Determines whether program entries are checked by the ESM.
Values:
  • NO
  • YES
  • name where name is the resource class name for program entries.
XPSB
Optional
Determines whether PSB entries are checked by the ESM.
Values:
  • NO
  • YES
  • name where name is the resource class name for PSB entries.
XTRAN
Optional
Determines whether attached transaction entries are checked by the ESM.
Values:
  • NO
  • YES
  • name where name is the resource class name for attached transaction entries.
XTST
Optional
Determines whether temporary storage entries are checked by the ESM.
Values:
  • NO
  • YES
  • name where name is the resource class name for temporary storage entries.
XUSER
Optional
Determines whether user entries are checked by the ESM.
Values:
  • NO
  • YES
  • name where name is the resource class name for user entries.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • CWA_WAIT_PHASE_FAILURE
  • INQUIRE_CWA_FAILURE
  • LOOP
The following values are returned when RESPONSE is EXCEPTION:
  • GETMAIN_FAILED
  • KEYRING_NOT_FOUND
  • KEYRING_NOTAUTH
The following values are returned when RESPONSE is INVALID:
  • INVALID_FORMAT
  • INVALID_FUNCTION
RESPONSE
Indicates whether the domain call was successful. For more information see RESPONSE parameter on domain interfaces.
ESM_RESPONSE
Optional
32-bit ESM response code that is returned to the call.
SAF_RESPONSE
Optional
32-bit SAF response code that is returned to the call.


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