 |
HP OpenVMS DCL Dictionary
HP OpenVMS DCL Dictionary
SHOW LOGICAL
Displays translations, the level of translation, and the logical name
table for a specified logical name. The SHOW LOGICAL command performs
iterative translations.
Requires read (R) access to the table in which a logical name
is cataloged to display information about the logical name.
Format
SHOW LOGICAL [logical-name[:][,...]]
Parameter
logical-name[:][,...]
Specifies one or more logical names whose translations you want to
display. The asterisk (*) and the percent sign (%) wildcard characters
are allowed; however, if a wildcard character is used, iterative
translation is not done.
The logical name is translated iteratively up to a number of times
determined by the system (from 9 to 11). That is, translations are
examined to see if they are also logical names.
Description
The SHOW LOGICAL command displays logical names.
The logical name LNM$DCL_LOGICAL contains the list of logical name
tables and the order in which they are searched. Unless LNM$DCL_LOGICAL
has been redefined, the process, job, group, and system tables are
searched, in that order. (To see how LNM$DCL_LOGICAL is defined for
your process, enter the command SHOW LOGICAL/TABLE=LNM$DIRECTORIES
LNM$DCL_LOGICAL.)
If you specify a logical name, its translations are displayed. If you
do not specify a logical name, all the logical names in the tables
defined by the logical name LNM$DCL_LOGICAL are displayed.
You can specify the tables you want to search. If you do not specify a
table, SHOW LOGICAL searches the tables specified by the logical name
LNM$DCL_LOGICAL.
The SHOW LOGICAL command performs iterative translations. If a logical
name has more than one translation, then all translations at a level
are displayed before going to the next level. Use the SHOW TRANSLATION
command to display only the first translation found for a specified
logical name.
The SHOW LOGICAL command executes an image and causes the current image
(if any) to exit. Use the SHOW TRANSLATION command (which is built into
the command interpreter) when you do not want to exit the current image.
If a logical name contains control characters, the SHOW LOGICAL command
replaces them with periods (.) for display.
Qualifiers
/ACCESS_MODE=mode
Displays names defined in the specified access mode and any inner
access modes. You can specify one of the following keywords to indicate
the access mode: USER_MODE, SUPERVISOR_MODE, EXECUTIVE_MODE, or
KERNEL_MODE.
The default value for this qualifier is USER_MODE; by default any
definitions in all four access modes are displayed.
/ALL (default)
Indicates that all logical names in the specified logical name tables
are to be displayed. If you do not enter the /PROCESS, /JOB, /GROUP,
/SYSTEM, or /TABLE qualifier, all logical names in the tables specified
by the logical name LNM$DCL_LOGICAL are displayed.
/DESCENDANTS
/NODESCENDANTS (default)
Controls whether the system displays names from the specified logical
name table and any descendant tables. A descendant table is created by
the CREATE/NAME_TABLE command, with the /PARENT_TABLE qualifier
specifying its parent table. If you use the /DESCENDANTS qualifier, you
must also use the /TABLE qualifier.
/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 more detailed information for the specified logical name. The
information includes the access mode, attributes, the translation, and
the logical name table.
/GROUP
Indicates that only the group logical name table is to be searched. The
/GROUP qualifier is synonymous with the /TABLE=LNM$GROUP qualifier. If
you specify the /GROUP qualifier and you do not also specify a logical
name, all names in the group table are displayed.
/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.
/JOB
Indicates that only the job logical name table is to be searched. The
/JOB qualifier is synonymous with the /TABLE=LNM$JOB qualifier. If you
specify the /JOB qualifier and you do not also specify a logical name,
all names in the job logical name table are displayed.
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the SHOW LOGICAL command is sent. By
default, the output of the SHOW LOGICAL 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.
/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.
/PROCESS
Indicates that only the process logical name table is to be searched.
The /PROCESS qualifier is synonymous with the /TABLE=LNM$PROCESS
qualifier. If you specify the /PROCESS qualifier and you do not also
specify a logical name, all names in the process table are displayed.
/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.
/STRUCTURE
/NOSTRUCTURE (default)
Controls whether the system displays the "family tree" of all
accessible logical name tables. The display includes the two logical
name directory tables (process and system) and all logical name tables
cataloged in these directory tables. Any descendant logical name tables
are shown under their parent tables.
If you specify the /STRUCTURE qualifier, you cannot use any other
qualifiers except /ACCESS_MODE, /FULL, and /OUTPUT.
/SYSTEM
Indicates that only the system logical name table is to be searched.
The /SYSTEM qualifier is synonymous with the /TABLE=LNM$SYSTEM
qualifier. If you specify the /SYSTEM qualifier and you do not also
specify a logical name, all names in the system table are displayed.
/TABLE=(name[,...])
Specifies the tables you want to search. If you specify only one table,
you can omit the parentheses. The asterisk (*) and the percent sign (%)
wildcard characters are allowed. Names with wildcards are used to match
table names. Names without wildcard characters are treated both as
table names and table search lists (whichever is appropriate).
You can use the /TABLE qualifier to specify the following:
- A user-defined logical name table (created with the
CREATE/NAME_TABLE command)
- The process, group, or system logical name tables
- The process or system directory tables
If you specify the table name by using a logical name that translates
to more than one table, then each table is searched in the order
specified. For example, if you specify SHOW LOGICAL/TABLE=LNM$FILE_DEV,
and LNM$FILE_DEV is equated to LNM$PROCESS, LNM$JOB, LNM$GROUP, and
LNM$SYSTEM, then the process, job, group, and system tables are
searched, in that order.
If you do not specify the /TABLE qualifier, the default is
/TABLE=LNM$DCL_LOGICAL.
/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 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.)
| #2 |
$ 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.
| #3 |
$ 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.)
| #4 |
$ 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.
| #5 |
$ 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.
| #6 |
$ 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.
SHOW MEMORY
Displays the availability and usage of those system resources that are
related to memory.
Format
SHOW MEMORY
Parameters
None.
Description
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
Slot usage
Dynamic memory usage (in bytes)
Paging file usage (in blocks)
Dynamic memory
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.
Qualifiers
/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.
|
|
/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
Displays information about the use of each paging and swapping file
currently installed.
/FULL
When 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_REGIONS
On 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.
/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 cannot include asterisk (*) and the percent sign (%) wildcard
characters.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/PAGE[=keyword]
/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_PAGES
Displays information about the amount of physical memory and the number
of free and modified pages.
/POOL
Displays 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.
/SLOTS
Displays information about the availability of partition control block
(PCB) vector slots and balance slots.
/UNITS=keyword
Allows 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).
|
/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 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.
|
|
