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.


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