REQUEST PASSTICKET

Request an external security manager to build a PassTicket.

Syntax

Read syntax diagramSkip visual syntax diagram
REQUEST PASSTICKET

>>- REQUEST PASSTICKET--(--data-area--)------------------------->

>--ESMAPPNAME--(--data-area--)--+---------------------------+--><
                                '-ESMRESP--(--data-value--)-'   

Conditions: NOTAUTH, INVREQ

This command is threadsafe.

Description

The REQUEST PASSTICKET command requests an external security manager (ESM), such as RACF®, to build a PassTicket. The PassTicket is a password substitute that your program can use to sign on to a particular application on a particular system, such as another CICS® region. You must use the ESMAPPNAME option to specify the profile name by which the external security manager refers to the application to which you are signing on.

The PassTicket that the external security manager generates is for the user ID associated with the task that issues the REQUEST PASSTICKET command. Use the EXEC CICS ASSIGN command with the USERID option to identify the user ID that is associated with the task.
Note: A request for a PassTicket succeeds if a userid is revoked, but an attempt to sign on with that userid and PassTicket fails.

A PassTicket must be used within 10 minutes of being generated. If the PassTicket times out (because, for example, of a session failure), your application must generate another before attempting to sign on again. Repeated failed sign-on attempts with PassTickets can result in the user ID being revoked.

PassTickets are not displayed when the CICS execution diagnostic facility (EDF) is used.

Before using PassTickets, you must ensure that the system clocks for the target system and the originating system are synchronized to within the valid time range. You must also define a Secure Signon key for each target system. For information on the requirements for using PassTickets, see Generating and using PassTickets for secure sign-on.

Options

ESMAPPNAME(data-area)
Specifies the eight-character profile name by which the external security manager refers to the application for which the supplied PassTicket is used. For CICS regions, the profile name is the APPLID of the CICS region. If the external security manager is RACF, for more information about RACF profile names and PassTickets, see Using the secured signon function in z/OS Security Server RACF Security Administrator's Guide.
ESMRESP(data-area)
Returns the response code from the external security manager, as a fullword binary variable. When RACF is in use, the possible values are the return codes that are supplied when using the RACF secured signon service to generate a PassTicket, as follows:
0
A PassTicket was produced.
8
A PassTicket was not produced.
PASSTICKET(data-area)
Returns the 8-character PassTicket generated by the external security manager.

Conditions

16 INVREQ
RESP2 values:
Start of change247End of change
Start of changeAn invalid value has been specified for ESMAPPNAME.End of change
251
The interface between CICS and the external security manager is not active.
252
The value returned by the external security manager in ESMRESP is not classified by CICS.
254
The external security manager does not support requests for a PassTicket.
256
This command is not valid when running under the default userid.
70 NOTAUTH
RESP2 values:
250
PassTicket was not built successfully. The external security manager does not authorize a request for a PassTicket for the combination of the user ID associated with the task that issued this command, and the profile name specified in ESMAPPNAME.
Start of change260End of change
Start of changeThe external security manager does not authorize a request to generate a PassTicket for this region.End of change


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