Spool data set browse token specification - Key = '006E'

DALBRTKN specifies a spool data set browse token that contains information about a JES2 spool data set that a user asks to browse. In addition to parameters about the spool data set, the token also contains parameters that you can use with the security authorization facility (SAF) to check the user's browse authorization.

When you code DALBRTKN, # must be 7. Mapping macro IAZBTOKP maps the length and parameter portion of this text unit. For a description of the IAZBTOKP mapping macro, see z/OS MVS Data Areas in the z/OS Internet library.

Example: Define the spool data set browse token in IAZBTOKP as follows:

BTOK is the name of the spool data set browse token (BTOKID).
1 is the version number of the parameter list for BTOK (BTOKVERNM).
01001302 is the I/O table (IOT) module track record (MTTR) pointer (BTOKIOTP).
A9BC2033 is the spool data set job key (BTOKJKEY).
017E is the ASID of the job that owns the spool data set (BTOKASID).
IBMUSER is the RECVR userid you can use on a SAF call to check the authority of the browse request (BTOKRCID).
DATA SET BROWSE is the LOGSTR data associated with IBMUSER (BTOKLOG5).

KEY   #    LEN1      PARM1  LEN2      PARM2  ...  LEN7     PARM7
006E  007  IAZBTOKP  DSECT  containing the values associated with BTOK

Using the IAZBTOKP field names, the result is:

KEY   #     BTOKPL1  BTOKID    BTOKPL2  BTOKVRNM  BTOKPL3  BTOKIOTP
006E  0007  0004     C2E3D6D2  0002     0001      0004     01001302

            BTOKPL4  BTOKJKEY  BTOKPL5  BTOKASID  BTOKPL6  BTOKRCID
            0004     A9BC2033  0002     017E      0008     C9C2D4E4 C2C5D940

            BTOKPL7  BTOKLOGS
            00FF     0FC4C1E3  C140E2C5 C340C2D9  D6E6E2C5