What is the Facility class resource BPX.PRIVPATHOK resource used for?

Document ID : KB000028769
Last Modified Date : 14/02/2018
Show Technical Document Details

Description

What is the Facility class resource BPX.PRIVPATHOK resource used for?

Summary

The Facility Class Profile BPX.PRIVPATHOK resource is used as a temporary problem determination aid used with IBM apar OA43650.

Detail

IBM OA43650 Apar mention a temporary warning mode by defining
RACF Facility Class Profile BPX.PRIVPATHOK, that is intended as
temporary problem determination aid to help determine the possible
symbolic links installed on your system that may need to be changed
due to the introduction of the IBM PTF.                                          

The RACROUTE REQUEST=AUTH is done to check for the existence of the
profile and either a Return code of 0 or 8 is expected in R15 in
order to not abend and just generate the message.  If a site would
need the return code 4 in order to abend for debugging.

How can the desired return code to the BPX.PRIVPATHOK RACROUTE REQUEST=AUTH
call be returned with ACF2?    

An ACF2 SAFDEF can be coded to return the desired return code(0, 4 or 8)
for the RACROUTE REQUEST=AUTH BPX.PRIVPATHOK resource call.

For Example: To force a return code 4 from the RACROUTE REQUEST=AUTH CLASS=FACILITY call
for resource BPX.PRIVPATHOK the following ACF2 GSO SAFDEF can be inserted from TSO ACF. 

ACF                                                                           
SET C(GSO)                                                                 
INSERT SAFDEF.privp ID(privp) RETCODE(4) MODE(IGNORE) -                    
  RACROUTE(REQUEST=AUTH,CLASS=FACILITY,ENTITY=BPX.PRIVPATHOK)              
F ACF2,REFRESH(SAFDEF)