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

CPACCESS
►►
CPACcess
Authorization
Purpose
Operands
userid
vdev
fm
SR
mode
Privilege Class: A
ASYNChronous
SYNChronous
Use CPACCESS to identify a CMS-formatted minidisk to CP and to make the files
on that minidisk available to CP by establishing a file mode letter for the files.
Before you can tell CP to link a minidisk, you must have the authority to access that
minidisk. You do not have to actually link to or access the minidisk; you only need
the capability to do so without specifying a password.
You can also do this by using the CP_ACCESS statement in the system
configuration file. For more information about this statement, see the z/VM: CP
Planning and Administration book.
userid
specifies the user ID of the owner of the minidisk that you want to make
available to CP.
vdev
is the virtual device number of the specified user’s minidisk, as defined in the
user’s entry in the system directory. The address can be any hexadecimal
number between X'0000' and X'FFFF'.
fm is the file mode letter that you want to assign to all files on the specified
minidisk. You can specify any letter from A to Z.
CPACCESS
mode
is the access mode. Valid modes are:
ER
Exclusive read-only access. CP establishes read access unless a user has
an existing access to this disk. CP denies all requests for access to a disk
with an existing exclusive mode.
EW
Exclusive write access. CP establishes write access unless a user has an
existing access (any mode) to the disk. CP denies all requests for access to
a disk with an existing exclusive mode access.
Note: An EXCLUSIVE access (ER, EW) is a stable access with the added
restriction that no one else has, or can get access to, the specified
minidisk until the access is released.
M Multiple-write access. CP establishes write access unless a user has an
existing write, stable, or exclusive mode access to the disk.
MR
Multiple-write access. CP establishes write access unless a user has an
existing write, stable, or exclusive mode access to the disk. If a previous
►◄
Chapter 2. CP Commands 79