Document revision date: 30 March 2001

## OpenVMS DCL Dictionary

Previous | Contents | Index

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.

#### /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.

#### /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.

### 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:

> - 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 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.

#12
    $ SHOW DEVICE/BITMAP/FULL DSA0
    Device  Bitmap  Size   Percent  Active Creation             Master   Cluster Local Delete  Bitmap
    Name    ID     (bytes) of full         Date/Time            Node     Size    Set   Pending Name
                           copy
    DSA0: 00010001  652     11%      Yes 4-Feb-2001 13:30:25:30  00010004 127     2%  No  SHAD$DSA12.

> This example shows a SHOW DEVICE/BITMAP/FULL 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.

## 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.

> Previous | Next | Contents | Index

> | privacy and legal statement |
> 9996PRO_066.HTML