FEPI REQUEST PASSTICKET

Function

FEPI REQUEST PASSTICKET requests an external security manager (ESM) such as RACF® to build a PassTicket. The PassTicket is a password substitute that your application can use to sign on to the back-end system associated with the conversation. For an explanation of how to use PassTickets to make your FEPI applications more secure, see How to use PassTickets.

Syntax

Read syntax diagramSkip visual syntax diagramFEPI REQUEST PASSTICKET
 
>>-FEPI REQUEST PASSTICKET(data-area)--CONVID(data-value)------->
 
>--+--------------------+--+----------------------+------------><
   '-ESMRESP(data-area)-'  '-ESMREASON(data-area)-'
 

Options

CONVID(8-character data-value)
specifies the ID of the conversation with the back-end system for which a PassTicket is required.
ESMREASON(fullword binary data-area)
returns the reason code from the ESM.
ESMRESP(fullword binary data-area)
returns the response code from the ESM. For an explanation of the response and reason codes returned by RACF, see the OS/390 Security Server (RACF) Messages and Codes manual.
PASSTICKET(8-character data-area)
returns the PassTicket generated by the ESM.

Conditions

The INVREQ condition can have the following RESP2 values:

RESP2
Meaning
240
Conversation ID not owned by this task.
250
Passticket not built successfully.
251
CICS ESM interface not initialized.
252
Unknown return code in ESMRESP from the ESM.
253
Unrecognized response from CICS security modules.
254
Function unavailable.
[[ Contents Previous Page | Next Page Index ]]