Updated: 11 December 1998 |
OpenVMS DCL Dictionary
Previous | Contents | Index |
Paging File Usage
Shows the usage of paging and swapping files.
(1) File Name Displays the complete file specification of each paging or swapping file, subject to the privilege restriction mentioned in the description of the normal display. (2) Free Blocks Displays the number of free blocks in each paging and swapping file currently installed. Free blocks are blocks that may be physically allocated in the file. (3) Reservable Blocks Displays the number of reservable blocks in each paging and swapping file currently installed. Reservable blocks are blocks that may be logically claimed by a process for future physical allocation. A negative value indicates that the file may be overcommitted.
Note that a negative value is not an immediate concern but indicates that the file may become overcommitted if physical memory becomes scarce.(4) Total Size Displays the size of each paging and swapping file. (5) File Number Displays the internal paging file index assigned to each paging or swapping file when it is installed. (6) Swapping Usage Displays the number of processes currently assigned space in this file for the purpose of swapping. Swapping file assignment can change over the life of a process. (7) Paging Usage Displays the number of processes currently paging to this file. Paging file assignment is made when a process is created and a process continues to page to that file.
Note that the last two pieces of information are limited by the GROUP and WORLD privileges. That is, a process with neither privilege can only determine the paging and swapping file assignments of itself and its subprocesses. A process with GROUP privilege can obtain this information about all processes that have the same group number. Only a process with WORLD privilege can obtain accurate paging and swapping file information for the entire system.(8) File Usage Displays a line of text that describes whether the file is used exclusively for swapping or is used for both paging and swapping.
Displays information about network services registered on a node.
SHOW NETWORK [network-service]
network-service
Specifies a network service for which you want to display information. If you do not specify a service, the SHOW NETWORK command displays information about all services that are currently registered on the local node.
The SHOW NETWORK command displays information about network services available on an OpenVMS system.
/FULL
Displays all the information for the specified network service./OLD
If you are running DECnet Phase IV, retains the behavior of the SHOW NETWORK command prior to OpenVMS Version 7.0. If the local node is a routing node, the /OLD qualifier provides routing information./OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default, the output of the SHOW NETWORK command is sent to the current SYS$OUTPUT device (usually your terminal).The asterisk (*) and the percent sign (%) wildcard characters are not allowed in the file specification.
If you enter the /NOOUTPUT qualifier, output is suppressed.
#1 |
---|
$ SHOW NETWORK Product: DECnet Node: GALENA Addresss(es): 19.129 |
This command displays all the network services currently registered on the local node, and the name and address of that node.
#2 |
---|
$ SHOW NETWORK/FULL The following network service is available at this time: Product: DECNET Manufacturer: Digital Equipment Corporation Node: ZOOMAN Address(es): 19.215 Network Type: DNA IV Interface(s): net 0 Node Volatile Characteristics as of 21-NOV-1998 10:36:09 Executor node = 19.215 (ZOOMAN) Identification = DECnet for OpenVMS Alpha V6.2 Management version = V4.0.0 Incoming timer = 45 Outgoing timer = 60 Incoming Proxy = Enabled Outgoing Proxy = Enabled NSP version = V4.1.0 Maximum links = 32 Delay factor = 80 Delay weight = 5 Inactivity timer = 60 Retransmit factor = 10 Routing version = V2.0.0 Type = nonrouting IV Routing timer = 600 Broadcast routing timer = 180 Maximum address = 1023 Maximum circuits = 16 Maximum cost = 1022 Maximum hops = 30 Maximum visits = 63 Maximum area = 63 Max broadcast nonrouters = 64 Max broadcast routers = 32 Maximum path splits = 1 Area maximum cost = 1022 Area maximum hops = 30 Maximum buffers = 100 Buffer size = 576 Default access = incoming and outgoing Pipeline quota = 4032 Alias maximum links = 32 Path split policy = Normal Maximum Declared Objects = 31 Known Link Volatile Summary as of 21-NOV-1998 10:36:10 Link Node PID Process Remote link Remote user 8201 19.117 20200094 REMACP 25330 JONES 8200 19.129 20200094 REMACP 24711 SMITH |
This command displays all the information available about all the network services registered on the local node.
Displays the current settings for a printer.
SHOW PRINTER device-name[:]
device-name[:]
Specifies the name of the printer for which settings are to be displayed.
The SHOW PRINTER command displays the settings that are currently defined for the specified printer. Settings include the following:
- Printer type
- Page width
- Page length
- Line termination type
- Form feed
- Case
- Character translation
- Wrapping
Printer settings are established by the SET PRINTER command. You must have OPER (operator) privilege to use the SET PRINTER command.
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default, the output of the SHOW PRINTER command 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.
$ SHOW PRINTER LPA0: Printer LPA0:, device type LP11, is online, allocated, spooled Error count 0 Operations completed 880 Owner process "SYMBIONT_0001" Owner UIC [0,0] Owner process ID 21C0008D Dev Prot S:RWLP,O:RWLP,G:RWLP,W:RWLP Reference count 2 Default buffer size 132 Page width 132 Page Length 66 No Carriage_return Formfeed Lowercase No Passall No Wrap Printall No Fallback Intermediate device: STAR$DBA1: Associated queue: LN01$PRINT |
The SHOW PRINTER command in this example displays the settings for the printer LPA0.
Displays information about a process and its subprocesses.Requires GROUP privilege to show other processes in the same group. Requires WORLD privilege to show processes outside your group.
SHOW PROCESS [[node-name::]process-name]
node-name::
The name of the node on which the specified process is running.You must specify a node name on the same OpenVMS Cluster on which the current process is running.
process-name
The name of the process about which information is to be displayed. The process name can have up to 15 alphanumeric characters.The specified process name must be in the same group as the current process.
The SHOW PROCESS command displays information about a process and its subprocesses. If no qualifier is entered, only the following subset of information is displayed:
- Time
- Process terminal
- User name and user identification code (UIC)
- Node name
- Process name and process identification (PID)
- Priority
- Default directory
- Allocated devices
- Number of kernel threads
A local process name can look like a remote process name. Therefore, if you specify ATHENS::SMITH, the system checks for a process named ATHENS::SMITH on the local node before checking node ATHENS for a process named SMITH.
You also can use the /IDENTIFICATION=pid qualifier to specify a process name. If you use the /IDENTIFICATION qualifier and the process-name parameter together, the qualifier overrides the parameter. If you do not specify either the process-name parameter or the /IDENTIFICATION qualifier, information is displayed for the current process.
If you have GROUP or WORLD privilege, you can display information about processes other than your own. With GROUP privilege you can look at other processes in your group. With WORLD privilege you can look at processes outside of your group. You must use the /IDENTIFICATION qualifier to look at processes outside of your group.
/ACCOUNTING
Shows the resources used by the process./ALL
Displays the basic subset of information as well as information about:
- Accounting
- Dynamic memory use
- Privileges
- Quotas
- Shelving
- Subprocesses
/CONTINUOUS
Displays continuously updated information about the local process in an OpenVMS environment. You cannot use the /CONTINUOUS qualifier to display information about a process on another node in a cluster environment.While the continuous display is running, you can press the T key to display information for threads that make up the process. If there are multiple threads, pressing the T key repeatedly cycles through all the threads.
While the continuous display is running, you can press the V key to display a map of the pages in the virtual address space of the process.
Each character displayed in the map represents the type of page. If the current program counter is in the page, the page type is indicated by an at sign (@). Pages locked in the working set are indicated by the letter L. Global pages are indicated by the letter G. Other valid pages in the working set are indicated by an asterisk (*).
To terminate the continuous display, press the E key. To return to the original display, press the space bar.
The /CONTINUOUS qualifier may not be used with the /OUTPUT qualifier.
/DUMP
Displays the image dump setting which is set or cleared by the SET PROCESS/DUMP command./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./IDENTIFICATION=pid
Requires GROUP or WORLD privilege to access processes other than your own.Displays information about the process with the specified process identification (PID). The PID is assigned by the system when the process is created. When you specify a PID, you can omit the leading zeros.
If you specify the /IDENTIFICATION qualifier, it overrides the process-name parameter. If, in addition, you specify the /MEMORY qualifier, the PID value must be that of the current process.
/INTERVAL=n
Use with the /CONTINUOUS qualifier to update the information at the specified number of seconds./MEMORY
Displays the process's use of dynamic memory areas. The /MEMORY qualifier is allowed only for the current process./OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default, the output of the SHOW PROCESS command 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.
The /OUTPUT qualifier is incompatible with the /CONTINUOUS qualifier.
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of process 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.
/PRIVILEGES
Displays current privileges and rights for the process. To display only privileges, also specify the /NORIGHTS qualifier. Use the SET PROCESS/PRIVILEGES command to enable process privileges on a system./QUOTAS
Displays, for each resource, either a quota or a limit. The values displayed for quotas reflect any quota reductions resulting from subprocess creation. The values displayed for limits reflect the resources available to a process at creation./RIGHTS (default)
/NORIGHTS
Displays the current rights for the specified process. Use the /NORIGHTS qualifier with the /PRIVILEGES qualifier to suppress the rights display./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.
/SHELVING
Displays whether the process automatically unshelves files./SUBPROCESSES
Displays the current subprocesses in hierarchical order./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 PROCESS OCALA::MALIK 14-DEC-1998 15:35:19.39 User: MALIK Process ID: 28200364 Node: OCALA Process name: MALIK Terminal: RTA5: User identifier: [VMS,MALIK] Base priority: 4 Default file spec: WORK5:[MALIK] Devices allocated: RTA5: |
The SHOW PROCESS command in this example is entered by the user MALIK. The system displays the subset of information for the owned process on node OCALA. The information includes the following:
- Date and time the SHOW PROCESS command is entered
- User name
- Process identification (PID) number
- Node name
- Process name
- Device name of the current SYS$INPUT device
- User identification code (UIC)
- Base execution priority
- Default device (only for processes on the same node)
- Default directory (only for current processes)
- Devices allocated to the process and volumes mounted, if any
#2 |
---|
$ SHOW PROCESS/ACCOUNTING 14-DEC-1998 14:48:01.31 User: MALIK Process ID: 28200364 Node: OCALA Process name: "MALIK" Accounting information: Buffered I/O count: 4878 Peak working set size: 844 Direct I/O count: 1284 Peak virtual size: 1176 Page faults: 6100 Mounted volumes: 0 Images activated: 22 Elapsed CPU time: 0 00:01:20.51 Connect time: 0 04:06:03.75 |
The SHOW PROCESS command in this example displays the accounting statistics for the process. The values under Peak working set size and Peak virtual size are rendered in 512-byte pages on VAX and in pagelets on Alpha.
#3 |
---|
$ SHOW PROCESS/PRIVILEGES 14-DEC-1998 14:59:28.53 User: MALIK Process ID: 28200364 Node: OCALA Process name: "MALIK" Process privileges: GROUP may affect other processes in same group TMPMBX may create temporary mailbox NETMBX may create network device Process rights identifiers: INTERACTIVE DIALUP |
The SHOW PROCESS command in this example displays the current privileges for the process.
#4 |
---|
$ SHOW PROCESS/QUOTAS 14-DEC-1998 15:00:28.79 User: MALIK Process ID: 28200364 Node: OCALA Process name: "MALIK" Process Quotas: Account name: VMS CPU limit: Infinite Direct I/O limit: 6 Buffered I/O byte count quota: 17904 Buffered I/O limit: 6 Timer queue entry quota: 10 Open file quota: 31 Paging file quota: 24945 Subprocess quota: 8 Default page fault cluster: 64 AST limit: 14 Enqueue quota: 30 Shared file limit: 9 Max detached processes: 11 Max active jobs: 14 |
The SHOW PROCESS command in this example displays the available quotas and limits. The value under Paging file quota is rendered in 512-byte pages on VAX and in pagelets on Alpha.
#5 |
---|
$ SHOW PROCESS/SUBPROCESSES 14-DEC-1998 15:44:59.39 User: MALIK Process ID: 28200364 Node: OCALA Process name: "MALIK_1" Processes in this tree: MALIK MALIK_1 (*) MALIK_2 |
The SHOW PROCESS command in this example shows the current process tree. The current process is indicated by the asterisk (*). Processes both below and above the current process are shown.
#6 |
---|
$ SHOW PROCESS/CONTINUOUS BOB Process BOB 12:26:53 State CUR Working set 269 Cur/base priority 8/4 Virtual memory 1713 Current PC 7FFEE07E CPU time 00:00:13.82 Current PSL 03C00000 Direct I/O 246 Current user SP 7FF785A4 Buffered I/O 646 PID 226006C0 Page faults 3417 UIC [VMS,BOB] Event flags C8000007 C0000000 SYS$SYSROOT:[SYSEXE]SHOW.EXE |
In this example, the /CONTINUOUS qualifier causes the display of information about process BOB to be updated continuously. Note that the Virtual memory heading appears on VAX and the Virtual pages heading appears on Alpha; both indicate the virtual memory used as a number of CPU-specific pages. The value displayed for Working set is also a number of CPU-specific pages.
#7 |
---|
$ SHOW PROCESS/MEMORY 14-DEC-1998 14:59:04.48 User: MALIK Process ID: 28200364 Node: OCALA Process Name: "MALIK" Process Dynamic Memory Area Current Size (bytes) 25600 Current Total Size (pages) 50 Free Space (bytes) 22698 Space in Use (bytes) 2902 Size of Largest Block 22496 Size of Smallest Block 15 Number of Free Blocks 7 Free Blocks LEQU 32 Bytes 3 |
The SHOW PROCESS command in this example displays the use of dynamic memory areas for the current process, MALIK. These areas are described as follows:
Current size Displays the current size in bytes and pages on VAX (512-byte pagelets on Alpha) of each dynamic memory area. Free space Displays the amount of free space in each dynamic memory area. Space in use Displays the amount of space currently allocated from each area. Largest block Displays the size of the largest contiguous area in each pool area. Smallest block Displays the size of the smallest free block in each pool area. Free blocks Displays the total number of free blocks in each pool area. The size of this number is a measure of pool fragmentation. Blocks LEQU 32 (VAX) Blocks LEQU 64 (Alpha) Displays the number of free blocks that are 32 bytes or shorter on VAX or 64 bytes or shorter on Alpha. This number is another measure of pool fragmentation, because while allocation of these small blocks is unlikely, they contribute to the allocation time whenever an allocation request is made.
#8 |
---|
$ SHOW PROCESS OCALA::MALIK 14-DEC-1998 15:35:19.39 User: MALIK Process ID: 28200364 Node: OCALA Process name: MALIK Terminal: RTA5: User identifier: [VMS,MALIK] Base priority: 4 Default file spec: WORK5:[MALIK] Devices allocated: RTA5: |
The SHOW PROCESS command in this example displays the basic subset of information for the process MALIK on node OCALA.
#9 |
---|
$ SHOW PROCESS/SHELVING SMITH 15-JUNE-1998 10:07:25.11 User: SMITH Process ID: 20206A50 Node: BANANA Process name: "SMITH" Auto-unshelve: on |
Previous Next Contents Index
Copyright © Compaq Computer Corporation 1998. All rights reserved.
Legal9996PRO_068.HTML