The R_kerbinfo callable service can be used to either retrieve RACF® Network Authentication Service information, or to update the count of unsuccessful attempts to use a Network Authentication Service key.

The action performed by this callable service is based on the function code passed by the caller in the R_kerbinfo parameter list:

• When the function code is set to X'01', R_kerbinfo retrieves local Network Authentication Service principal information. The caller must identify the principal by providing a RACF name or a Network Authentication Service principal name.
• When the function code is set to X'02', R_kerbinfo increments the count of invalid attempts by a Network Authentication Service principal to use a key. The caller must identify the principal by providing a Network Authentication Service principal name.
• When the function code is set to X'03', R_kerbinfo resets the count of invalid attempts by a Network Authentication Service principal to use a key to zero. The caller must identify the principal by providing a Network Authentication Service principal name.
• When the function code is set to X'04', R_kerbinfo retrieves Network Authentication Service realm information. The caller may identify the realm by providing a Network Authentication Service realm profile name, or by providing a NULL name, in which case RACF will return information about the local realm, KERBDFLT.

Field data is returned to the invoker in a data structure containing a set of repeating ordered triplets, which are of the format name of the field, length of the field, and field data.