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.
- 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.
- Action