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.


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