HP OpenVMS Systems Documentation
HP OpenVMS DCL Dictionary
Displays translations, the level of translation, and the logical name table for a specified logical name. The SHOW LOGICAL command performs iterative translations.
SHOW LOGICAL [logical-name[:][,...]]
The SHOW LOGICAL command displays logical names.
$ SHOW LOGICAL/PROCESS (LNM$PROCESS_TABLE) "SYS$COMMAND" = "_TTB4:" "SYS$DISK" = "WORK6:" "SYS$DISK" = "WORK6:" "SYS$ERROR" = "_TTB4:" "SYS$INPUT" = "_TTB4:" "SYS$LOGIN" = "WORK6:[ODONNELL]" "SYS$LOGIN_DEVICE" = "WORK6:" "SYS$OUTPUT" = "_TTB4:" "SYS$OUTPUT" = "DKA2:" "SYS$SCRATCH" = "WORK6:[ODONNELL]"
The SHOW LOGICAL command in this example displays all process logical names and their translations. (Note that /TABLE=LNM$PROCESS would produce the same display as /PROCESS.)
$ SHOW LOGICAL INFILE "INFILE" = "WORK6:[LOGAN]PAYROLL.EXE" (LNM$PROCESS_TABLE)
The SHOW LOGICAL command in this example displays the translation for the logical name INFILE. The response indicates that the logical name was found in the process logical name table.
$ SHOW LOGICAL/GROUP . . .
The SHOW LOGICAL command in this example displays all group logical names and their translations. (Note that /TABLE=LNM$GROUP would produce the same display as /GROUP.)
$ SHOW LOGICAL/TABLE=SYSTEM SYS$LIBRARY "SYS$LIBRARY" = "SYS$SYSROOT:[SYSLIB]" (LNM$SYSTEM_TABLE) = "DOCD$:[SYSC.SYSLIB]"
The SHOW LOGICAL command in this example displays the translation of the logical name SYS$LIBRARY in the system table. The response indicates that SYS$LIBRARY is defined in the system table, and that the logical name has two translations.
$ SHOW LOGICAL/TABLE=LNM$GROUP/TABLE=LNM$SYSTEM SYS$DISK "SYS$DISK" = "ZZZ3:" (LNM$SYSTEM_TABLE)
The SHOW LOGICAL command in this example is qualified by both the /TABLE=LNM$GROUP and /TABLE=LNM$SYSTEM qualifiers. The response indicates that the logical name SYS$DISK was found in the system logical name table. When you enter two conflicting qualifiers, as in this example, only the last qualifier you specify is used.
$ SHOW LOGICAL/TABLE=LNM$PROCESS_DIRECTORY
The SHOW LOGICAL command in this example displays the logical names in the process directory table. Each name is either a table name, or a name that translates iteratively to a table.
Displays the availability and usage of those system resources that are related to memory.
The information provided by the SHOW MEMORY command can help you determine whether to change certain system memory resources to improve system performance. The system memory resources are as follows:Physical memory
Process entry slots and balance slots
Nonpaged and paged dynamic memory
Space in paging and swapping files
File data cache memory usage
When the SHOW MEMORY command is executed, a display is written to SYS$OUTPUT. Depending on which qualifiers you specify, the display shows the following memory resource statistics:Physical memory usage
Bad page list
Number of pages allocated to an OpenVMS system
Dynamic memory usage (in bytes)
Paging file usage (in blocks)
Granularity hint regions for code and data (Alpha only)
Virtual I/O Cache facility (VAX only)
Extended File Cache facility (Alpha only)
For a detailed description of each item displayed, see the examples.
/ALL (default)Displays all available information, that is, information displayed by the /FILES, /PHYSICAL_PAGES, /POOL, and /SLOTS qualifiers.
/BUFFER_OBJECTS (Alpha only)Displays information about system resources used by buffer objects.
/CACHE[=(keyword[,...])]Displays information about the Virtual I/O Cache facility or the Extended File Cache facility, depending on which is loaded. The Cache facility information is displayed as part of the SHOW MEMORY and SHOW MEMORY/CACHE/FULL commands.
If the Extended File Cache is loaded, you can specify the following keywords and options:
VOLUME[=device] Requests display of volume-level statistics for the specified volume(s). If no device is specified, defaults to SYS$DISK. Device specifications may be wildcarded; if so, the device specification must be based on the physical device name. Specify VOLUME=* to see statistics for all volumes in cache. FILE=filespec Requests display of file-level statistics for the specified file(s) in cache. The filespec must contain an explicit or implicit device specification. The filespec may be wildcarded according to RMS rules. Specify FILE=dev:*.* to see statistics for all files in cache for a device. Partially wild file specifications that are satisfied by large numbers of files on disk may incur significant processing overhead during display. By default, both open and closed files are displayed (use the OPEN and CLOSED keywords to further restrict which files are displayed).
Note that this command may fail if you select a large number of files for display. If you receive an error message, reduce the number of selected files and reissue the command.
TOPQIO[= n] Requests display of file-level statistics for the n files in cache with the highest overall QIO count ( n defaults to 10). TOPHITRATE[= n] Requests display of file-level statistics for the n files in cache with the highest overall cache hit rate ( n defaults to 10).
OPEN Include only open files in the display (default for TOPQIO and TOPHITRATE). CLOSED Include only closed files in the display.
/EXACTUse 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.
/FILESDisplays information about the use of each paging and swapping file currently installed.
/FULLWhen used with /POOL, displays additional information about pool area.
When used with /CACHE, displays additional information about the file data cache that is loaded (either VIOC or XFC).
This qualifier is ignored unless the /CACHE or /POOL qualifier is specified explicitly.
/GH_REGIONSOn Alpha, displays information about the granularity hint regions (GHR) that have been established. For each of these regions, information is displayed about the size of the region, the amount of free memory, the amount of memory in use, and the amount of memory released to OpenVMS from the region. The granularity hint regions information is also displayed as part of SHOW MEMORY, SHOW MEMORY/ALL, and SHOW MEMORY/FULL commands.
/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.
/NOOUTPUTControls 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 cannot include asterisk (*) and the percent sign (%) wildcard characters.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/NOPAGE (default)Controls the display of memory 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.
/PHYSICAL_PAGESDisplays information about the amount of physical memory and the number of free and modified pages.
/POOLDisplays information about the usage of each dynamic memory (pool) area, including the amount of free space and the size of the largest contiguous block in each area.
/RESERVED (Alpha only)Displays information about memory reservations.
/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.
/SLOTSDisplays information about the availability of partition control block (PCB) vector slots and balance slots.
/UNITS=keywordAllows you to override the current default specified by SET PROCESS/UNITS so that you can display memory in your choice of blocks or bytes.
Keyword options are:
Option Description BLOCKS Displays memory in blocks (equivalent to PAGES). BYTES Displays memory in bytes. PAGES Displays memory in page format (equivalent to BLOCKS).
/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.
$ SHOW MEMORY System Memory Resources on 20-JAN-2001 15:22:04.11 Physical Memory Usage (pages): Total Free In Use Modified Main Memory (2.00Gb) 262144 201249 60162 733 Extended File Cache (Time of last reset: 18-JAN-2001 17:15:14.33) Allocated (Mbytes) 370.00 Maximum size (Mbytes) 1024.00 Free (Mbytes) 317.79 Minimum size (Mbytes) 370.00 In use (Mbytes) 52.20 Percentage Read I/Os 72% Read hit rate 96% Write hit rate 0% Read I/O count 119363 Write I/O count 46259 Read hit count 115283 Write hit count 0 Reads bypassing cache 45 Writes bypassing cache 0 Files cached open 372 Files cached closed 392 Vols in Full XFC mode 0 Vols in VIOC Compatible mode 3 Vols in No Caching mode 0 Vols in Perm. No Caching mode 0 Granularity Hint Regions (pages): Total Free In Use Released Execlet code region 1024 0 586 438 Execlet data region 256 0 256 0 S0/S1 Executive data region 576 0 576 0 Resident image code region 1024 0 830 194 Slot Usage (slots): Total Free Resident Swapped Process Entry Slots 647 614 33 0 Balance Set Slots 645 614 31 0 Dynamic Memory Usage: Total Free In Use Largest Nonpaged Dynamic Memory (Mb) 4.28 2.38 1.89 2.25 Bus Addressable Memory (Kb) 168.00 128.00 40.00 128.00 Paged Dynamic Memory (Mb) 5.68 3.42 2.26 3.41 Lock Manager Dyn Memory (Mb) 1.13 0.00 1.12 Buffer Object Usage (pages): In Use Peak 32-bit System Space Windows (S0/S1) 3 3 64-bit System Space Windows (S2) 0 0 Physical pages locked by buffer objects 3 3 Memory Reservations (pages): Group Reserved In Use Type VCC$MIN_CACHE_SIZE --- 47360 47360 Allocated Total (370.00 Mbytes reserved) 47360 47360 Swap File Usage (8KB pages): Index Free Size DISK$X6XV_BRAHMA:[SYS0.SYSEXE]SWAPFILE.SYS 1 5168 5168 Paging File Usage (8KB pages): Index Free Size DISK$X6XV_BRAHMA:[SYS0.SYSEXE]PAGEFILE.SYS 254 215288 215288 Total committed paging file usage: 7418 Of the physical pages in use, 4951 pages are permanently allocated to OpenVMS.