Keywords › DATA Keyword with WHOHAS—Interpret Resource Name

DATA Keyword with WHOHAS—Interpret Resource Name

Valid on z/OS and z/VM.

Use the DATA keyword with the TSS WHOHAS function to indicate if CA Top Secret interprets a resource name literally or as a mask.

When used with WHOHAS, this keyword has the following format:

TSS WHOHAS resclass(resname)
           DATA(MASK|NOPREFIX|LITERAL)

LITERAL

Specifies an exact match, regardless of the presence of masking characters. Matching permission must be a literal match both by character and by length.

MASK

Interprets masking characters for keyword(value) in the TSS WHOHAS command. Normally, masking characters are interpreted only in permissions encountered. Ignored except for resources with ATTR(MASK).

Not all resources support masking characters.

NOPREFIX

Restrict search to keyword(value) in the security record whose length matches or exceeds the length of the keyword(value) in the command. Masking characters in PERMIT is expanded but treated as a single character.

If no DATA options are specified, all matching prefixes are displayed and any masks coded on the command are not expanded.

Note: When used with the TSS WHOHAS function, the DATA keyword can only be used with the MASK, LITERAL, and NOPREFIX operands. These operands cannot be used when the DATA keyword is issued on a function other than WHOHAS.

This keyword is used with the commands ADMIN, DEADMIN, LIST, and WHOHAS.

Examples: DATA keyword

This example shows all permits:

TSS WHOHAS DSNAME(SYS2.)
   DATASET     = SYS2.                                 OWNER(DEPT2)
   XAUTH       = SYS2.*                                 ACID(USER0)
   ACCESS      = READ
   XAUTH       = SYS2.++                                ACID(USER0)
   ACCESS      = READ
   XAUTH       = SYS2.PARMLIB                           ACID(USER0)
   ACCESS      = READ
   XAUTH       = SYS2.PARM                              ACID(USER0)
   ACCESS      = READ

   TSS0300I  WHOHAS   FUNCTION SUCCESSFUL

This example shows all permits that match exactly the resource name entered on the TSS WHOHAS command:

TSS WHOHAS DSNAME(SYS2.PARM) DATA(LITERAL)
    DATASET    = SYS2.                                 OWNER(DEPT2)
    XAUTH      = SYS2.PARM                              ACID(USER0)
    ACCESS     = READ

    TSS0300I  WHOHAS   FUNCTION SUCCESSFUL   

TSS WHOH DSNAME(SYS2.*) DATA(LITERAL)
    DATASET    = SYS2.                                 OWNER(DEPT2)
    XAUTH      = SYS2.*                                 ACID(USER0)
    ACCESS     = READ
    TSS0300I  WHOHAS   FUNCTION SUCCESSFUL

This example shows all permits that match the masking pattern of the resource name entered on the TSS WHOHAS command:

TSS WHOHAS DSNAME(SYS2.*) DATA(MASK)
    DATASET    = SYS2.                                 OWNER(DEPT2)
    XAUTH      = SYS2.*                                 ACID(USER0)
    ACCESS     = READ
    XAUTH      = SYS2.++                                ACID(USER0)
    ACCESS     = READ
    XAUTH      = SYS2.PARMLIB                           ACID(USER0)
    ACCESS     = READ
    XAUTH      = SYS2.PARM                              ACID(USER0)
    ACCESS     = READ
    TSS0300I  WHOHAS   FUNCTION SUCCESSFUL

This example shows all permits with prefixes that are equal to or longer than the resource name entered on the TSS WHOHAS command. Shorter permits are ignored

TSS WHOHAS DSNAME(SYS2.P) DATA(NOPREFIX)
    DATASET    = SYS2.                                 OWNER(DEPT2)
    XAUTH      = SYS2.*                                 ACID(USER0)
    ACCESS     = READ
    XAUTH      = SYS2.++                                ACID(USER0)
    ACCESS     = READ
    XAUTH      = SYS2.PARMLIB                           ACID(USER0)
    ACCESS     = READ
    XAUTH      = SYS2.PARM                              ACID(USER0)
    ACCESS     = READ
    TSS0300I  WHOHAS   FUNCTION SUCCESSFUL
    TSS WHOH DSN(SYS2.PARM) DATA(NOPREFIX)
    DATASET    = SYS2.                                 OWNER(DEPT2
    XAUTH      = SYS2.PARMLIB                           ACID(USER0)
    ACCESS     = READ
    XAUTH      = SYS2.PARM                              ACID(USER0)
    ACCESS     = READ
    TSS0300I  WHOHAS   FUNCTION SUCCESSFUL
    TSS WHOH DSN(SYS2.PARMLIB) DATA(NOPREFIX)
    DATASET    = SYS2.                                 OWNER(DEPT2)
    XAUTH      = SYS2.PARMLIB                           ACID(USER0)
    ACCESS     = READ

    TSS0300I  WHOHAS   FUNCTION SUCCESSFUL