PITC gate, ISSUE function

Sends a request to the Security Token Service to issue a username token in exchange for 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.
SERVICE_URI_BLOCK
The URI of the web service that the Security Token should issue a token for to CICS. This URI is taken from the appliesTo field.
TRUST_LEVEL
Optional parameter.

The level of WS-Trust that CICS supports.

SECURITY_TOKEN_BLOCK
Optional parameter.

The security token that the Security Token Service should exchange.

AUTHTOKEN_TYPE_BLOCK
The URI and localname of the token type that should be returned by the Security Token Service.
RETURNED_SECTOK_BUFF
A buffer for the token that is returned by the Security Token Service.
RESPONSE_TOKEN
The token that is issued by the Security Token Service.

Output parameters

PASSWORD
Optional parameter.

The password that is returned by the Security Token Service.

USERNAME
Optional parameter.

The user name that is returned by the Security Token Service.

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_PITCissue.html | Timestamp icon Last updated: Monday, 5 June 2017