PITC gate, VALIDATE function
Sends a request to the Security Token Service to validate a security token from the WS-Security message header.
Input parameters
- DESTINATION_URI_BLOCK
- The URI of the Security Token Service endpoint on the network.
- TRUST_LEVEL
- The level of WS-Trust that is supported in CICS.
- SECURITY_TOKEN_BLOCK
- The security token that should be validated by the Security Token Service.
- RETURNED_SECTOK_BUFF
- A buffer for the validation response that is returned by the Security Token Service.
- RESPONSE_TOKEN
- A unique reference that identifies the request to CICS.
Output parameters
- STATUS
- The status of the security token that was passed to the Security Token
Service for verification. Values are:
- TRUST_VALID
- The Security Token Service has confirmed that the security token is valid.
- TRUST_INVALID
- The Security Token Service has confirmed that the security token is invalid.
- TRUST_UNKNOWN
- The Security Token Service was unable to verify the security token.
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- NOT_FOUND
- BUFFER_TOO_SMALL
- CHANNEL_ERROR
- CONTAINER_ERROR
- INVALID_URI
- ENDPOINT_NOT_PROVIDED
- SOAP_FAULT_BUILT
- UNHANDLED_PIPELINE_ERROR
- TIMED_OUT
- NO_TRUST_REPLY
- TRUST_PARSE_FAILED
- TRUST_FAULT
- INVALID_TRUST_REPLY
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.