Usage notes

Function code X'0001' is provided specifically for use by the Enterprise Identity Mapping (EIM) component of the Integrated Security Services Element.
It is the responsibility of the caller to obtain and free the Result_entries data area. ResultAreaLen must be set to the total length of the area provided, including the length of the ResultArea structure and the length of the appropriate function specific data area.
On output, ResultAreaUsed will be set to the total length of the data returned. If ResultAreaLen is insufficient to return the requested information, an error will be returned and ResultAreaUsed will set to the total length required, if the size of the provided ResultArea structure is sufficient to contain this value.
When R_GetInfo detects a parameter list error, it will return SAF return code 8, RACF® return code 12, and RACF reason code nn, where nn indicates the position in the parameter list of the parameter in error. For example, the Num_parms parameter is the eighth parameter in the parameter list, and if an invalid value is supplied for Num_parms, R_GetInfo will return SAF return code 8, RACF return code 12, and RACF reason code 8.
A length of zero can be specified for RACF_entity for Function_code X'0001' and Option X'0001'. In this case, RACF will attempt to determine the userid from the ACEE associated with the current TCB. If there is no ACEE associated with the current TCB, the address space level ACEE will be used. If no userid can be determined, an error will be returned.
When Function_code is X'0001', all CHARACTER values returned in the function specific result data areas for Option X'0001', X'0002', and X'0003' will be terminated by X'00'. For example, if the local registry name is "ABC", the first four bytes of the RegLocal field will contain X'C1C2C300'.
When Function_code is X'0002', all CHARACTER values returned in the function specific result data areas will be terminated by X'00'. The ResultAreaUsed will reflect this extra '00'x byte.