SET TOKEN

Authorization

Privilege Class: B, E

Purpose

Use SET TOKen to set the values of the channel subsystem configuration token description fields.

Operands

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 quotation marks, 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 quotation marks, for example, SET TOKen DESC2 'name two'. If this operand is omitted, no change is made to the second description field.

Usage Notes

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.
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.
When issuing SET TOKen, VM must not already be in configuration mode, but must be enabled for dynamic I/O configuration.
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 the IOCDS (I/O-configuration data set) at the next power-on reset (POR) of your machine. To make the same change to the active IOCDS (i.e. the IOCDS that will be used at the next POR), you must do the following:
1. Run the IOCP program, specifying all of the options you normally specify, including WRTxx (to write the newly-generated IOCDS into the machine).
2. Issue the Set IOCDS_active command to make the new IOCDS the active IOCDS (i.e. the IOCDS to be used at the next POR).

Examples

To change the first description field to 'IOCONFIG' and the second description field to 'IODF43', enter:

set token desc1 ioconfig desc2 iodf43
The channel subsystem configuration token was set as requested
Ready;

Messages

HCP6805E Cannot find RDEV for TYPE 1 subchannel
HCP6806E Dynamic I/O change request failed with return code nnnn
HCP6808E System disabled for dynamic I/O changes. The VM configuration token does not match the hardware configuration token.
HCP6808E System disabled for dynamic I/O changes. The dynamic I/O support was disabled at the service console.
HCP6809E This processor does not support dynamic I/O changes
HCP6815E Command failed in the channel subsystem
HCP6815E Cannot find configuration token in the system
HCP6816E Dynamic I/O changes are not allowed on this system
HCP6850E Cannot set system configuration token. A dynamic I/O change is in progress.
HCP6850E Cannot set system configuration token. System is in configuration mode.
HCP6851E I/O configuration cannot be changed because VM is not the controlling partition.