HELPLIB.HLB  —  SET  DEVICE
    Establishes a print device or terminal as a spooled device or
    establishes the operational status for a device.

    To make a disk on a local node available to all the nodes on an
    OpenVMS Cluster, use the /SERVED qualifier.

    Requires OPER (operator) privilege.

    PHY_IO (physical I/O) privilege is required when specifying the
    Alpha-only qualifiers that change the characteristics of shadow
    sets. These qualifiers also can be specified using the SET SHADOW
    command, which provides additional options for controlling shadow
    sets. Qualifier settings for shadow sets remain in effect until
    they are changed using either SET DEVICE or SET SHADOW or until
    the shadow set or shadow set member is dismounted. If the shadow
    set is remounted or a shadow set member is returned to the shadow
    set from which it was dismounted, the settings must be specified
    again. For more information about volume shadowing, see the VSI
    Volume Shadowing for OpenVMS.

    Format

      SET DEVICE  [device-name[:]]

1  –  Parameter

 device-name[:]

    Specifies the name of the device whose spooling or operational
    status is to change. The device must be a print device or a
    terminal if you want to change the spooling status; the device
    must be a disk or magnetic tape if you want to change the
    operational status.

    When you specify qualifiers that act on shadow sets, the device
    might be a shadow set member (ddcu:) or the whole shadow set
    (DSAnnnn:), as noted in the qualifier format. Depending on the
    qualifier, if no device name is supplied, the qualifier applies
    to all shadow sets mounted on the node from which the command is
    executed.

2  –  Description

    When you specify any of the following qualifiers, the operational
    status of the drive is changed: /ABORT_VIRTUAL_UNIT, /AVAILABLE,
    /COPY_SOURCE, /DUAL_PORT, /ENABLE, /ERROR_LOGGING, /FORCE_
    REMOVAL, /MEMBER_TIMEOUT, /MVTIMEOUT, /POLL, /READ_COST, /SITE,
    or /SWITCH.

    When you specify the /SPOOLED qualifier, program output that uses
    OpenVMS Record Management Services (RMS) or file control system
    (FCS) and that specifies the print device name is written onto
    an intermediate disk rather than written directly to the print
    device or terminal.

3  –  Qualifiers

3.1    /ABORT_VIRTUAL_UNIT

       /ABORT_VIRTUAL_UNIT DSAnnnn: (Alpha/Integrity servers only)

    Aborts mount verification on a shadow set.

    Use this qualifier when you know that the unit cannot be
    recovered. When you use this qualifier, the shadow set must be
    in mount verification. The shadow set aborts mount verification
    immediately on the node from which the command is issued. If the
    shadow set is not in mount verification, this command returns the
    error %SYSTEM-E-UNSUPPORTED, unsupported operation or function.

    After this command completes, the shadow set still must be
    dismounted. Use the following command to dismount the shadow
    set:

    $ DISMOUNT/ABORT DSAnnnn:

3.2    /AVAILABLE

       /AVAILABLE
       /NOAVAILABLE

    Controls whether the specified disk or magnetic tape is to be
    considered available. You must dismount the specified disk
    or magnetic tape before entering the SET DEVICE/[NO]AVAILABLE
    command. If you specify the /NOAVAILABLE qualifier, any attempt
    to allocate or mount the specified disk or magnetic tape is
    prevented. Devices are automatically set /AVAILABLE when brought
    online even if the device had been previously set /NOAVAILABLE.

3.3    /COPY_SOURCE

       /COPY_SOURCE {ddcu: | DSAnnnn:} (Alpha/Integrity servers only)

    Specifies which source member of a shadow set will be used as
    the source for read data during full copy operations when a third
    member is added to the shadow set. This qualifier affects only
    copy operations that do not use disk copy data (DCD) commands.

    Some storage controllers, such as the HSG80, have a read-ahead
    cache, which significantly improves single-disk read performance.
    Copy operations normally alternate reads between the two source
    members, which effectively nullifies the benefits of the read-
    ahead cache. This qualifier lets you force all reads from a
    single, specified source member for a copy operation.

    If only a shadow set (DSAnnnn:) is specified, all reads for
    full copy operations will be performed from the disk that is
    the current "master" member, regardless of physical location of
    the disk.

    If a shadow set member (ddcu:) is specified, that member will
    be used as the source of all copy operations. This allows you to
    choose a local source member, rather than a remote master member.

3.4    /DUAL_PORT

       /DUAL_PORT
       /NODUAL_PORT

    Controls whether the port seize logic in the device driver of
    the specified disk is to be enabled. This qualifier should be
    used only on disks that contain a dual port kit and have been
    dismounted.

3.5    /ENABLE

       /ENABLE
       /NOENABLE

    Enables or disables a path to a multipath device; the affected
    path is the one named in the /PATH qualifier. All paths are
    initially enabled; the current path cannot be disabled.

3.6    /ERROR_LOGGING

       /ERROR_LOGGING
       /NOERROR_LOGGING

    Controls whether device errors are logged in the error log file.
    When you specify the /ERROR_LOGGING qualifier, all error messages
    reported by the device on which error logging is enabled are
    recorded in the error log file. Use the SHOW DEVICE/FULL command
    to find out the current status.

3.7    /FORCE_REMOVAL

       /FORCE_REMOVAL ddcu: (Alpha/Integrity servers only)

    Expels the specified shadow set member from the shadow set.

    If connectivity to a device has been lost and the shadow set is
    in mount verification, this qualifier causes the member to be
    expelled from the shadow set immediately.

    If the shadow set is not currently in mount verification, no
    immediate action is taken. If connectivity to a device has
    been lost but the shadow set is not in mount verification, this
    qualifier lets you flag the member to be expelled from the shadow
    set, as soon as it does enter mount verification.

    The specified device must be a member of a shadow set that is
    mounted on the node where the command is issued.

3.8    /LOG

       /LOG
       /NOLOG (default)

    Controls whether log information is displayed at the terminal.

3.9    /MEMBER_TIMEOUT

       /MEMBER_TIMEOUT=n ddcu: (Alpha/Integrity servers only)

    Specifies the timeout value to be used for a shadow set member.

    The value supplied by this qualifier overrides the system
    parameter SHADOW_MBR_TMO for this specific device. Each member
    of a shadow set can be assigned a different MEMBER_TIMEOUT value.

    The valid range for n is 1 to 16777215 seconds.

    The specified device must be a member of a shadow set that is
    mounted on the node where the command is issued.

3.10    /MV_INTVL

       /MV_INTVL=n

    Overrides the systemwide setting of the MVSUPMSG_INTVL system
    parameter with the value specified by n (seconds) for the
    specified device only. If /MV_INTVL=0, the value for MVSUPMSG_
    INTVL is used instead. If MVSUPMSG_INTVL=0 or MVSUPMSG_NUM=0,
    all mount verifications are announced. For more information about
    MVSUPMSG_INTVL, see Sys_Parameters online help.

3.11    /MV_NUM

       /MV_NUM=n

    Overrides the systemwide setting of the MVSUPMSG_NUM system
    parameter with the value specified by n (seconds) for the
    specified device only. If /MV_NUM=0, the value for MVSUPMSG_NUM
    is used instead. If MVSUPMSG_NUM=0 or MVSUPMSG_INTVL=0, all mount
    verifications are announced. For more information about MVSUPMSG_
    NUM, see Sys_Parameters online help.

3.12    /MVTIMEOUT

       /MVTIMEOUT=n DSAnnnn: (Alpha/Integrity servers only)

    Specifies the mount verification timeout value to be used for the
    shadow set specified by its virtual unit name (DSAnnnn:).

    The value supplied by this qualifier overrides the value
    specified by the system parameter MVTIMEOUT for this specific
    shadow set.

                                   NOTE

       You cannot change the value of MVTIMEOUT for a system disk.
       Any attempt to do so results in an error.

    The valid range for n is 1 to 16777215 seconds.

    The specified shadow set must be mounted on the node where the
    command is issued.

3.13    /PATH

       /PATH=path-description-string

    (For multipath devices only) Specifies a particular route to
    the device. The path description string identifies a path from
    the host to the device (for example, PGA0.2343-A855-BC99-876F or
    PKC0.5). Wildcard characters have no special meaning. The path
    description can be abbreviated to the minimum unique string.

    Note that this qualifier does not imply that any action be
    taken. To take action, you must also specify one of the following
    qualifiers: /(NO)ENABLE, /(NO)POLL, or /SWITCH.

3.14    /POLL

       /POLL
       /NOPOLL

    Specifies that the path specified by the /PATH qualifier is to be
    polled for continued availability as a path switch destination.
    This does not affect any attempt to switch to this path. Its
    purpose is only to inform an operator that a path may or may not
    be viable as a path switch destination. By default, all device
    paths are enabled for polling when they are discovered. Note that
    this qualifier applies only to multipath devices.

3.15    /PREFERRED_CPUS

       /PREFERRED_CPUS=cpu-a[,cpu-b,cpu-c,...]
       /NOPREFERRED_CPUS

    Allows you to specify a CPU or a set of candidate CPUs from
    which the operating system chooses the CPU to assign to the Fast
    Path port. The chosen CPU is called the preferred CPU for this
    Fast Path port. The Fast Path port's interrupt I/O completion
    processing and I/O initiation processing are performed on this
    preferred CPU.

    In addition to selecting the preferred CPU, the User Preferred
    CPU is set for this port. Setting the User Preferred CPU prevents
    the port from being reassigned to another CPU unless the User
    preferred CPU is being stopped. The qualifier can be negated.
    When the /NOPREFERRED_CPUS qualifier is specified, the User
    Preferred CPU is cleared for the port, but it remains a Fast
    Path port, and the current preferred CPU is not changed.

    If both /PREFERRED_CPUS and /NOPREFERRED_CPUS are specified on
    the same command line, /NOPREFERRED_CPUS is ignored.

    If Fast Path is enabled, you can use the DCL command, SHOW
    DEVICE/FULL, to display the current preferred CPU and the User
    Preferred CPU.

    For more information about using Fast Path features to improve
    I/O performance, see the VSI OpenVMS I/O User's Reference Manual.

3.16    /READ_COST

       /READ_COST=n {ddcu: | DSAnnnn:} (Alpha/Integrity servers only)

    Enables you to modify the default cost assigned to each shadow
    set member (ddcu:). By modifying the assignments, you can bias
    the reads in favor of one member of a two-member shadow set,
    or, in the case of three-member shadow sets, in favor of one or
    two members of the set over the remaining members. The device
    specified must be a shadow set or member of a shadow set that is
    mounted on the node where the command is issued.

    The valid range for the specified cost is 1 to 65,535 units.

    The shadowing driver assigns default READ_COST values to shadow
    set members when each member is initially mounted. The default
    value depends on the device type and its configuration relative
    to the system mounting it. The following list of device types
    is ordered by the default READ_COST assignments, from the lowest
    cost to the highest cost:

    o  DECram device

    o  Directly connected device in the same physical location

    o  Directly connected device in a remote location

    o  DECram served device

    o  Default value for other served devices

    The value supplied by the /READ_COST qualifier overrides the
    default assignment. The shadowing driver adds the value of the
    current queue depth of the shadow set member to the READ_COST
    value and then reads from the member with the lowest value.

    Different systems in the cluster can assign different costs to
    each shadow set member.

    When this qualifier specifies a shadow set (DSAnnnn:) instead
    of a shadow set member, the /READ_COST qualifier switches the
    read cost setting for all shadow set members back to the default
    read cost settings established automatically by the shadowing
    software. The specified shadow set must be mounted on the node
    where the command is issued. In this case, the value specified
    for the cost can be any number because it will be ignored.

    If the /SITE command qualifier has been specified, the shadowing
    driver takes site values into account when it assigns default
    READ_COST values. In order for the shadowing software to
    determine whether a device is in the category of "directly
    connected device in a remote location," the /SITE command
    qualifier must have been applied to both the shadow set and the
    shadow set member.

    Reads requested for a shadow set from a system at site 1 are
    performed from a shadow set member that is also at site 1. Reads
    requested for the same shadow set from site 2 can read from the
    member located at site 2.

3.17    /RESET

       /RESET=(keyword[,keyword])

    Requires CMKRNL and DIAGNOSE privileges.

    Resets either or both the error count and the operation count for
    a device. You must specify one or both of the following keywords:

    ERROR_COUNT    Resets the error count.

    OPERATION_     Resets the operation count.
    COUNT

    When either count is reset, a message is sent to the error log.
    The message indicates that the count was reset and includes the
    value of the counter before the reset.

3.18    /SITE

       /SITE=n {DSAnnnn: | ddcu:} (Alpha/Integrity servers only)

    Indicates to the shadowing driver the site location of the
    specified shadow set (DSAnnnn:) or shadow set member (ddcu:). If
    the member is removed from the shadow set and later is returned,
    this qualifier must be specified again.

    The SHADOW_SITE_ID system parameter defines the default site
    location of the shadow set. You can override the default location
    of the shadow set with the /SITE qualifier.

    The valid range for the site location, represented by n, is 1
    through 255.

    After you apply this qualifier, the setting remains in effect
    until you change it either with this command or with the SET
    SHADOW/SITE command.

    This qualifier can improve read performance because the member
    that is physically local to the system will be the preferred disk
    from which to read, provided that you specify the /SITE qualifier
    for each shadow set member and for the shadow set. (In a Fibre
    Channel configuration, shadow set members at different sites
    are directly attached to the system. For the Volume Shadowing
    and cluster software, there is no distinction between local and
    remote in multiple-site Fibre Channel configurations.)

3.19    /SPOOLED

       /SPOOLED[=(queue-name[:],intermediate-disk-name[:])]
       /NOSPOOLED

    Controls whether files are spooled to an intermediate disk.

    The queue name indicates the printer queue to which a file is
    queued. If a queue name is not supplied, the default is the name
    of either the printer or terminal.

    The intermediate disk name identifies the disk to which the
    spooled files are written. If the intermediate disk name is not
    supplied, the default is SYS$DISK (the current default disk). The
    intermediate disk must be mounted before files can be written to
    it.

    Once the device has been set spooled to a disk, that disk cannot
    be dismounted until the spooled device is set to /NOSPOOLED.
    All channels must be deassigned from a print device before its
    spooling characteristics can be changed. Also, the queue that is
    assigned to the device must be stopped.

3.20    /SWITCH

    Attempts to switch from the current path of a multipath device
    to the path named in the /PATH qualifier. The path switch
    is attempted only if the path has not been disabled by SET
    DEVICE/NOENABLE. The path switch is initiated but not completed
    before returning control to the user; use SHOW DEVICE/MULTIPATH
    to verify that the path switching has completed successfully.

    This command requires the OPER privilege. Additionally, if the
    device is currently allocated by another process, as tape devices
    often are, the SHARE privilege is needed.

4  –  Examples

    1.$ SET DEVICE/SPOOLED=(LPA0)  LPA0:

      In this example, the /SPOOLED qualifier requests that the
      printer queue LPA0 be spooled to an intermediate disk before
      files directed to the disk are printed. Because no intermediate
      disk was specified, the intermediate disk defaults to SYS$DISK.

    2.$ SET DEVICE/ERROR_LOGGING  DKB2:

      The SET DEVICE command in this example requests that all device
      errors reported on device DKB2 be logged in the error log file.

    3.$ SET DEVICE/NOAVAILABLE DRA0:

      The SET DEVICE command in this example prevents any attempt to
      mount a disk on device DRA0.

    4.$ SET DEVICE/DUAL_PORT DRA0:

      The SET DEVICE command in this example enables the dual port
      seize logic in device DRA0.

    5.$ SET DEVICE/PREFERRED_CPU=1 PNA0

      The Fast Path port PNA0 is assigned to CPU 1, and the User
      Preferred CPU is set to 1.

    6.$ SET DEVICE/NOPREFERRED_CPU  PNA0

      The port PNA0 will have the User Preferred CPU cleared,
      but will remain a Fast Path port, with CPU 1 as its current
      preferred CPU.

    7.$ SET DEVICE/PREFERRED_CPU=(0,1,2)  PNA0

      The operating system selects CPU 0,1, or 2 as the preferred CPU
      for Fast Path port PNA0, and sets its User Preferred CPU to the
      selected CPU.

    8.$ SET DEVICE $1$DGA1001:/PATH=PGB0.0123-4567-89AB-CDEF/ENABLE

      In this example, a request is made to enable path
      PGB0.0123-4567-89AB-CDEF as a switch path destination. No error
      is indicated if the path was in the enabled state prior to the
      request. Had the /NOENABLE option been used, the path would
      have been removed from switch path consideration.

    9.$ SET DEVICE $1$DGA1001:/PATH=PGB0.0123-4567-89AB-CDEF/POLL

      In this example, a request is made to enable path
      PGB0.0123-4567-89AB-CDEF for polling of its continued
      availability as a path switch destination. Had the /NOPOLL
      option been used, the path would have been removed from path
      availability polling consideration.

    10$ SET DEVICE $1$DGA1001:/PATH=PGB0.0123-4567-89AB-CDEF/SWITCH

      In this example, a request is made to switch from the current
      path to path PGB0.0123-4567-89AB-CDEF. Should the path fail,
      the switch algorithm of the unspecified path is used.

    11$ ! Command sequence used on system 1 at site 1:
      $ MOUNT/SYSTEM DSA0:/SHADOW=($1$DGA0:,$1$DGA1:) TEST
      $ SET DEVICE/SITE=1  DSA0:
      $ !
      $ ! Command sequence used on system 2 at site 2:
      $ MOUNT/SYSTEM DSA0:/SHADOW=($1$DGA0:,$1$DGA1:) TEST
      $ SET DEVICE/SITE=2  DSA0:
      $ !
      $ ! Commands used on both system 1 and system 2:
      $ SET DEVICE/SITE=1  $1$DGA0:
      $ SET DEVICE/SITE=2  $1$DGA1:

      In this example, the system at site 1 will perform all reads
      from $1$DGA0, which is the physically local disk, while the
      system at site 2 will perform all reads from its physically
      local disk, $1$DGA1.

5    /SERVED

    Makes a disk on a local node available to all the nodes in an
    OpenVMS Cluster.

    Applies only to OpenVMS Cluster environments.

    You cannot use the SET DEVICE/SERVED command under the following
    conditions:

    o  In service of a Phase II shadow set virtual unit

    o  On devices that are already mounted

    o  On system disks

    o  On quorum disks

    Format

      SET DEVICE/SERVED  node-name$DDcu:

5.1  –  Parameter

 node-name$DDcu:

    Specifies the device name of the device that you want to make
    available to the cluster.

5.2  –  Example

  $ SET DEVICE/SERVED DRA4:

      The SET DEVICE/SERVED command in this example instructs the
      MSCP server to make the disk device DRA4 on your local node
      available to all other processors on your cluster.
Close Help