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

DEFINE MSGPROC
DEFINE MSGPROC
►►
DEFine
Authorization
Purpose
Operands
MSGProc
Usage Notes
msgprocid
VDEVice
Privilege Class: G
178 z/VM: CP Commands and Utilities Reference
vdev
DEVICES 4
DEVices n
SINGLE_message_path
Use the DEFINE MSGPROC command to define a virtual message processor and
associated message devices in the issuer’s virtual I/O configuration. This command
establishes a coupling connection between a CFUSER defined user ID and the
specified CF Service Machine running under z/VM.
msgprocid
specifies the user ID of a z/VM Virtual Machine that is defined to run as a
Coupling Facility. CP will establish a coupling connection between the user ID
that issues this command and the user ID specified by msgprocid.
VDEVice vdev
is the virtual device number of the base message device that you are defining
to CP. The device number must be a 1 to 4 digit hexadecimal number between
X'0000' and X'FFFC'. The virtual device number specified will be the first of four
consecutive device numbers created. If the specified device number is not valid
or if it or any of the next three consecutive device numbers are already defined,
this command will fail.
DEVices n
specifies the number of message devices to be created in the coupling guest.
The number of devices (n) must be an even number between 4 and 16
inclusive; the default is 4.
SINGLE_message_path
will force only a single message path to be created for each message device.
By default this command will create two message paths per message
subchannel. Specifying SINGLE will turn off multi-path simulation when
communicating with the Message Processor being defined.
1. The user must be authorized to issue this command via the CFUSER operand
on the OPTION Directory Control Statement in the user directory. Without
authorization, the MSGProc operand is rejected as not valid.
2. If SPECIAL directory statements were used to define message processors for
the user, then the user may specify only those msgprocids on the DEFINE
MSGPROC command. Specifying a msgprocid not defined by the SPECIAL
directory entry will cause the operand to be rejected as not valid. The
SPECIAL directory statement allows the system administrator to restrict which
message processors that a user is allowed to define.
►◄