NAME subcommand — translate an STOKEN

Use the NAME subcommand to identify the address space, data space, or subspace related to an STOKEN, and return the ASID and name associated with the space.

IPCS can identify the data space for an STOKEN if the data space is accessible in the dumped environment; storage from the data space does not need to be dumped to enable the identification.

Related subcommands
- SELECT

Syntax

  NAME       STOKEN(value)

              [ LIST | NOLIST]
              [ CLIST (QUALIFICATION(variable-name))  ]
              [ DIALOG (QUALIFICATION(variable-name)) ]
              [ REXX (QUALIFICATION(variable-name))   ]

-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.

              [ ACTIVE | MAIN | STORAGE          ]
              [ DSNAME(dsname) | DATASET(dsname) ]
              [ FILE(ddname) | DDNAME(ddname)    ]
              [ PATH(path-name)     ]
              [ FLAG(severity) ]
              [ PRINT | NOPRINT ]
              [ TERMINAL | NOTERMINAL ]
              [ TEST | NOTEST ]

Parameter
STOKEN(value)

Specifies the 8-byte STOKEN value of the address space, data space, or subspace you want to identify. When you specify STOKEN, use the IPCS rules for expressing general values; see General values.

LIST or NOLIST

LIST indicates that a report is to be generated. LIST is the default. NOLIST suppresses the generation of a report.

CLIST(QUALIFICATION(variable-name))

DIALOG(QUALIFICATION(variable-name))

REXX(QUALIFICATION(variable-name))

Specifies where IPCS is to store the unedited value of STOKEN. variable-name specifies the name of the variable into which the information is stored. If the token cannot be successfully resolved by the NAME subcommand, no change is made to the specified command procedure variable.
CLIST directs that the value be stored in CLIST variable storage.

DIALOG directs that the value be stored in ISPF function pool dialog variable storage.

REXX directs that the value be stored in REXX variable storage.
Return Codes
See Standard subcommand return codes for a description of the return codes produced by the NAME subcommand.
Example: Obtain the name of the address space, data space, or subspace associated with the hexadecimal STOKEN value, 11223344 55667788.
- Action
```
COMMAND ===> name stoken(x'11223344 55667788')
```
- Result
  NAME produces a listing that displays the address space, data space, or subspace associated with the hexadecimal STOKEN value, 11223344 55667788.