RACROUTE Request Formats

The following parameters are common to all RACROUTE requests (except REQUEST=VERIFYX, which does not use ECB1 and ECB2):

RACROUTE REQUEST=AUTH  (or REQUEST=DEFINE)
         ,RELEASE=1.9
         ,ENTITYX=address of file/external object/alias/directory/command
name
         ,USERWRD=address of user data structure
         ,USERID=address of requesting user ID
         ,WORKA=address of 512-byte work area
         ,ECB1=address of event control block 1
         ,ECB2=address of event control block 2

If SFS sets the new security token information indicator to Y on the CSL call and passes an ESM security token and an ESM information buffer address (see exit routine parameters 20, 21, and 22), the authorization checking routine calls the following RACROUTE call to generate new ESM information for the requesting user ID and security token:

RACROUTE REQUEST=VERIFYX
         ,RELEASE=1.9
         ,ENTITYX=address of file/external object/alias/directory/command
name
         ,USERWRD=address of user data structure
         ,USERID=address of requesting user ID
         ,WORKA=address of 512-byte work area
         ,SECLABEL=security token
         ,TOKNOUT=address of ESM information buffer

After RACROUTE REQUEST=VERIFYX successfully fills in the ESM information buffer with the generated information, it resets the new security token information indicator to N.

The ESM information buffer is then passed as an additional parameter (UTOKEN) on subsequent RACROUTE REQUEST=AUTH calls:

RACROUTE REQUEST=AUTH
         ,RELEASE=1.9
         ,ENTITYX=address of file/external object/alias/directory/command
name
         ,USERWRD=address of user data structure
         ,USERID=address of requesting user ID
         ,WORKA=address of 512-byte work area
         ,ECB1=address of event control block 1
         ,ECB2=address of event control block 2
         ,UTOKEN=address of ESM information buffer