VMS Help
SHOW, DEVICES

 *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Displays the status of a device on the system.

    See the qualifier descriptions for restrictions.

    Format

      SHOW DEVICES  [device-name[:]]

  1 - Parameter

 device-name[:]

    Specifies the name of a device for which information is to be
    displayed. The device name displayed by the system uses the
    format ddcu where dd is the device code, c is the controller
    designation, and u is the unit number. If the system is part
    of an OpenVMS Cluster that is running with HSC controllers, the
    device name must include the node name using the format node$ddcu
    (where node is the node name).

    You can specify a complete device name or only a portion of
    a device name. The SHOW DEVICES command provides defaults for
    nonspecified portions of device names, as follows:

    o  If you truncate a device name (for example, if you specify D),
       the command lists information about all devices whose device
       names begin with what you entered (in this case, D). However,
       if you specify a device in an OpenVMS Cluster that is running
       with HSC controllers, you must include the entire node portion
       of the device name.

    o  If you omit a controller designation, the SHOW DEVICES command
       lists all devices on all controllers with the specified unit
       number.

    o  If you omit a unit number, the SHOW DEVICES command lists all
       devices on the specified controller.

    Note that the /FILES qualifier does not support defaults for
    nonspecified portions of device names; you must supply a complete
    device specification.

  2 - Qualifiers

 2.1 - /ALLOCATED

    Displays all devices currently allocated to processes.

    If you specify a device name, the characteristics of only that
    device are displayed. If the device is not currently allocated,
    the command displays a message indicating that there is no such
    device. If you specify a generic device name, the characteristics
    of all allocated devices of that type are displayed.

 2.2 - /BRIEF

       /BRIEF (default)

    Displays brief information about the specified devices.

 2.3 - /BITMAP

       /BITMAP ddcu:

    Creates a new table showing all active bitmaps for a given
    device. Included in the display are the size and index number
    of the bitmaps.

    Initially, up to 6 bitmaps can be active on a particular device.

    Note that the SHOW DEVICE/FULL ddcu: display also displays status
    to indicate that bitmaps are active on the device.

 2.4 - /EXACT

    Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a
    search string that must match the search string exactly and must
    be enclosed with quotation marks (" ").

    If you specify the /EXACT qualifier without the /SEARCH
    qualifier, exact search mode is enabled when you set the search
    string with the Find (E1) key.

 2.5 - /FILES

    Requires SYSPRV (system privilege) or BYPASS privileges to list
    read-protected files.

    Displays a list of the names of all files open on a volume and
    their associated process name and process identification (PID).
    The specified device must be a mounted Files-11 volume. If the
    specified volume is a multivolume set, the files on each volume
    in the set are listed.

                                   NOTE

       The SHOW DEVICES/FILES command does not support defaults
       for nonspecified portions of device names. You must supply
       a complete device specification when using the /FILES
       qualifier.

    If the /SYSTEM qualifier is also specified, only the names of
    installed files and files opened by the system are displayed.
    Files opened by the system are those that have been opened
    without the use of an ancillary control process (ACP), such
    as INDEXF.SYS and QUOTA.SYS, as well as system files such as
    JBCSYSQUE.EXE and SYSMSG.EXE.

    If the /NOSYSTEM qualifier is specified, only those files opened
    by processes are displayed. To list files opened by a process in
    your group, your process must have at least GROUP privilege. If
    the process is not in your group, you need WORLD privilege.

    If neither the /SYSTEM nor the /NOSYSTEM qualifier is specified,
    the names of all files currently opened on the system are
    displayed.

    If a file is read-protected from your user identification code
    (UIC), the "No privilege" message is displayed instead of the
    file name. You must have SYSPRV (system privilege) privilege or
    BYPASS privilege to display the file name.

    A space in place of a file name represents a work file (such as
    a temporary edit file) not entered in any directory. To display
    temporary file names, you must have BYPASS privilege in addition
    to GROUP or WORLD privilege.

    Do not use the /FILES qualifier with the /ALLOCATED, /BRIEF,
    /FULL, or /MOUNTED qualifier. The functions of the /FILES
    qualifier and these qualifiers are mutually exclusive.

 2.6 - /FULL

    Displays a complete list of information about the devices, except
    for rebuild status. You must use the /REBUILD_STATUS qualifier to
    get that information.

 2.7 - /HIGHLIGHT

       /HIGHLIGHT[=keyword]

    Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the
    type of highlighting you want when a search string is found. When
    a string is found, the entire line is highlighted. You can use
    the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD
    is the default highlighting.

 2.8 - /MOUNTED

    Displays all devices that currently have volumes mounted on them.

    If you specify a device name, only the characteristics of that
    device are displayed; however, if the device is not currently
    mounted, the command issues a message indicating there is no such
    device. If you specify a generic device name, the characteristics
    of all such devices that currently have volumes mounted are
    displayed.

 2.9 - /MULTIPATH

    Displays all devices that are currently multipath sets.

    If you specify a device name, only the characteristics of that
    device are displayed; however, if the device is not a multipath
    set, the command issues a message indicating there is no such
    device. If you specify a generic device name, the characteristics
    of all such devices that are currently multipath sets are
    displayed.

 2.10 - /OUTPUT

       /OUTPUT[=filespec]
       /NOOUTPUT

    Controls where the output of the command is sent. If you do
    not enter the qualifier, or if you enter the /OUTPUT qualifier
    without a file specification, the output is sent to the current
    process default output stream or device, identified by the
    logical name SYS$OUTPUT.

    If you enter the /OUTPUT qualifier with a partial file
    specification (for example, specifying only a directory), SHOW
    is the default file name and .LIS the default file type. If you
    enter a file specification, it may not include the asterisk (*)
    and the percent sign (%)  wildcard characters.

    If you enter the /NOOUTPUT qualifier, output is suppressed.

 2.11 - /PAGE

       /PAGE[=keyword]
       /NOPAGE (default)

    Controls the display of device information on the screen.

    You can use the following keywords with the /PAGE qualifier:

    CLEAR_SCREEN   Clears the screen before each page is displayed.

    SCROLL         Displays information one line at a time.

    SAVE[=n]       Enables screen navigation of information, where n
                   is the number of pages to store.

    The /PAGE=SAVE qualifier allows you to navigate through screens
    of information. The /PAGE=SAVE qualifier stores up to 5 screens
    of up to 255 columns of information. When you use the /PAGE=SAVE
    qualifier, you can use the following keys to navigate through the
    information:

    Key Sequence              Description

    Up arrow key, Ctrl/B      Scroll up one line.
    Down arrow key            Scroll down one line.
    Left arrow key            Scroll left one column.
    Right arrow key           Scroll right one column.
    Find (E1)                 Specify a string to find when the
                              information is displayed.
    Insert Here (E2)          Scroll right one half screen.
    Remove (E3)               Scroll left one half screen.
    Select (E4)               Toggle 80/132 column mode.
    Prev Screen (E5)          Get the previous page of information.
    Next Screen (E6),         Get the next page of information.
    Return, Enter, Space
    F10, Ctrl/Z               Exit. (Some utilities define these
                              differently.)
    Help (F15)                Display utility help text.
    Do (F16)                  Toggle the display to oldest/newest
                              page.
    Ctrl/W                    Refresh the display.

    The /PAGE qualifier is not compatible with the /OUTPUT qualifier.

 2.12 - /REBUILD_STATUS

    Tells you whether volumes need rebuilding.

    You may need to rebuild a volume if the volume was improperly
    dismounted. Volumes are improperly dismounted when, for example,
    the system crashes.

    For each volume, SHOW DEVICES/REBUILD_STATUS returns one of these
    values:

    Value              Meaning

    Yes                Rebuild needed.
    No                 Rebuild not needed.
    Not applicable     You cannot rebuild this volume. This value is
                       returned if, for example, the volume is not a
                       disk, or the volume is write-locked.
    Information        Rebuild information is unavailable. This value
    unavailable        is returned when, for example, the volume is
                       not mounted, or mount verification is taking
                       place.

    To rebuild a volume, either:

    o  Use SET VOLUME/REBUILD

    o  Dismount the volume, then mount the volume again using
       MOUNT/REBUILD

    You cannot use the /REBUILD_STATUS qualifier with any other SHOW
    DEVICES qualifiers, except /OUTPUT.

 2.13 - /SEARCH

       /SEARCH="string"

    Use with the /PAGE=SAVE qualifier to specify a string that you
    want to find in the information being displayed. Quotation marks
    are required for the /SEARCH qualifier, if you include spaces in
    the text string.

    You can also dynamically change the search string by pressing the
    Find key (E1) while the information is being displayed. Quotation
    marks are not required for a dynamic search.

 2.14 - /SYSTEM

       /SYSTEM
       /NOSYSTEM

    Controls whether the names of installed files and files opened
    by the system are displayed. Files opened by the system are those
    that have been opened without the use of an ancillary control
    process (ACP), such as INDEXF.SYS and QUOTA.SYS.

    If you specify the /NOSYSTEM qualifier with the /FILES qualifier,
    only files opened by processes are displayed. If you omit both
    the /SYSTEM and /NOSYSTEM qualifiers and specify the /FILES
    qualifier, the names of all files currently open on the system
    are displayed.

    You can use this qualifier only with the /FILES qualifier. See
    the description of the /FILES qualifier for more details.

 2.15 - /WINDOWS

    Displays the window count and total size of all windows for files
    open on a volume. The file name and related process name and
    process identification (PID) are also displayed. The letter C
    in a display indicates that the file is open with "cathedral
    windows" (segmented windows).

 2.16 - /WRAP

       /WRAP
       /NOWRAP (default)

    Use with the /PAGE=SAVE qualifier to limit the number of columns
    to the width of the screen and to wrap lines that extend beyond
    the width of the screen to the next line.

    The /NOWRAP qualifier extends lines beyond the width of the
    screen and can be seen when you use the scrolling (left and
    right) features provided by the /PAGE=SAVE qualifier.

  3 - Examples

    1.$ SHOW DEVICES
      Device         Device      Err.    Volume        Free  Trans Mount
       Name          Status     Count     Label       Blocks Count Count
      DKA0:          Online mnt     0  VMS             47088   115     1
      DKA1:          Online mnt     0  USERPACK1       45216     2     1
      DKA2:          Online mnt     3  DOCUMENT         8068    20     1
      DKA5:          Online mnt     0  MASTERP         28668     1     1
      DKA6:          Online         0
      DKA7:          Online mnt     0  PROJECT        110547     1     1
      DMA0:          Online         0
      DLA0:          Online         0
      DYA0:          Online         0
      DYA1:          Online         0
      DRA3:          Online mnt     0  RES26APR        29317     1     1

      In this example, the SHOW DEVICES command displays the
      following information for each device on the system:

      o  Device name

      o  Device status and characteristics (status indicates whether
         the device is on line; characteristics indicate whether the
         device is allocated, is spooled, has a volume mounted on it,
         or has a foreign volume mounted on it)

      o  Error count

      o  Volume label (for disk and tape volumes only)

      o  Number of free blocks on the volume

      o  Transaction count

      o  Number of mount requests issued for the volume (disk devices
         only)

    2.$ SHOW DEVICE/FULL DKB0:

      Disk $DKB0:, device type RZ56, is online, mounted, file-oriented
          device, shareable, error logging is enabled.

      Error count               0  Operations completed            392750
      Owner process            ""  Owner UIC                        [1,4]
      Owner process ID   00000000  Dev Prot           S:RWPL,O:RWPL,G:R,W
      Reference count         317  Default buffer size                512
      Total blocks        1299174  Sectors per track                   54
      Total cylinders        1604  Tracks per cylinder                 15

      Volume label  "SYSTEM_DISK"  Relative volume number               0
      Cluster size              3  Transaction count                  278
      Free blocks          367632  Maximum files allowed           162396
      Extend quantity           5  Mount count                          1
      Mount status         System  Cache name      "$DKB0:XQPCACHE"
      Extent cache size        64  Maximum blocks in extent cache   36763
      File ID cache size       64  Blocks currently in extent cache 36258
      Quota cache size          0  Maximum buffers in FCP cache       210
      Volume owner UIC      [1,1]  Vol Prot   S:RWCD,O:RWCD,G:RWCD,W:RWCD

      Volume status:  ODS-2, subject to mount verification, protected
           subsystems enabled, file high-water marking, write-through
           caching enabled.

      In this example, the SHOW DEVICES command requests a full
      listing of the status of the RZ56 device DKB0.

    3.$ SHOW DEVICES/REBUILD_STATUS

      Device Name             Rebuild needed?

      ADU15$DKA300:           Information unavailable
      EDIV$DKA300:            Information unavailable
      EMUL$DKB200:            No
      EMUL$DKB300:            No
      EMUL$DKB500:            Yes
      FTA0:                   Not applicable
      OPA0:                   Not applicable

      In this example, the volume mounted on device EMUL$DKB500 needs
      rebuilding.

    4.$ SHOW DEVICES/FULL NODE2$
      Disk NODE2$DUA0:, device type RA81, is online, mounted,
      error logging enabled
       Error count                 0  Operations completed            24195
       Owner UIC            [11,177]  Owner process name
       Owner process ID     20200000  Dev Prot  S:RWPL,O:RWPL,G:RWPL,W:RWPL
       Reference count            16  Default buffer size               512
       Volume label        VMSDOCLIB  Relative volume no.                 0
       Cluster size                3  Transaction count                  17
       Free blocks            525447  Maximum files allowed          111384
       Extend quantity             5  Mount count                         1
       Volume status          System  ACP process name
       Caching disabled
      Volume is subject to mount verification, file high-water marking

      Disk NODE2$DUA1:, device type RA81, is online, error logging enabled
       Error count                 0  Operations completed                0
       Owner UIC               [0,0]  Owner process name
       Owner process ID     20200000  Dev Prot  S:RWED,O:RWED,G:RWED,W:RWED
       Reference count             0  Default buffer size               512
         .
         .
         .

      In this example, the user requested a full display of
      information about each device on NODE2 in the OpenVMS Cluster.
      Information is shown here only for the first two devices: a
      mounted device and a device that is not mounted.

    5.$ SHOW DEVICE $1$DKB1:/FULL

      Disk $1$DKB1: (VMSRMS), device type RRD40, is online, allocated,
      deallocate on dismount, mounted, software write-locked, file-oriented
      device, shareable, served to cluster via MSCP Server

      Error count                  0  Operations completed               15
      Owner process         "_FTA5:"  Owner UIC                       [1,4]
      Owner process ID      2020005D  Dev Prot          S:RWPL,O:RWPL,G:R,W
      Reference count              2  Default buffer size               512
      Total blocks               256  Sectors per track                  32
      Total cylinders              1  Tracks per cylinder                 8
      Allocation class             1

      Volume label        "VOLUME_1"  Relative volume number             64
      Cluster size                 0  Transaction count                   1
      Free blocks                  0  Maximum files allowed               0
      Extend quantity              0  Mount count                         1
      Mount status           Process  ACP process name           "DAD2CACP"

      Volume status:  ISO 9660.
      Members of this volume set are $1$DKB7: (rvn 64), $1$DKB4: (rvn 8),
      $1$DKB1: (rvn 1), $1$DKB12: (rvn 4096), $1$DKB16: (rvn 65535),
      $1$DKB6: (rvn 32).

      In this example, the user requested a full display on a
      VAX system of a device contained on a member of an ISO 9660
      partially mounted volume set. Note the volume status displays
      the media format as ISO 9660, and the volume set list shows a
      sparce list of the currently mounted members of the volume set.

    6.$ SHOW DEVICES MUA1/FULL

      Magtape $4$MUA1: (HSC70), device type TA79, is online, device is
       equipped with a stacker/loader, file-oriented device, available
       to cluster, error logging is enabled.

       Error count               0  Operations completed                  0
       Owner process            ""  Owner UIC                      [SYSTEM]
       Owner process ID   00000000  Dev Prot            S:RWPL,O:RWPL,G:R,W
       Reference count           0  Default buffer size                2048
       Density                1600  Format                        Normal-11
       Host name           "HSC70"  Host type, avail              HS70, yes
       Allocation class          4

      Volume status:  no-unload on dismount, odd parity.

      In this example, the user requested a full display of the tape
      device MUA1.

    7.$ SHOW DEVICE/FULL $1$DKA221

      Disk $1$DKA221: (HSC952), device type RZ29, is online, mounted,
          file-oriented device, shareable, available to cluster, error
          logging is enabled.

       Error count               0  Operations completed               6509
       Owner process            ""  Owner UIC                      [SYSTEM]
       Owner process ID   00000000  Dev Prot            S:RWPL,O:RWPL,G:R,W
       Reference count         108  Default buffer size                 512
       Current preferred CPU Id  1  FastPath                              1
       Total blocks        8380080  Sectors per track                     4
       Total cylinders       65470  Tracks per cylinder                  32
       Host name          "HSC952"  Host type, avail              HS95, yes
       Allocation class          1

       Volume label  "GALAXY_X6L5"  Relative volume number                0
       Cluster size              4  Transaction count                   302
       Free blocks         4691760  Maximum files allowed            838008
       Extend quantity           5  Mount count                           2
       Mount status         System  Cache name        "_$1$DKA221:XQPCACHE"
       Extent cache size        64  Maximum blocks in extent cache   469176
       File ID cache size       64  Blocks currently in extent cache 237504
       Quota cache size          0  Maximum buffers in FCP cache       1734
       Volume owner UIC      [1,1]  Vol Prot    S:RWCD,O:RWCD,G:RWCD,W:RWCD

      Volume Status:  ODS-2, subject to mount verification, protected
          subsystems enabled, file high-water marking, write-through
          caching enabled.
      Volume is also mounted on MEAD.

      This disk is a device that performs its I/O through the Fast
      Path port PNA0. Fast Path is enabled for this disk, and its
      I/O will be processed on the preferred CPU, CPU 1, which is
      associated with its Fast Path port PNA0.

      The /FULL qualifier also displays additional information about
      Fast Path devices. A Fast Path device may be either a class
      device or a port device. An example of a class device is an
      HSC disk, and an example of a port device is the CI. For both
      Fast Path class devices and ports, the display indicates that
      Fast Path is enabled and lists the current CPU ID to which that
      device is assigned. Additionally, for a Fast Path port, the
      display indicates the port's user-established CPU preference
      (if any).

      The current preferred CPU and the User Preferred CPU can be
      set by using the DCL command, SET DEVICES/PREFERRED_CPU, or by
      issuing a $QIO.

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

    8.$ SHOW DEVICE/FULL PNA0

      Device PNA0:, device type CIXCD, is online, shareable, error logging
          is enabled.

       Error count                 0  Operations completed              0
       Owner process              ""  Owner UIC                  [SYSTEM]
       Owner process ID     00000000  Dev Prot          S:RWPL,O:RWPL,G,W
       Reference count             0  Default buffer size               0
       Current preferred CPU Id    1  FastPath                          1

      The above display shows that port PNA0 is assigned to CPU 1 and
      that Fast Path is enabled.

    9.$ SHOW DEVICE/FULL PNA0

      Device PNA0:, device type CIXCD, is online, shareable, error logging
      is enabled.

       Error count                   0  Operations completed             0
       Owner process                ""  Owner UIC                 [SYSTEM]
       Owner process ID       00000000  Dev Prot         S:RWPL,O:RWPL,G,W
       Reference count               0  Default buffer size              0
       Current preferred CPU Id      1  FastPath                         1
       User preferred CPU Id         2

      This example shows a Fast Path assignment made by a user.

      Normally, the User Preferred CPU ID matches the current
      preferred CPU ID. The reason for the mismatch in the above
      display is because CPU 2 was stopped. The port was previously
      assigned to CPU 2. But when CPU 2 was stopped, the operating
      system moved the port assignment from CPU 2 to CPU 1.

      If CPU 2 were started, the operating system would assign the
      device to the User Preferred CPU.

    10$ SHOW DEVICE/FULL DSA0

      Disk DSA0:, device type RAM Disk, is online, mounted, file-oriented
        device, shareable, available to cluster, error logging is enabled,
        device supports bitmaps (no bitmaps active).

       Error count                 0  Operations completed               47
       Owner process              ""  Owner UIC                    [SYSTEM]
       Owner process ID     00000000  Dev Prot          S:RWPL,O:RWPL,G:R,W
       Reference count             2  Default buffer size               512
       Total blocks             1000  Sectors per track                  64
       Total cylinders             1  Tracks per cylinder                32
      Volume label           "TST0"  Relative volume number              0
       Cluster size                1  Transaction count                   1
       Free blocks               969  Maximum files allowed             250
       Extend quantity             5  Mount count                         1
       Mount status           System  Cache name    "_$252$DUA721:XQPCACHE"
       Extent cache size          64  Maximum blocks in extent cache     96
       File ID cache size         64  Blocks currently in extent cache    0
       Quota cache size            0  Maximum buffers in FCP cache      404
       Volume owner UIC     [SYSTEM]  Vol Prot  S:RWCD,O:RWCD,G:RWCD,W:RWCD

       Volume Status:  ODS-2, subject to mount verification, file high-water
           marking, write-back caching enabled.

      Disk $252$MDA0:, device type RAM Disk, is online, member of shadow set DSA0:.

       Error count                 0  Shadow member operation count    128
       Allocation class          252

      Disk $252$MDA1:, device type RAM Disk, is online, member of shadow set DSA0:.

       Error count                 0  Shadow member operation count    157
       Allocation class          252

      This example shows that a write bitmap exists for a shadow set,
      and that no write bitmap is active. If a shadow set supports
      write bitmaps, "device supports bitmaps" is displayed along
      with either "bitmaps active" or "no bitmaps active". If the
      device does not support write bitmaps, no message pertaining to
      write bitmaps is displayed.

    11$ SHOW DEVICE/BITMAP DSA1
      Device         BitMap     Size         Percent of
      Name            ID       (Bytes)       Full Copy
      DSA12:         00010001   652          11%

      This example shows a SHOW DEVICE/BITMAP display. You can find
      out the ID of each write bitmap on a node with this command.
      The /BITMAP qualifier is similar to the /REBUILD qualifier
      in that neither can be combined with most other SHOW DEVICE
      qualifiers. The SHOW DEVICE/BITMAP display can be brief or
      full; brief is the default.

      If no bitmap is active, no bitmap file ID is displayed. The
      phrase "no bitmaps active" is displayed.

4 - /SERVED

    Displays information on devices served by the mass storage
    control protocol (MSCP) server on this node. The /SERVED
    qualifier is required.

    Format

      SHOW DEVICES/SERVED

 4.1 - Qualifiers

 4. 1.1 - /ALL

    This qualifier displays the information displayed by all of the
    qualifiers listed below except the /OUTPUT qualifier.

 4. 1.2 - /COUNT

    Displays the number of transfer operations completed, sorted by
    the size of the transfers, and the number of MSCP operations that
    have taken place since the MSCP server was started.

 4. 1.3 - /EXACT

    Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a
    search string that must match the search string exactly and must
    be enclosed with quotation marks (" ").

    If you specify the /EXACT qualifier without the /SEARCH
    qualifier, exact search mode is enabled when you set the search
    string with the Find (E1) key.

 4. 1.4 - /HIGHLIGHT

       /HIGHLIGHT[=keyword]

    Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the
    type of highlighting you want when a search string is found. When
    a string is found, the entire line is highlighted. You can use
    the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD
    is the default highlighting.

 4. 1.5 - /HOST

    Displays the names of the processors that have MSCP served
    devices on line. The System Generation utility (SYSGEN) command
    MSCP/HOST determines how many hosts in the OpenVMS Cluster can
    connect to the MSCP server at one time.

 4. 1.6 - /OUTPUT

       /OUTPUT=[filespec]

    Redirects output from your terminal to the specified file. If
    you do not specify a file, or if you do not use this qualifier,
    output is sent to SYS$OUTPUT.

 4. 1.7 - /PAGE

       /PAGE[=keyword]
       /NOPAGE (default)

    Controls the display of device information on the screen.

    You can use the following keywords with the /PAGE qualifier:

    CLEAR_SCREEN   Clears the screen before each page is displayed.

    SCROLL         Displays information one line at a time.

    SAVE[=n]       Enables screen navigation of information, where n
                   is the number of pages to store.

    The /PAGE=SAVE qualifier allows you to navigate through screens
    of information. The /PAGE=SAVE qualifier stores up to 5 screens
    of up to 255 columns of information. When you use the /PAGE=SAVE
    qualifier, you can use the following keys to navigate through the
    information:

    Key Sequence              Description

    Up arrow key, Ctrl/B      Scroll up one line.
    Down arrow key            Scroll down one line.
    Left arrow key            Scroll left one column.
    Right arrow key           Scroll right one column.
    Find (E1)                 Specify a string to find when the
                              information is displayed.
    Insert Here (E2)          Scroll right one half screen.
    Remove (E3)               Scroll left one half screen.
    Select (E4)               Toggle 80/132 column mode.
    Prev Screen (E5)          Get the previous page of information.
    Next Screen (E6),         Get the next page of information.
    Return, Enter, Space
    F10, Ctrl/Z               Exit. (Some utilities define these
                              differently.)
    Help (F15)                Display utility help text.
    Do (F16)                  Toggle the display to oldest/newest
                              page.
    Ctrl/W                    Refresh the display.

    The /PAGE qualifier is not compatible with the /OUTPUT qualifier.

 4. 1.8 - /RESOURCE

    Displays information about the resources available to the MSCP
    server for use in processing I/O requests for the devices it
    serves.

    You make these resources available by using the following system
    parameters: MSCP_BUFFER, MSCP_CREDITS, MSCP_LOAD, and MSCP_SERVE_
    ALL.

    Refer to OpenVMS Cluster Systems or SYSGEN online help for more
    information.

 4. 1.9 - /SEARCH

       /SEARCH="string"

    Use with the /PAGE=SAVE qualifier to specify a string that you
    want to find in the information being displayed. Quotation marks
    are required for the /SEARCH qualifier, if you include spaces in
    the text string.

    You can also dynamically change the search string by pressing the
    Find key (E1) while the information is being displayed. Quotation
    marks are not required for a dynamic search.

 4.2 - Examples

    1.$ SHOW DEVICES/SERVED
             MSCP-Served Devices on BIAK 28-MAY-2001 13:48:01.32

                                                   Queue Requests
      Device:           Status     Total Size     Current    Max    Hosts
          11$DUA8       Online        2376153           0      2        6
          11$DUA9        Avail        2376153           0      0        0
          11$DUA10      Online        2376153           0      2        8
          11$DUA11      Online        2376153           0      2        7
          11$DUA13      Online        2376153           0      2        7
          11$DUA14       Avail        2376153           0      0        0
          11$DUA16       Avail        2376153           0      0        0
          11$DUS16       Avail        2376153           0      1        0
          11$DUA17       Avail        2376153           0      0        0
          11$DUA18      Online        2376153           0      1        4
          11$DUA19      Online        2376153           0      4        7
          11$DUA20      Online        2376153           0      1        7
          11$DUA21      Online        2376153           0     17       12

      This example shows the output generated by the command
      SHOW DEVICES/SERVED. The first column in the display shows
      the names of the devices that are served by the MSCP server.
      The second column shows the status of the devices. The third
      column shows the size, in blocks, of the device.

      The Queue Requests columns show the number of I/O requests
      currently awaiting processing by that device and the maximum
      number of I/O requests that have ever been concurrently
      awaiting processing by that device. The last column in the
      display shows the number of hosts that have the device on line.

    2.$ SHOW DEVICES/SERVED/COUNT
             MSCP-Served Devices on BIAK 28-MAY-2001 13:49:52.41
        .
        .
        .
      Request Count:
           0-7:   951154        32-39:     2168        88-103:     1618
          8-15:   197224        40-55:     2543       104-127:      189
         16-23:   137707        56-71:     8343
         24-31:      982        72-87:      141

      Operations Count:
         ABORT             0   ERASE          22772   READ        1042206
         ACCESS            0   FLUSH              0   REPLACE           0
         AVAILABLE       611   GET COM STS        0   SET CTL CHR     176
         CMP CTL DAT       0   GET UNT STS  4026024   SET UNT CHR    3630
         CMP HST DAT       0   ONLINE           427   WRITE        259953
         Total       5355799

      This example shows the information displayed by the SHOW
      DEVICES/SERVED/COUNT command. The numbers to the left of the
      colon (:),  separated by a hyphen (-), are the size, in pages,
      of the requests. The numbers to the right of the colon are the
      number of requests of that size that have been processed by the
      MSCP server.

      The section of the display headed by the label Operations Count
      shows the number of times the MSCP server has performed the
      MSCP operations listed. In the example, this MSCP server has
      performed 176 set-controller-characteristics (SET CTL CHR)
      operations, and has performed 3630 set-unit-characteristics
      (SET UNT CHR) operations.

    3.$ SHOW DEVICES/SERVED/RESOURCE
             MSCP-Served Devices on BIAK 28-MAY-2001 13:51:32.01
        .
        .
        .
      Resources:         Total      Free      In Use
          Buffer Area:     400       400           0
          I/O Packets:       0         0

                       Current   Maximum
          Buffer Wait:       0         0

      This example shows the information displayed by the SHOW
      DEVICES/SERVED/RESOURCE command. The Total column shows the
      total number of pages in the buffer area and in the number of
      I/O-request packets set aside for use by the MSCP server. The
      Free column shows the number of pages in the buffer and the
      number of I/O-request packets that are available for use.

      The In Use column shows the number of pages within the buffer
      area that are in use.

      The line labeled Buffer Wait shows the number of I/O requests
      that are currently waiting for buffer space to become available
      for their use, and the maximum number of I/O requests that have
      waited concurrently to obtain a buffer.

    4.$ SHOW DEVICES/SERVED/HOST
             MSCP-Served Devices on BIAK 28-NOV-2001 13:54:41.99
        .
        .
        .
                                                 Queue Requests
      Host:              Time of Connection      Current    Max   Devices
          IPL31       25-MAY-2001 21:44:06.44          0      1         0
          DELAND      25-MAY-2001 21:44:09.98          0      1         0
          HEAVEN      25-MAY-2001 22:03:15.67          0      7        10
          VIVA        26-MAY-2001 09:44:11.96          0      1         0
        .
        .
        .

      This example shows the information displayed by the SHOW
      DEVICES/SERVED/HOST command. The first column contains the
      names of the hosts that have class drivers connected to the
      MSCP server. The next column contains the times at which these
      connections were made.

      The columns under the heading Queue Requests show the number
      of requests the MSCP server currently has outstanding for I/O
      activity on the devices it serves, the maximum number of such
      requests that have been outstanding at one time, and the number
      of MSCP server devices that the listed hosts have on line.

    5.$ SHOW DEVICES/SERVED
             MSCP-Served Devices on HEN  3-DEC-2001 09:09:08.49
                                               Queue Requests
      Device:          Status    Total Size    Current   Max  Hosts
         254$DJB1       Avail             0          0     0      0
         254$DUA2      Online       1216665          0     0      1
         254$DUA4006    Avail             0          0     0      0

            TMSCP-Served Devices on HEN  3-DEC-2001 09:09:08.74
                                               Queue Requests
      Device:          Status     Position     Current   Max  Hosts
         90$MUA7        Avail             0          0     0      0
         90$MUA8        Avail             0          0     0      0
         90$MUA50      Online          3804          0     0      0

      This example displays the output of the SHOW DEVICES/SERVED
      command from a node that has both MSCP server and TMSCP server
      devices. In the display, the third column for MSCP server disk
      devices shows the size of the disk device. The same column
      for TMSCP server device shows the location where each tape is
      currently positioned.
  Close     HLB-list     TLB-list     Help  

[legal] [privacy] [GNU] [policy] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.