Filter
Top Products
Table 46. Obtaining the address of the installation data parameter list (continued)
RACROUTE
REQUEST type
RACF exit Exit list mapping
macro
Parameter list field
name
EXTRACT Not available Not available None
Note:
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 Introduction to CICS security with RACF,
in 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).
UXPBLKID
The name of the block identifier (UXPARMS).
UXPPHASE
Address of a 1-byte code that indicates the reason for the call to the ESM
(that is, the security event being processed). The code can have one of the
following values:
Chapter 31. Invoking an external security manager 793