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.


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