HP OpenVMS Systems Documentation |
OpenVMS DCL Dictionary
You make these resources available by using the following system parameters: MSCP_BUFFER, MSCP_CREDITS, MSCP_LOAD, and MSCP_SERVE_ALL. Refer to 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.
|
#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$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 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.
Indicates the node where output from a DECwindows application will be displayed.
SHOW DISPLAY [display-device]
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.
DECwindows gives you the ability to run applications across a network by allowing you to perform the following tasks:
- Direct the output from applications running on your workstation to another workstation.
- Direct the output from applications running on remote processors to your workstation. Although the application runs on another processor, it looks the same as any other application running locally on your workstation.
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: 0The description of each item follows:
- 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 is 0.
- Screen is 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.
$ 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.
Displays information about a user's batch and print jobs or about specific job entries.Requires read (R) access to the queue.
SHOW ENTRY [entry-number[,...]],[job-name[,...]]
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.
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.
/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 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.
ABORTING
EXECUTING
PRINTING
PROCESSING STALLED
STARTING
SUSPENDEDHOLDING 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. If no keyword is specified, the /BY_JOB_STATUS qualifier displays the status of all jobs.
/DEVICE[=(keyword,...)]
Selects for display only those print jobs in the queue types specified. Specify the queue type with one or more of the following keywords:
PRINTER Requests the display of jobs in print queues. SERVER Requests the display of jobs in server queues. TERMINAL Requests the display of jobs in terminal queues. If no keyword is specified, the /DEVICE qualifier displays all jobs in printer, terminal, or server queues.
/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
Adds to the default display the list of full file specifications for each file in each job. The /FILES qualifier overrides the default /BRIEF qualifier./FULL
Displays the following information for each job: entry number, job name, user name, job status, full file specification associated with each job, date and time of submission, settings specified for the job, queue name, queue status, and queue type.The /FULL qualifier overrides the default /BRIEF qualifier.
/GENERIC
Selects for display only those jobs contained in generic queues. A generic queue holds jobs of a particular type (for example, batch or line printer jobs) and directs them to execution queues for processing./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./OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the SHOW ENTRY command is sent. By default, the output is sent to the current SYS$OUTPUT device (usually your terminal). To send the output to a file, use the /OUTPUT qualifier followed by a file specification.The asterisk (*) and the percent sign (%) wildcard characters are not allowed in the file specification. If you enter a partial file specification (for example, specifying only a directory), SHOW is the default file name and .LIS is the default file type.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of 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.
/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.
/USER_NAME=username
Selects for display those jobs owned by the specified user. If the /USER_NAME qualifier is not specified, information about your own jobs is displayed. The name must be 1 to 12 alphanumeric characters./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 ENTRY/BY_JOB_STATUS=RETAINED Entry Jobname Username Blocks Status ----- ------- -------- ------ ------ 422 FORECAST JONES Retained on completion On stopped generic batch queue CLUSTER_BATCH Completed 21-DEC-2001 16:18 on queue NODE_BATCH |
In this example, the SHOW ENTRY command displays a job entry that was retained on completion.
#2 |
---|
$ SHOW ENTRY/FULL S* Entry Jobname Username Blocks Status ----- ------- -------- ------ ------ 625 STAFF ESTES 112 Pending (queue stopped) On stopped printer queue LN01$PRINT Submitted 19-DEC-2001 12:14 /FORM=LN01$PORTRAIT (stock=DEFAULT) /NOTIFY /PRIORITY=100 File: _DKA1:[ESTES]STAFF.DIS;3 629 SEARCH ESTES 94 Printing On printer queue LINE$PRINT Submitted 19-DEC-2001 12:16 /FORM=DEFAULT /NOTIFY /PRIORITY=100 /COPIES=2 /NOFEED /PASSALL File: _DKA1:[ESTES.DAILY]SEARCH.TXT;2 (printing copy 2) |
In this example, the SHOW ENTRY command displays the current jobname entries beginning with the letter "S" owned by ESTES on all queues. The /FULL qualifier lists the submission information, the full file specification, and the current settings for the job.
Note that entry 629 specified the /COPIES, /NOFEED, and /PASSALL qualifiers to the PRINT command. The /NOFEED qualifier suppresses automatic form feeds. The /PASSALL qualifier suppresses formatting (including form feeds and carriage return characters) performed by the print symbiont.
#3 |
---|
$ SUBMIT ASSIGNMENTS.COM Job ASSIGNMENTS.COM (queue SYS$BATCH, entry 199) pending . . . $ SHOW ENTRY 199/FULL Entry Jobname Username Status ----- ------- -------- ------ 199 ASSIGNMENTS JONES Executing Submitted 19-DEC-2001 08:36 /KEEP /NOLOG/ NOPRINT /PRIORITY=100 File: DUA2:[JONES]ASSIGNMENTS.COM;34 |
In this example, JONES submits ASSIGNMENTS.COM for batch processing. Because JONES does not specify a specific queue, the job is entered into the generic SYS$BATCH queue to await processing. After performing other tasks, JONES checks the job status and sees that the file is now executing. Note that the job entry migrated from a generic to an execution batch queue and that JONES was able to check the job status without knowing the specific batch queue name. If the user did not specify an entry number, all jobs would have been displayed.
Displays the error count for all devices with error counts greater than zero.
SHOW ERROR
None.
/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.
/FULL
Displays the error count for all devices, including those with no errors. (The error count is either zero or a number greater than zero.)/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./OUTPUT[=filespec]
/OUTPUT=SYS$OUTPUT (default)
Specifies the file to which the display is written. By default, the display is written to the current SYS$OUTPUT device.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. The asterisk (*) and the percent sign (%) wildcard characters are not allowed in the file specification.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of error 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.
Previous Next Contents Index