DEDICATE

Read syntax diagramSkip visual syntax diagramDIRMaintPrefix Keywords1 DEDicate vdev DELETEKEEPlinksDASD OptionsTape OptionsOther Options
DASD Options
Read syntax diagramSkip visual syntax diagramrdevVOLIDvolidVOLIDvolidR/ONOQIOASSIST
Tape Options
Read syntax diagramSkip visual syntax diagram rdev R/O SINGLEUSERMULTIUSERNOASSIGNNOQIOASSIST
Other Options
Read syntax diagramSkip visual syntax diagram rdev NOQIOASSIST USERACCESSIDuserid
Notes:
  • 1 For more information on prefix keywords, see the DIRMAINT EXEC.

Purpose

Use the DEDICATE operand of the DIRMAINT command to add or delete an existing DEDICATE statement.

Operands

vdev
is the virtual address associated with the DEDICATE statement.
DELETE
means that the specified DEDICATE directory control statement should be deleted.
KEEPlinks
specifies that the links to the deleted volume are to be kept. This allows for replacement of the deleted volume without having to reestablish the links.
rdev
is the real device number.
VOLID
specifies that the value following it is a volume label.
volid
is the volume label of a disk pack mounted on a real disk storage device. It must be 1 to 6 characters from the following list: A-Z, 0-9, #, @, $, :, - and +. If volid is less than 5 characters, the VOLID keyword is required to distinguish it from an rdev address.
R/O
specifies that the virtual device is to be in read-only mode.
SINGLEUSER
specifies a tape device to a single user.
MULTIUSER
specifies attach a tape device to multiple users so that the device can be serially shared.

This operand must be specified on the dedicate statement by all users who intend on sharing the device. If a user logs on and has a dedicate statement for a device without this operand, the device becomes dedicated to that user and can not be attached MULTIUSER by anyone until the device is detached. This operand is valid only for 3480, 3490, and 3590 tape devices.

NOASSIGN
indicates that the attach process should not issue an assign channel command for this user.
NOQIOASSIST
indicates the device is not eligible for Queued-I/O Assist.
USERACCESSID userid
indicates that FCP logical unit number (LUN) access should be given to the specified userid. z/VM® will store the userid into the subchannel, and the adapter will use these stored names to correlate I/O requests with the rules in the access control table (ACT) and allow access to the LUNs based on those rules.

Usage Notes

  1. You may use one or more of the prefix keywords (REQuest, TOsys, ASuser, BYuser, PRESET, FORuser, ATnode, NODIRectxa) with this command. These prefix keywords may be specified in any order, but each keyword may only be specified once.
  2. For more information on the DEDICATE directory statement see z/VM: CP Planning and Administration.
  3. If more than one virtual machine has a dedicate statement for a given real device, only the first virtual machine to log on receives control of the device.
  4. All options are not available on all releases of VM.