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

CPACCESS
Usage Notes
80 z/VM: CP Commands and Utilities Reference
write or stable access exists, CP establishes read-only access. If an
exclusive mode access exists, access is denied.
MW
Multiple-write access. CP establishes write access in all cases except when
a user has an existing stable or exclusive mode access to the disk.
Note: A stable access means that the user holding the (SR, SW, or SM)
access can be assured that the disk remains stable, unchanged by
others, until the access is released.
R Read-only access. CP establishes read access unless a user has an
existing write or exclusive mode access to the disk.
RR
Read-only access. CP establishes read access unless a user has an
existing exclusive mode access.
SM
Stable multiple access. CP establishes write access unless a user holds a
write, a stable, or an exclusive mode access to this disk. CP denies all
requests for write access to a disk with an existing SM mode access.
SR
Stable read-only access. CP establishes read access unless a user has an
existing write or exclusive mode access to this disk. CP denies all requests
for write access to a disk with an existing SR mode access. SR is the
default.
SW
Stable write access. CP establishes write access unless a user has an
existing access (any mode) to this disk. CP denies all requests for write
access to a disk with an existing SW mode access.
W Write access. CP establishes write access unless a user has an existing
access (any mode) to the disk.
WR
Write access. CP establishes write access unless a user has an existing
access (any mode) to the disk. If write access is denied, CP establishes
read access unless another user has an existing exclusive mode access for
the disk.
ASYNChronous
tells CP to schedule the command and lets you enter other commands before
the CPACCESS command completes. When the CPACCESS command
completes, CP displays a 1-line response, such as:
CPACCESS request for userid’s vdev in mode mode completed
ASYNCHRONOUS is the default.
SYNChronous
tells CP to process the command immediately and does not allow you to enter
any other commands until the CPACCESS command completes.
1. Even though CP may establish write access to a minidisk (for example, by using
the link mode MW), CP itself does not write to the minidisk.
2. When you enter the CPACCESS command and specify a file mode letter that
CP is using for another minidisk, CP releases the first minidisk and accesses
the minidisk you specified.
3. If the specified minidisk contains files that will be used frequently, you should
either:
v Issue the CPCACHE command to cache each file into storage.