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.
See the VSI 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$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.