APF-authorize libraries

You must APF-authorize any runtime libraries that are concatenated in the STEPLIB DDNAME of the OMEGAMON started tasks (like OMEGAMON Collector, TEMS, or TEMA).

Before you begin

Ensure you complete one of the following: requirements

Provide UPDATE privilege for the OMEGAMON Collector started task JCL in your system PROCLIB (SYS1.PROCLIB)
Provide UPDATE privilege for your system PARMLIB (SYS1.PARMLIB) and z/OS system command authority

Procedure

Add the following runtime load libraries to your list of APF-authorized libraries:

rHilev.rte_name.RKANMODU
rHilev.rte_name.RKANMOD
rHilev.rte_name.RKANMODL
rHilev.rte_name.RKANMODP

You can accomplish this in three different ways:

Set the RTE_X_STC_INAPF_INCLUDE_FLAG to Y in your configuration tool user profile. This will handle all APF authorizations for you by adding the necessary statements into the started tasks.
Add the APF authorization directly to the OMEGAMON Collector started task. Open the JCL in your system PROCLIB and add the following line before the EXEC statement (PGM=KO2ZTOPB) at the beginning of the started task for each of the libraries listed above:
```
//   SETPROG APF,ADD,DSN=library_name,SMS
```
Note: If the data sets are not SMS managed, you must modify the statements above accordingly.

It is sufficient to add the APF authorization to the OMEGAMON Collector started task. The OMEGAMON Collector is always started first and therefore the libraries are already APF-authorized for the other started tasks.
To manage the APF authorizations centrally, define your APF authorizations in your system's PARMLIB.
- Add the following line to the member PROGxy in your system's PARMLIB (SYS1.PARMLIB) for each of the libraries listed above:
```
APF ADD  DSNAME(library_name) SMS
```
  If the data sets are not SMS managed, you must modify the statements above accordingly.
- Enter the following z/OS system command to activate the changes:
```
/t PROG=xy
```