| Previous | Contents | Index |
Displays the status of a device on the system.See the qualifier descriptions for restrictions.
SHOW DEVICES [device-name[:]]
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:
- 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.
- If you omit a controller designation, the SHOW DEVICES command lists all devices on all controllers with the specified unit number.
- 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.
When you enter the SHOW DEVICES command without specifying a device or using any qualifier, information about all devices on the system is displayed. If you specify a device name, the SHOW DEVICES command displays information about that device. If you use certain qualifiers with the SHOW DEVICES command, information is displayed about those devices that currently have volumes mounted or that have been allocated to processes, or both.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).
If you enter the SHOW DEVICES command and do not specify a device name parameter or a qualifier, the command provides a brief listing of characteristics of all devices on the system, with the exception of pseudodevices with the mailbox characteristic, such as MBA3:, NLA0:, NET9:, and so on. To display such a device, you must specify all or part of the device name.
Note
If a field width is too narrow to display a particular numeric field, asterisks are displayed in place of the data. Therefore, if asterisks appear in the Free Space field while displaying a particular device, use the /UNITS or /SIZE qualifier to display the free space in bytes.
/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.
/BRIEF (default)
Displays brief information about the specified devices./BITMAP ddcu:
Displays information regarding minicopy or HBMM (Host-Based Minimerge) bitmaps for the given shadow set;
Note that the SHOW DEVICES/FULL ddcu: display also displays status to indicate that bitmaps are active on the device.
/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.
/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.
/FULL
Displays a complete list of information about the devices, as appropriate, except for rebuild status. You must use the /REBUILD_STATUS qualifier to get that information.Note that you cannot use the /UNITS or /SIZE qualifier with the /FULL qualifier.
The display will be in blocks or bytes, depending on the current system default setting. You can use SHOW PROCESS/UNITS to display the current default. To change the default, execute the DCL command SET PROCESS/UNITS=BYTES or SET PROCESS/UNITS=BLOCKS.
For more information about fields related to Dissimilar Device Shadowing (DDS) or Dynamic Volume Expansion (DVE) in the display, see the discussion of these topics in the HP OpenVMS System Manager's Manual.
/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./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.
/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.
/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.
/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.
/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 unavailable Rebuild information is unavailable. This value is returned when, for example, the volume is not mounted, or mount verification is taking place. To rebuild a volume, either:
- Use SET VOLUME/REBUILD
- 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.
/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.
/SIZE=keyword
Allows you to override the current default specified by SET PROCESS/UNITS so that you can display disk free space in your choice of blocks or bytes. (/SIZE is functionally equivalent to /UNITS.)The following keywords are valid with the /SIZE qualifier: BLOCKS, BYTES.
If you specify /SIZE with no keyword, the default value is not changed.
Note that you cannot use the /SIZE qualifier with the /FULL qualifier.
/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.
/UNITS=keyword
Allows you to override the current default specified by SET PROCESS/UNITS so that you can display disk free space in your choice of blocks or bytes. (/UNITS is functionally equivalent to /SIZE.)The following keywords are valid with the /UNITS qualifier: BLOCKS, BYTES.
If you specify /UNITS with no keyword, the default value is not changed.
Note that you cannot use the /UNITS qualifier with the /FULL qualifier.
/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)./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.
| #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:
- Device name
- 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)
- Error count
- Volume label (for disk and tape volumes only)
- Number of free blocks on the volume
- Transaction count
- Number of mount requests issued for the volume (disk devices only)
| #2 |
|---|
$ SHOW DEVICES /FULL $1$dga30
Disk $1$DGA100: (EUROS), device type HP MSA VOLUME, is online, mounted, file-
oriented device, shareable, available to cluster, error logging is enabled.
Error count 0 Operations completed 17299
Owner process "" Owner UIC [SYSTEM]
Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G:R,W
Reference count 3 Default buffer size 512
Current preferred CPU Id 0 Fastpath 1
Total blocks 488327805 Sectors per track 96
Total cylinders 52987 Tracks per cylinder 96
Logical Volume Size 488327805 Expansion Size Limit 941752320
Host name "EUROS" Host type, avail HP rx2600 (900MHz/1.5MB), yes
Allocation class 1
Volume label "DEBUG-DISK1" Relative volume number 0
Cluster size 480 Transaction count 2
Free blocks 16558560 Maximum files allowed 507617
Extend quantity 5 Mount count 2
Mount status System Cache name "_$7$DKD100:XQPCACHE"
Extent cache size 64 Maximum blocks in extent cache 1655856
File ID cache size 64 Blocks in extent cache 581760
Quota cache size 0 Maximum buffers in FCP cache 3514
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.
Volume is also mounted on EUROS.
|
In this example, the SHOW DEVICES command requests a full listing of the status of the multipath device $1$DGA30. This device has four local Fibre Channel paths and one remote (MSCP-served) path.
| #3 |
|---|
$ 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
XQP caching enabled, write-through XFC caching enabled.
|
In this example, the SHOW DEVICES command requests a full listing of the status of the RZ56 device DKB0.
| #4 |
|---|
$ 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.
| #5 |
|---|
$ SHOW DEVICES/FULL NODE2$
Disk NODE2$DUA0:, device type RA81, is online, mounted,
error logging enabled
Error count 0 Operations completed 24195
Owner process name Owner UIC [11,177]
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.
| #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
XQP caching enabled, write-through XFC 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 DEVICE/PREFERRED_CPU, or by issuing a $QIO.
For more information about using Fast Path features to improve I/O performance, see the HP 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 XQP caching enabled, write-through XFC 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 DSA13
Device BitMap Size Percent Type of Master Active
Name ID (Bytes) Populated Bitmap Node
DSA13: 00010007 8248 0.01% Minimerge IPA Yes
|
This example shows a SHOW DEVICE/BITMAP display. In this example, the bitmap is an HBMM bitmap that is active on node IPA.
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. Use the /FULL qualifier to view the entire display.
If no bitmap is active (or the device is not mounted), no bitmap file ID is displayed. The phrase "no bitmaps active" is displayed.
| #12 |
|---|
$ SHOW DEVICE/FULL EWA0
Device EWA0:, device type DEGXA, is online, network device, error logging is
enabled, device is a template only.
Error count 1 Operations completed 0
Owner process "" Owner UIC [SYSTEM]
Ownerprocess ID 00000000 Dev Prot S:RWPL,O:RWPL,G,W
Reference count 0 Default buffer size 512
Current preferred CPU ID 0 Fastpath 1
Current Interrupt CPU ID 0
Operating characteristics: Link up, Full duplex, Autonegotiation, Jumbo frames.
Speed (Mbits/sec) 1000
Def. MAC addr 00-D0-59-61-6A-B2 Current MAC addr 00-D0-59-61-6A-B2
|
This example shows information regarding the LAN template device EWA0. Only the template device displays the state of the link. In this example, the link is up.
| #13 |
|---|
SHOW DEVICE/FULL EIA4
Device EIA4:, device type i82559, is online, network device, error logging is
enabled.
Error count 0 Operations completed 375225
Owner process "NETACP" Owner UIC [SYSTEM]
Owner process ID 39800425 Dev Prot S:RWPL,O:RWPL,G,W
Reference count 2 Default buffer size 1498
Operating characteristics: Full duplex, Autonegotiation.
Speed (Mbits/sec) 100
Def. MAC addr 00-08-02-AF-EC-D4 Current MAC addr AA-00-04-00-CD-4D
Protocol name DECNET Protocol type 60-03
|
This example show information regarding the LAN device EIA4. As this device is specific to a particular LAN protocol, information regarding that protocol is displayed; this information is not displayed for the template device in the previous example, as there is no protocol associated with the template service.
| Previous | Next | Contents | Index |