RACROUTE REQUEST=TOKENBLD: Build a UTOKEN

The RACROUTE REQUEST=TOKENBLD macro builds a UTOKEN. The TOKNIN keyword specifies the location of the existing token from which a modified token is to be built. Note that the modification does not change the input token; instead, the function builds a new, modified token from the parameters provided. The TOKNIN keyword is optional; if you want to build a new UTOKEN, the TOKNIN keyword should not be used. The TOKNOUT keyword specifies the location where the new, modified token is to be built.

The following order of priority exists for building the UTOKEN:
  • Keywords specified on the request take precedence over corresponding fields in the TOKNIN and STOKEN parameters.
  • All fields within the token specified by the TOKNIN keyword take precedence over those specified by STOKEN.
  • The fields for the submitter's ID, submitter's group, submit node, execution node, session, port of entry and its class, as obtained from the token specified by the STOKEN keyword, are last.
If you do not want certain fields overridden, do not specify keywords for those fields.

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

To issue the RACROUTE REQUEST=TOKENBLD macro, the calling module must be authorized (APF-authorized, in system key 0-7, or in supervisor state).

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

This function is performed by SAF.