XSRC gate, CHECK_CICS_RESOURCE function
The CHECK_CICS_RESOURCE function of the XSRC gate performs CICS resource access checks.
Input Parameters
- ACCESS
- is the type of access to be made on the resource.
- Values for the parameter are:
- COLLECT
- CREATE
- DEFINE
- DELETE
- DISCARD
- EXECUTE
- INQUIRE
- INSTALL
- PERFORM
- READ
- SET
- UPDATE
- RESOURCE
- is the name of the resource, padded with blanks to eight-characters.
- RESOURCE_TYPE
- is the type of the resource.
- Values for the parameter are:
- DB2ENTRY
- FILE
- JOURNALNAME
- PROGRAM
- PSB
- TDQUEUE
- TRANSACTION
- TRANSATTACH
- TSQUEUE
- FORCE
- Optional Parameter
- indicates (optionally) whether or not security checking is forced regardless of the setting of RESSEC in the Security Domain's transaction token.
- Values for the parameter are:
- NO
- YES
- LOGMESSAGE
- Optional Parameter
- indicates whether access failures are logged to the CSCS transient data queue and the MVS System Management Facility (SMF).
- Values for the parameter are:
- NO
- YES
Output Parameters
- REASON
- The values for the parameter are:
- NOTAUTH
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- ESM_RESPONSE
- Optional Parameter
- is the optional 32-bit ESM response code to the call.
- FAILING_USERID
- Optional Parameter
- is the userid that failed to access the resource.
- FAILING_USERID_LENGTH
- Optional Parameter
- is the length of the userid (specified by the FAILING_USERID value).
- SAF_RESPONSE
- Optional Parameter
- is the optional 32-bit SAF response code to the call.