XSRC gate, CHECK_NON_CICS_RESOURCE function
The CHECK_NON_CICS_RESOURCE function of the XSRC gate performs non-CICS resource access checks.
Input Parameters
- ACCESS
- is the type of access to be made on the resource.
- Values for the parameter are:
- ALTER
- CONTROL
- READ
- UPDATE
- CLASSNAME
- is the ESM class name in which the resource is defined.
- RESOURCE_NAME
- is the address and length of the resource name, in the form RESOURCE_NAME(addr,length).
- 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:
- CLASS_NOT_FOUND
- ESM_INACTIVE
- ESM_NOT_PRESENT
- INVALID_RESOURCE_NAME
- NOTAUTH
- RESOURCE_NOT_FOUND
- 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.