z/VM: CP Commands and Utilities Reference - z/VM - IBM

SET TOKEN
SET TOKEN
►►
Set
Authorization
Purpose
TOKen
Operands
Usage Notes
DESC1
cccccccc
DESC2
Privilege Class: B, E
1410 z/VM: CP Commands and Utilities Reference
cccccccc
Use SET TOKen to set the values of the channel subsystem configuration token
description fields.
DESC1 cccccccc
is the value you want assigned to the first description field of the channel
subsystem configuration token. The variable cccccccc must be a 1- to
8-alphanumeric character string. If cccccccc contains blanks you must enclose
the value in single quotes, for example, SET TOKen DESC1 ’name one’. If this
operand is omitted, no change is made to the first description field.
DESC2 cccccccc
is the value you want assigned to the second field of the channel subsystem
configuration token. The variable cccccccc must be a 1- to 8-alphanumeric
character string. If cccccccc contains blanks you must enclose the value in
single quotes, for example, SET TOKen DESC2 ’name two’. If this operand is
omitted, no change is made to the second description field.
1. The SET TOKen command is provided to allow the system programmer to set
the description fields (DESC1 and DESC2) within the hardware I/O-configuration
token. Setting these fields can be useful when you are running z/OS
as either
a guest on VM or in other LPARs on a system where VM is the controlling
logical partition for dynamic-I/O configuration. z/OS uses the DESC1 field as the
high-level dataset-name qualifier of the z/OS I/O-definition files (IODF). They
use the DESC2 field to select which of several IODFs are to be used, with the
DESC2 field taking on values in the form ″IODFnn″, where nn can have a value
from 00 to 99.
By setting the DESC1 and DESC2 fields to the proper values for a z/OS IODF
that is to be used by one or more z/OS guests, these guest operating systems
will automatically select that IODF for their I/O configuration when the guests
are IPLed.
VM itself makes no use of the DESC1 and DESC2 fields.
2. CP puts the machine in configuration mode to change the description fields and
takes the machine out of configuration mode once the changes are made.
Changing the token description fields does not affect the I/O configuration.
3. When issuing SET TOKen, VM must not already be in configuration mode, but
must be enabled for dynamic I/O configuration.
4. The Set TOKen command changes the token for the current (i.e. the running)
I/O configuration, but does not change the token that will be established from
►◄