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

DEFINE CU / CNTLUNIT
OPEN_SYStems_adapter
OSA
tells CP that this control unit connects to an Open Systems Adapter (OSA),
OSA-direct-express (OSD), or OSA-express (OSE) channel path.
Notes:
1. Before you have a working OSA configuration, you should define the
channel paths, the device, and the control unit. See the Planning for the
System/390 Open Systems Adapter Feature GC23-3890.
2. Only 1 CU per OSA CHPID per logical partition is allowed.
CF
tells CP that this control unit connects to coupling facility channel paths.
Coupling facility channel paths include coupling facility sender (CFS), coupling
facility receiver (CFR), coupling facility peer (CFP), cluster bus sender (CBS),
cluster bus receiver (CBR), cluster bus peer (CBP), or internal coupling peer
(ICP) channel paths.
UNIT_Address nn
UNIT_Address nn-nn
UNITADD nn
UNITADD nn-nn
is the last 2 digits of a device address or number (or a range of addresses or
numbers). Each nn must be a 1- to 2-digit hexadecimal number between X'00'
and X'FF'.
LINK_address aa
LINK_address ddaa
LINK_address *
Each link-address value you specify identifies a port on a destination switch
(ESCON or FICON director) to which the control unit is connected.
The LINK_address operand must be specified when one or more of the channel
paths to the control unit are switched paths; that is, when any of the paths
traverse an ESCON or FICON director and for an ESCON director the path
through the director is not dedicated. When all of the channel paths are
unswitched (including dedicated paths through an ESCON director), the
LINK_address operand is optional.
For an unswitched FICON channel path, the end nodes determine the link
addresses used at each end. Thus you cannot specify a numeric link address to
be used. If you specify a LINK_address operand value for an unswitched
FICON channel path (e.g., because other paths to the control unit are switched
and a ″placeholder″ value is required), you must specify an asterisk (*) as the
link-address value.
When any link addresses are required to be specified (i.e., when one or more of
the channel paths is a switched path), you must provide a link address for each
channel-path identifier (PATH or CHPID) that you specified, in the same order.
When no link addresses are required to be specified (i.e., when all of the
channel paths are unswitched paths), the link address for each ESCON channel
path is determined by the hardware processor, and the link address for each
FICON channel path is negotiated between the hardware endpoints.
The link address is a one or two digit hexadecimal value for control units
connected to an ESCON channel. The link address is a one, two, three, or four
digit hexadecimal value for control units connected to a FICON channel.
Leading zeroes can be omitted, except that an actual dd value of zero (see
below) must be specified with at least one digit.
Chapter 2. CP Commands 151