HELPLIB.HLB  —  SHOW  DEVICES  /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

1  –  Qualifiers

1.1    /ALL

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

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.

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.

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.

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.

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.

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.

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.

    See the VSI OpenVMS Cluster Systems or SYSGEN online help for more
    information.

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.

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$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 Help