The RACROUTE REQUEST=TOKENMAP macro maps a token in either internal or external format. Internal format is the encoded data format returned from a RACROUTE REQUEST=VERIFYX or a RACROUTE REQUEST=TOKENXTR. External format is the user-readable format that is mapped by the ICHRUTKN macro. See "RUTKN: Resource/User Security Token" in z/OS Security Server RACF Data Areas. RACROUTE REQUEST=TOKENMAP is the only interface used to map token data.

The primary purpose of the RACROUTE REQUEST=TOKENMAP function is to allow a caller to access individual fields within the UTOKEN. The caller needs to provide the proper length and version for the corresponding format version of a token.

To use this service, you must specify RELEASE=1.9 or a later release number.

This function is performed by SAF.

The caller cannot hold locks when issuing RACROUTE REQUEST=TOKENMAP.