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

DEFINE CFLINK
DEFINE CFLINK
►►
DEFine
Authorization
Purpose
Operands
CFLINK
Usage Notes
msgprocid1
VDEVice
Privilege Class: A, B, G
122 z/VM: CP Commands and Utilities Reference
vdev
msgprocid2
DEVICES 2
DEVices
DEFINE CFLINK allows a coupled guest or system operator to create links between
coupling facilities.
msgprocid1
specifies the sending coupling facility user ID for the new link.
vdev
specifies the device number of the first message device in the sending coupling
facility. This must be a hexadecimal number from X'0000' to X'FFFE'.
msgprocid2
specifies the receiving coupling facility for the new link.
DEVices n
specifies the number of message devices that the sending virtual machine
(coupling guest or coupling facility) can process; n must be between 2 and 8.
The default is 2.
1. A class G only user must be coupled to both the sending and receiving coupling
facilities. There also must either be no SPECIAL MSGP statements in the
msgprocid1 directory entry, or msgprocid2 must appear on one of the SPECIAL
MSGP statements in the msgprocid1 directory entry.
2. A class A or class B user can couple any two coupling facilities regardless of
whether they are coupled to the coupling facilities in question and regardless of
the presence of SPECIAL MSGP statements in the sending coupling facility’s
directory entry.
3. A coupling facility can have links to up to seven other coupling facilities.
4. There can be up to two links (channel path IDs) from msgprocid1 (the sender)
to msgprocid2 (the receiver). In the sender, the first link uses the next available
channel path ID in range (E0..E6) and the second uses the next available
channel path ID in range (A0..A6). In the receiver, the first link uses the next
available channel path ID in range (F0..F6) and the second uses the next
available channel path ID in range (B0..B6).
5. The vdev chosen must be a hexadecimal number low enough for the addition of
vdev plus the number of DEVICES minus 1 with a result less than or equal to
X'FFFF'.
6. Device numbers X'vdev' and X'vdev' plus the number of DEVICES minus 1
must be available in the sending coupling facility.
n
►◄