HP OpenVMS DCL Dictionary
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
Description
The SHOW DEVICES/SERVED command displays information about the MSCP
server and the devices it serves. This information is used mostly by
system managers. The following message displays when the user issues a
SHOW DEVICE/SERVED command when the tape server is not loaded:
%SHOW-E-TMSCPNOTLD, TMSCP-Server code not loaded
|
Qualifiers
/ALL
This qualifier displays the information displayed by all of the
qualifiers listed below except the /OUTPUT qualifier.
/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.
/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.
/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.
/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.
/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.
/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), Return, Enter, Space
|
Get the next page of information.
|
|
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.
/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 HP OpenVMS Cluster Systems or SYSGEN online help for more information.
/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.
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.
| 
