The Installation Data Parameter List - IBM SC34-6814-04 Customization Manual

Note:
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:
You can map the installation parameter list using the macro DFHXSUXP. The
DSECT DFHXSUXP contains the following fields:
UXPLEN
UXPARROW
UXPDFHXS
UXPBLKID
UXPPHASE
Table 46. Obtaining the address of the installation data parameter list (continued)
RACROUTE RACF exit
REQUEST type
EXTRACT Not available
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.
– 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.
A halfword containing the length of this parameter list in bytes.
Arrow "eyecatcher" (>).
The name of the owning component (DFHXS).
The name of the block identifier (UXPARMS).
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:
Exit list mapping
macro
Not available
Chapter 31. Invoking an external security manager
Parameter list field
name
None
793