3 – Install RACF Exits ICHRIX02 and ICHPWX01

Note
Install the new password exit only if support for password synchronization support is required.

RACF exits ICHRIX02 and ICHPWX01 can be installed using either of the following methods:

• Dynamic installation

• Static installation

The dynamic installation process implies that when the Connector Online Interceptor is started it loads the exit modules and activates them. When the Connector Online Interceptor is terminated it deactivates the exits and removes them from the system.

If a system exit is already installed at the site, on each exit call, the dynamically-loaded Connector exit is executed first, followed by the existing system exit.

The static installation process implies that the exit is compiled and linked to a system LPA library (for example, SYS1.LPALIB) and is activated automatically after an IPL (or using a product which can dynamically load modules to the LPA).

For the static installation process, a sample multiple exits driver is provided to handle situations where exit modules for ICHRIX02 or ICHPWX01 already exist at the site. The multiple exits driver can be configured to call the pre-existing exit modules in addition to the exit modules supplied by Connector for RACF.

Method 1 - Dynamic Installation

To perform a dynamic installation of RACF exits ICHRIX02 and ICHPWX01:

Edit the RSSPARM member in the Connector PARM library.

The following parameters define whether the Connector Online Interceptor will dynamically install ICHRIX02 and ICHPWX01 when it is started.

ONLI_DYNAM_RIX02

ONLI_DYNAM_PWX01

Set each parameter to Y and save the member.

Dynamic installation of RACF exits ICHRIX02 and ICHPWX01 is complete. Exits ICHRIX02 and ICHPWX01 are dynamically installed when the Online Interceptor is started.

Method 2 - Static Installation

Note
Do not continue with this procedure if you have already used Method 1 (above) to install exits ICHRIX02 and ICHPWX01.

Static installation of Connector ICHRIX02 and ICHPWX01 exits create the ICHRIX02 and ICHPWX01 load modules in the system LPA library.

The following members in the INSTALL library involved in this procedure are listed in the following table.

Member	Description
CTSRIX2A	Connector ICHRIX02 RACF exit source code.
CTSRIX2B	Connector for RACF sample multiple ICHRIX02 RACF exits driver source code.
CTSPWX1A	Connector ICHPWX01 RACF exit source code.
CTSPWX1B	Connector for RACF sample multiple ICHPWX01 RACF exits driver source code.
ASMRIX2A	Sample job to compile and link CTSRIX2A.
ASMRIX2B	Sample job to compile and link CTSRIX2B.
CPYRIX2A	Sample job to copy CTSRIX2A module to the system LPA library as ICHRIX02.
CPYRIX2B	Sample job to copy CTSRIX2B module to the system LPA library as ICHRIX02.
ASMPWX1A	Sample job to assemble and link CTSPWX1A.
ASMPWX1B	Sample job to assemble and link CTSPWX1B.
CPYPWX1A	Sample job to copy CTSPWX1A module to the system LPA library as ICHPWX01.
CPYPWX1B	Sample job to copy CTSPWX1B module to the system LPA library as ICHPWX01.

To perform static installation of RACF exits ICHRIX02 and ICHPWX01:

1. Create the CTSRIX2A exit module.

   Member ASMRIX2A in the Connector INSTALL library is a sample member used to assemble and link Connector for RACF exit ICHRIX02.

   Review the JCL carefully and submit the job to create the CTSRIX2A load module. All job steps must end with a condition code of 0.

2. Create the CTSPWX1A exit module.

   Member ASMPWX1A in the Connector INSTALL library is a sample member used to assemble and link Connector for RACF exit ICHPWX01.

   Review the JCL carefully and submit the job to create the CTSPWX1A load module in the Connector LOAD library. All job steps must end with a condition code of 0.

   Customize the multiple exits driver exit table.

   The multiple exits driver is provided to handle situations where exit modules for ICHRIX02 or ICHPWX01 already exist at the site. The multiple exits driver can be configured to call the pre-existing exit modules in addition to the exit modules supplied by Connector for RACF.

   If you do not require the multiple exits driver, skip to step 6.

   The multiple exits driver source code contains a table in which you must define the ICHRIX02 and ICHPWX01 exit modules that need to be called. The multiple exits driver calls each module in sequence as specified in the table. Each exit in the table is called, regardless of the return code of the preceding exit. The multiple exits driver returns the highest return code of all the exits that were called.

   Edit members CTSRIX2B and CTSPWX1B in the Connector INSTALL library. Locate the exits table at the end of each source member and customize it to call your local exit modules.

   Save the members.

3. Create the CTSRIX2B exit module.

   Member ASMRIX2B in the Connector INSTALL library is a sample member used to assemble and link the Connector for RACF sample driver for multiple ICHRIX02 exits.

   Note
   You must add an INCLUDE statement to the linkage editor input stream so that the exits driver is linked with your local exit.

   Review the JCL carefully and submit the job to create the CTSRIX2B load module in the Connector LOAD library. All job steps must end with a condition code of 0.

4. Create the CTSPWX1B exit module.

   Member ASMPWX1B in the Connector INSTALL library is a sample member to assemble and link the Connector for RACF sample driver for multiple ICHPWX01 exits.

   Note
   You must add an INCLUDE statement to the linkage editor input stream so that the exits driver is linked with your local exit.

   Review the JCL carefully and submit the job to create the CTSPWX1B load module. All job steps must end with a condition code of 0.

5. Copy CTSRIX2B and CTSRIX2A to your LPA system library.

   1. Edit member CPYRIX2B in the Connector INSTALL library. The job copies CTSRIX2B to your system LPA library as ICHRIX02.

   2. Edit member CPYPWX1B in the Connector INSTALL library. The job copies CTSPWX1B to your system LPA library as ICHPWX01.

   Note
   Any previous copy of exit ICHRIX02 or ICHPWX01 in the LPA library is overwritten after the job completes. It is recommended that you create a backup copy of each previous exit.

   Review the job carefully and submit the job. All job steps must end with a condition code of 0. Continue to step 7.

6. Copy CTSRIX2A and CTSPWX1A to your LPA system library.

   Important
   If you are using the multiple exits driver, skip this step and continue to step 7.

   1. Edit member CPYRIX2A in the Connector INSTALL library. The job copies CTSRIX2A to your system LPA library as ICHRIX02.

   2. Edit member CPYPWX1A in the Connector INSTALL library. The job copies CTSPWX1A to your system LPA library as ICHPWX01.

   Note
   Any previous copy of exit ICHRIX02 or ICHPWX01 in the LPA library is overwritten after the job completes. It is recommended that you create a backup copy of each previous exit.

   Review the jobs carefully and submit the jobs. All job steps must end with a condition code of 0.

7. Set the Online Interceptor dynamic exit parameters.

   Edit member RSSPARM in the Connector PARM library.

   The following parameters define whether or not the Connector Online Interceptor will dynamically install ICHRIX02 and ICHPWX01 when it is started.

   ONLI_DYNAM_RIX02

   ONLI_DYNAM_PWX01

   Set the value of each parameter to N and save the member.

8. Activate the exits in LPA.

   Once the exit modules reside in your LPA library, you need to activate them. This is performed by the next IPL with the CLPA option.

Note
Static installation of RACF exit ICHRIX02 and ICHPWX01 without SMP/E is complete.