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

|
|
|
|
|
|
|
|
Usage Notes
existing write, stable, or exclusive mode link to the disk. In the case of a
previous write or stable link, a read-only link is established. In the case
of an exclusive mode link existing, the link is denied.
MW Multiple-write link. A write link is established in all cases except when
another user has an existing stable or exclusive mode link to the disk.
Note: A stable link means that the user holding the (SR, SW or SM)
link can be assured that the disk remains stable, unchanged by
others, until the link is released.
SR Stable read-only link. A read link is established unless another user has
an existing write or exclusive mode link to this disk. All requests for a
write link to a disk with an existing SR mode link are denied.
SW Stable write link. A write link is established unless another user has an
existing link (any mode) to this disk. All requests for a write link to a
disk with an existing SW mode link are denied.
SM Stable multiple link. A write link is established unless another user holds
either a write, a stable or an exclusive mode link to this disk. All
requests for a write link to a disk with an existing SM mode link are
denied.
Note: An EXCLUSIVE link (ER, EW), is a stable link with the added
restriction that no one else has, or can get a link to, the specified
minidisk until the link is released.
ER Exclusive read-only link. A read link is established unless another user
has an existing link to this disk. All requests for links to a disk with an
existing exclusive mode link are denied.
EW Exclusive write link. A write link is established unless another user has
an existing link (any mode) to the disk. All requests for links to a disk
with an existing exclusive mode link are denied.
If you do not specify a mode, the default is R if you are linking to another user’s
device. If you are linking to one of your own devices, the default is the user link
mode specified in your entry in the system directory.
Attention:
v Permanent data loss can result if more than one user is writing to the same
virtual disk.
v Unpredictable results can occur when one user has a read-only link to a disk
that is being updated by another user who has a write link to the disk.
password
is a 1-character to 8-character string that matches the link mode password
defined for device vdev1 in the system directory entry for the user ID that you
specify. If you do not specify a password but one is required, you are prompted
for one.
To determine whether password suppression is active for this command, use
the QUERY PASSWORD LINK command. If password suppression is active,
you cannot specify a password on the command line. See usage note 11 on
page 512.
1. SET IMSG OFF suppresses informational messages for this command.
LINK
Chapter 2. CP Commands 511