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

MODIFY CHPID / PATH
Usage Notes
596 z/VM: CP Commands and Utilities Reference
CONDITIONAL_DELete
tells CP that you want to delete one or more logical partitions from the list of
logical partitions that have access to this channel path in the specified or
implied channel-subsystem image, but only if the channel path is not presently
in use and configured to the logical partition.
DELete_partition
tells CP that you want to delete one or more logical partitions from the list of
logical partitions that have access to this channel path in the specified or
implied channel-subsystem image, regardless of whether the channel path is in
use or configured to one or more logical partitions.
ADD_CSS_access
tells CP that you want to add the channel path to the specified
channel-subsystem image. See Usage Note 1.
RCSS nn
is the reference channel-subsystem image from which the channel-path
characteristics are to be copied. The variable nn must be a 1- to 2-digit
hexadecimal number between X'00' and X'0F'. Your machine is likely to support
less.
INITial_access pname
specifies the name(s) of the logical partition(s) that will have initial access to
this channel path in the specified or implied channel-subsystem image. The
maximum number of logical partition names you can specify depends on the
capabilities of your processor. Each pname must be a 1- to 8-digit character
alphanumeric string.
ACCess_list pname
specifies the name(s) of the logical partition(s) for which access to this channel
path is being added or deleted in the specified or implied channel-subsystem
image. The maximum number of logical partition names you can specify
depends on the capabilities of your processor. If you are deleting the logical
partitions from the access list, those logical partitions must already be in the
access list for this channel path in the specified or implied channel-subsystem
image. Each pname must be a 1- to 8-digit character alphanumeric string.
DELETE_CSS_access
tells CP that you want to delete the channel path from the specified the
channel-subsystem image. See Usage Note 2.
1. On a machine with multiple logical channel-subsystem images, the DEFINE
PATH and DEFINE CHPID commands first define the channel path in the
single specified channel-subsystem image. If the channel path is a type that
can span multiple logical channel-subsystem images, then MODIFY PATH or
MODIFY CHPID commands must be entered for each additional
channel-subsystem image in which you want to define the channel path.
2. On a machine with multiple logical channel-subsystem images, the DELETE
CHPID and DELETE PATH commands are effective only for channel paths in a
single channel-subsystem image. To delete channel paths that are in more
than one channel-subsystem image, you must first enter MODIFY CHPID or
MODIFY PATH commands to remove all but one channel-subsystem image.
Then a DELETE CHPID or DELETE PATH command can be entered.
3. After successfully entering this command, you will have changed the software’s
view of the I/O configuration and part of the hardware’s view: the active I/O
configuration in the hardware system area (HSA). You should also change the