Filter
Top Products
Table 37. Obtaining the address of the installation data parameter list
RACROUTE
REQUEST type
RACF exit Exit list mapping
macro
Parameter list field
name
VERIFY ICHRIX01 ICHRIXP RIXINSTL
ICHRIX02 ICHRIXP RIXINSTL
AUTH ICHRCX01 ICHRCXP RCXINSTL
ICHRCX02 ICHRCXP RCXINSTL
FASTAUTH ICHRFX01 ICHRFXP RFXANSTL
ICHRFX02 ICHRFXP RFXANSTL
LIST ICHRLX01 ICHRLX1P RLX1INST
ICHRLX02 ICHRLX2P RLX2PRPA See note
2.
EXTRACT Not available Not available None
Notes:
1. The “xxxINSTL” field points to the installation parameter list only if you specify
INSTLN on the ESMEXITS system initialization parameter. The default value of
this parameter is NOINSTLN, which means that no installation data is passed.
2. RLX2PRPA contains the address of the ICHRLX01 user exit parameter list
(RLX1P). Field RLX1INST of RLX1P in turn points to the installation data
parameter list.
For full descriptions of the RACF exit parameter lists, see the
OS/390 Security
Server (RACF) Security Administrator’s Guide
manual. For more information about
CICS security processing using RACF, see the
CICS RACF Security Guide
.
The installation data parameter list
The installation data parameter list gives your ESM exit programs access to the
following information:
v The CICS security event being processed.
v Details of the current CICS environment. That is:
– The applid of the CICS region
– The common work area (CWA)
– The transaction being invoked
– The program being executed
– The CICS terminal identifier
– The VTAM LU name
– The terminal user area.
You can map the installation parameter list using the macro DFHXSUXP. The
DSECT DFHXSUXP contains the following fields:
UXPLEN
A halfword containing the length of this parameter list in bytes.
UXPARROW
Arrow “eyecatcher” (>).
UXPDFHXS
The name of the owning component (DFHXS).
ESM exit programs
Chapter 28. Invoking a user-written external security manager 725