FASTAUTH return code translation

Each time the RACF access control module is started, it can also start RACROUTE REQUEST=FASTAUTH multiple times.

If one of the FASTAUTH requests is completed with a return code of zero, the return code passed back to Db2 is zero. If none of the FASTAUTH requests are completed with a return code of zero, the collection of return codes from FASTAUTH must be translated into a single resultant return code. Return code translation can be summarized as follows:

If all object resource checks result in a return code of 4 and none of the DSNADM checks result in a return code of 0, the RACF access control module passes back a return code of 4.

If at least one object resource check results in a return code of 8 and none of the DSNADM checks result in a return code of 0, the RACF access control module passes back a return code of 8.

If no object resource profiles are checked and all of the DSNADM checks result in a return code of 8, the RACF access control module passes back a return code of 8. Otherwise, if no object resources are checked and the DSNADM checks result in a mix of 4s and 8s, the RACF access control module passes back a return code of 4.

All failing SAF/RACF return codes and RACF reason codes are placed in the output parameter field in XAPLDIAG, to be returned to Db2. This information is then available to Db2, SQL, or other programs to obtain diagnostic information from it.

The following table illustrates the method used to do this translation.

Table 1. FASTAUTH return code translation
Return code from object profile Return code from ADM profile Output return code
 — All 4s 04
 — All 8s 08
 — Mix 04
All 4s All 4s 04
All 4s All 8s 04
All 4s Mix 04
All 8s All 4s 08
All 8s All 8s 08
All 8s Mix 08
Mix All 4s 08
Mix All 8s 08
Mix Mix 08
Note: Mix indicates various 4 and 8 return codes.