z/OS Security Server RACF Macros and Interfaces
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Profile name list service routine (IRRPNL00)

z/OS Security Server RACF Macros and Interfaces
SA23-2288-00

RACF® provides installations with a profile name list service routine (IRRPNL00) that allows TSO or other programs to call RACF to retrieve the names of profiles within a class that a given user ID can access at READ level or higher.

To perform this function, IRRPNL00 searches the RACF class descriptor table (CDT) for the class name. If the class is found and the class is processed by SETROPTS RACLIST, IRRPNL00 checks each profile name processed by SETROPTS RACLIST to see if the specified user ID is authorized to access the profile at READ level or higher. When IRRPNL00 finds a match, it places the profile name into the input work area.

IRRPNL00 begins its search with the first profile and continues its search until it checks all the profiles or until the size of the list exceeds the size of the work area.

IRRPNL00 resides in LPA. RACF loads the address of IRRPNL00 into RCVTPNL0 during RACF initialization. The caller of IRRPNL00 can use the address in RCVTPNL0.
Note:
  1. To use the profile name list service routine, you must ensure that a SETROPTS RACLIST is issued for each class name you intend to search.
  2. Your program is responsible for obtaining and releasing the storage which IRRPNL00 uses to store the profile name list.
  3. Callers of IRRPNL00 must be authorized in one of the following ways:
    • APF-authorized
    • Supervisor state
    • System key 0.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014