XSIS gate, INQUIRE_REALM_NAME function
Obtains the realm names under which the CICS system is executing; a realm is an environment in which a userid and password pairing is valid.
Input Parameters
- REALM_TYPE
- Indicates that the request is for the Basic realm name.
- Values for the parameter are:
- BASIC
- KERBEROS
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- LOOP
- The following values are returned when RESPONSE is INVALID:
- INVALID_FORMAT
- INVALID_FUNCTION
- REALM_NAME
- Returns the name of the realsm under which CICS is executing.
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.