DATA/PASSTICKET

Requests a RACF® PassTicket from the CICSPlex® SM Web User Interface server.

DATA/PASSTICKET

Read syntax diagramSkip visual syntax diagramDATA/PASTICKET

Description

Providing access to WUI views and menus explains how you can access the Web User Interface through a web browser. For example, a client application using the data interface might want to launch a web browser window to allow the user to carry out some activities not supported directly by the client application. However, because the web browser is a separate application it does have the client's cookie, which means the user of the client application would have to sign on separately to the Web User Interface server through the web browser.

The DATA/PASSTICKET command provides a mechanism by which a client application can achieve an authenticated browser launch without requiring the user to perform another signon. This mechanism is in two parts:
  • It provides the means of obtaining a PassTicket, which avoids the need to store and communicate the RACF password from the client application signon. For information about PassTickets, see How it works: PassTickets .
  • It provides the ability to join an existing Web User Interface user session, and share the session resources between the client application and web browser.

When the client application receives a PassTicket, it can start a web browser using the HTTP POST method to send the signon details for the user. The POST request includes the variables matching the options of the DATA/CONNECT command, including USERID=value, RECONN=J, and PASSWORD=. However, on the PASSWORD= option, you specify the PassTicket value in place of the password. You can specify the required menu, view, or object on the URL path of the web browser start request. Include in the POST request body any additional query variables for the launch request; for example, CONTEXT.

The table shows the additional header field that is returned, if the DATA/PASSTICKET command completes with STATUS OK:

Table 1. Data returned on DATA/PASSTICKET command response header
Header field Description
PASSTICKET= The PassTicket generated by RACF. This PassTicket is for the current application and user ID, and must be protected..

Options

None.

STATUS values

BADCOMMAND
The command passed to the data interface by the Web User Interface is not recognized.