[Digital logo]
[HR]

OpenVMS DCL Dictionary


Previous | Contents

To rebuild a volume, either:

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
DBA0:          Online mnt     0  VMS             47088   115     1
DBA1:          Online mnt     0  USERPACK1       45216     2     1
DBA2:          Online mnt     3  DOCUMENT         8068    20     1
DBA5:          Online mnt     0  MASTERP         28668     1     1
DBA6:          Online         0           
DBA7:          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:

#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:  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 contain on member of an ISO 9660 partially mounted volume set. Note the volume status displays the media format is 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 MUA0.


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]

/NOHIGHLIGHT (default)

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 (<uparrow symbol>), Ctrl/B Scroll up one line.
Down arrow (<downarrow symbol>) Scroll down one line.
Left arrow ( <-) Scroll left one column.
Right arrow (->) 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 on the resources available to the MSCP server for use in processing I/O requests for the devices it serves. You make these resources available to the MSCP server when you use SYSGEN's MSCP command to start the MSCP server and use the qualifiers listed in the following table:
Qualifier Item Specified
/BUFFER The amount of buffer space available to the MSCP server.
/FRACTION The maximum size, in pages, of the buffer granted to an I/O request; for transfers of more data than will fit a buffer of the size specified by this qualifier, several computer interconnect (CI) transfers are needed.
/SMALL The minimum size, in pages, of the buffer that the MSCP server can grant to an I/O request; if less than this amount of buffer space is available, the I/O request must wait until at least this much buffer space becomes available; when this much space becomes available, the MSCP server grants the request a buffer.
/PACKETS The number of I/O-request packets (class driver request packets [CDRPs]) available to the MSCP server for processing I/O requests.

/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 BHAK 28-MAY-1994 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$DUS16       Avail        2376153           0      1        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 BHAK 28-MAY-1994 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 10 set-controller-characteristics (SET CTL CHR) operations, but has performed no set-unit-characteristics (SET UNT CHR) operations.

#3
$ SHOW DEVICES/SERVED/RESOURCE
       MSCP-Served Devices on BHAK 28-MAY-1994 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/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 BHAK 28-MAY-1994 13:54:41.99 
  . 
  . 
  . 
                                           Queue Requests 
Host:              Time of Connection      Current    Max   Devices 
    IPL31       25-MAY-1994 21:44:06.44          0      1         0 
    DELAND      25-MAY-1994 21:44:09.98          0      1         0 
    HEAVEN      25-MAY-1994 22:03:15.67          0      7        10 
    VIVA        26-MAY-1994 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-JAN-1992 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-JAN-1992 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.


SHOW DISPLAY

Indicates the node where output from a DECwindows application will be displayed.

Format

SHOW DISPLAY [display-device]


PARAMETER

display-device

Refers to the display-device parameter specified with the SET DISPLAY command. If you are directing application output to multiple workstations in the same session, you can use logical names to point to each workstation. Using the SHOW DISPLAY command, you can specify this logical name as the display-device parameter to see where application output will be displayed.

If you do not specify a display-device string, the logical name DECW$DISPLAY is used.


DESCRIPTION

DECwindows gives you the ability to run applications across a network by allowing you to perform the following tasks:

By running applications on a remote processor for local display on your workstation, you can take advantage of larger computers that might be better suited to a specific computing task. By default, applications running on your workstation are displayed on your workstation.

You use the SET DISPLAY command to direct the output from applications to other workstations. The SHOW DISPLAY command lets you see where the output from these applications will be displayed.

Sample output from the SHOW DISPLAY command looks like the following:

    Device:    WSA2: 
    Node:      0 
    Transport: LOCAL 
    Server:    0 
    Screen:    0 

Device is your workstation device. A new WSAn device is created each time you use the SET DISPLAY/CREATE command. Node is the network system on which the output from applications is displayed. When you are running and displaying applications on your node, Node is 0, which is the standard shorthand notation for representing your node. Transport refers to the mechanism, for example, DECNET or LOCAL, that passes information between the application---the client---and the server. The server sends input from the user to the application and output from the application to the display. Server and Screen are 0.

On DECwindows workstations, the Session Manager creates a default workstation device for use by DECwindows processes (like DECterm). When you use the SET HOST command to connect to a remote node, no workstation device is created for that process and DECW$DISPLAY is not defined. You must specifically create new display devices with the SET DISPLAY/CREATE command.

If no definition for DECW$DISPLAY exists, entering the SHOW DISPLAY command returns an error.

See the description of the SET DISPLAY command for more information.


Example

$ SHOW DISPLAY
  Device:     WSA1: 
  Node:       0
  Transport:  LOCAL
  Server:     0
  Screen:     0
 
$ SET DISPLAY/CREATE/NODE=ZEPHYR
$ SHOW DISPLAY
  Device:     WSA2: 
  Node:       ZEPHYR
  Transport:  DECNET
  Server:     0
  Screen:     0
$ SPAWN/NOWAIT/INPUT=NL: RUN SYS$SYSTEM:DECW$CLOCK
 

In this example, you are logged in to your workstation, here referred to as node 0. (0 is the standard shorthand notation for representing your node.) You want to run the DECwindows Clock on your workstation and display it on another node, ZEPHYR.

Assuming you are authorized to display applications on ZEPHYR, you redirect the application's output to ZEPHYR with the SET DISPLAY command and enter the SHOW DISPLAY command to verify the location of the redirected display. You then run Clock. Note that a new workstation display device, WSA2, is created when you enter the SET DISPLAY/CREATE command.


SHOW ENTRY

Displays information about a user's batch and print jobs or about specific job entries.

Requires read (R) access to the queue.


Format

SHOW ENTRY [entry-number[,...]],[job-name[,...]]


PARAMETERS

entry-number[,...]

Specifies the entry number of the job you want displayed. If no entry number or job name is specified, all your own jobs (or those owned by the user specified with the /USER_NAME qualifier) are displayed.

job-name[,...]

Specifies the name of the jobs you want displayed. The asterisk (*) and the percent sign (%) wildcard characters are allowed. If no job name or entry number is specified, all your own jobs (or those owned by the user specified with the /USER_NAME qualifier) are displayed.

DESCRIPTION

The SHOW ENTRY command displays information about a user's batch and print jobs or about specific job entries.

The information displayed includes the entry number, the job name, the owner, job size in blocks (for print jobs), and the job status. The name, status, and queue type of the queue in which the job is located are also displayed.

If you are only interested in information about your own batch and print jobs, the SHOW ENTRY command produces a better display than the SHOW QUEUE command. Because the SHOW QUEUE command displays queue information regardless of whether your jobs are in these queues, you must scan the display to locate your jobs. By contrast, the SHOW ENTRY command displays only information relevant to your jobs (or those owned by the user you specify with the /USER_NAME qualifier). If the /USER_NAME qualifier is not specified, information about your own jobs is displayed.


QUALIFIERS

/BATCH

Selects batch jobs for display.

/BRIEF (default)

Displays the following information for each job: entry number, job name, user name, job size in blocks (for print jobs), job status, queue name, queue status, and queue type. The /FULL and /FILES qualifiers override the /BRIEF qualifier.

Specify the /FULL qualifier to obtain more job information.

/BY_JOB_STATUS[=(keyword,...)]

Selects for display only those jobs with the specified status. Specify the status with one or more of the following keywords:
EXECUTING Requests the display of jobs in any of the following states:
  • ABORTING
  • EXECUTING
  • PRINTING
  • PROCESSING
  • STALLED
  • STARTING
  • SUSPENDED
ABORTING means that the job is halting prior to normal completion and will not continue processing. A SUSPENDED state means that the job stopped during processing, but should continue when the cause of the SUSPENDED state is resolved. A STALLED or SUSPENDED state means that the job stopped during processing, but should continue when the cause of the STALLED or SUSPENDED state is resolved. PROCESSING is the executing state for server queues. PRINTING is the executing state for printer and terminal queues. STARTING means the job is beginning to be processed.
HOLDING Requests the display of jobs on hold. Holding status indicates that the job is being held in the queue indefinitely.
PENDING Requests the display of jobs with pending status. Pending status indicates that the job is waiting its turn to execute.
RETAINED Requests the display of jobs retained in the queue after execution. Retained status indicates that the job has completed but remains in the queue.
TIMED_RELEASE Requests the display of jobs on hold until a specified time. Timed-release status indicates that the job is being held in the queue for execution at a specified time.


Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]

[HR]

  9996P053.HTM
  OSSG Documentation
  26-NOV-1996 11:18:24.88

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal