Displays a description of each specified known image or, if no
file is specified, all known images.
Format
LIST [file-spec]
1 – Parameter
file-spec
Names the file specification of an image installed as a known
image. If you omit the file specification, INSTALL displays all
known images.
2 – Description
You can use the LIST command with the /FULL qualifier to display
information that is useful in tuning the known image database.
For example, a high entry-access count for an image may indicate
that system performance could benefit if the image were installed
/OPEN. Similarly, high entry-access counts for an image may
indicate that installing the image /SHARED-that is, with global
sections-could improve performance. For a description of global
sections and global pages, including information about how to
estimate the size of installed images, refer to the OpenVMS
System Services Reference Manual.
3 – Qualifiers
3.1 /FULL
Displays a multiline description of the specified known image,
including the number of accesses, the number of concurrent
accesses, and the number of global sections created. The /FULL
qualifier with the /GLOBAL qualifier shows information about
global sections, plus the current owner and protection codes and
access control entries.
3.2 /GLOBAL
Lists global sections for any specified shared image, or if you
omit the file specification, lists all global sections. If a
global section is created by INSTALL to support a particular
image, that image is also identified.
3.3 /RESIDENT
Displays a description of each resident image.
3.4 /STRUCTURE
Lists addresses of known image data structures.
3.5 /SUMMARY
Used with the /GLOBAL qualifier, displays the global section
and global page usage on the system for local and shared memory
global sections.
4 – Examples
1.INSTALL> LIST
The command in this example displays a single-line description
of all known images. The description includes the file
specification of the known image and its attributes.
SYS$DISK:<SYS0.SYSCOMMON.SYSEXE>.EXE
ANALIMDMP;1 1 Prv 2
AUTHORIZE;1 Prv
CDU;1 Open Hdr Prv
DCL;1 Open Hdr Shar Lnkbl
FAL;1 Open Hdr Shar
INSTALL;1 Prv
LOGINOUT;1 Open Hdr Shar Prv
MAIL;1 Open Hdr Shar
MAIL_SERVER;1 Open Hdr Shar Prv
REQUEST;1 Prv
SET;1 Open Hdr Shar Prv
SETAUDIT;1 Prv
SETP0;1 Open Hdr Shar Prv
SETRIGHTS;1 Prv
SHOW;1 Open Hdr Shar Prv
SHWCLSTR;1 Open Hdr Shar Prv
SUBMIT;1 Open Hdr Shar Prv
SYSMAN;1 Prv
SYS$DISK:<SYS0.SYSCOMMON.SYSLIB>.EXE
ANALIMDMPSHR;1 Prv
CONVSHR;1
DCLTABLES;1 Open Hdr Shar Lnkbl
.
.
.
LIBOTS;1 Open Hdr Shar Lnkbl Resid
LIBRTL;1 Open Hdr Shar Lnkbl Resid
MAILSHR;1 Open Hdr Shar Lnkbl
.
.
.
1 File specification of the known image
2 Attribute of known image, as follows:
Attribute Meaning
ACNT Image accounting is enabled for the image
(/ACCOUNTING).
CMODE Image is in compatibility mode, set by the VAX-11
RSX Linker.
HDR Image header is permanently resident (/HEADER_
RESIDENT).
LNKBL Image is not executable; it is a shareable
(linkable) image set by the OpenVMS Linker.
NOPURG Image cannot be removed by a purge operation;
it can only be removed by a delete or remove
operation (/NOPURGE).
OPEN Image is permanently open (/OPEN).
PROT Image contains protected code (/PROTECTED).
PRV Image has privileges (/PRIVILEGED).
RESID Image is resident (/RESIDENT).
SAFE Image is a privileged image registered as being
compatible with the running version of OpenVMS.
For more information about registered images,
refer to the OpenVMS System Manager's Manual,
Volume 1: Essentials.
SHAR Image is shared (/SHARED).
WRT Image is writable (/WRITABLE).
XONLY Only execute access to image is allowed
(/EXECUTE_ONLY).
2.INSTALL> LIST/RESIDENT
The command in this Alpha example displays a single-line
description of all resident images. The description includes
the location in memory, the size of the code sections, and the
type of section.
System Resident Sections
SYS$DISK:<SYS0.SYSCOMMON.SYSLIB>.EXE
CMA$TIS_SHR;1
Base VA End VA Length Type
80490000 80490A00 00000A00 Resident Code
7FC04000 7FC04A00 00000A00 Linkage
7FC14000 7FC14200 00000200 Writeable data
7FC34000 7FC34200 00000200 Writeable data
DECC$SHR;1
Base VA End VA Length Type
80548000 805D1C00 00089C00 Resident Code
805D2000 805D2400 00000400 Resident Code
7FE34000 7FE4B800 00017800 Linkage
7FE54000 7FE59A00 00005A00 Writeable data
7FE64000 7FE64800 00000800 Read-only data
7FE84000 7FE84200 00000200 Writeable data
7FE94000 7FE94200 00000200 Demand-zero
7FEA4000 7FEA7000 00003000 Demand-zero
7FEB4000 7FEB5800 00001800 Writeable data
DPML$SHR;1
Base VA End VA Length Type
80492000 80547600 000B5600 Resident Code
7FC44000 7FC6FA00 0002BA00 Read-only data
7FC74000 7FC88200 00014200 Linkage
7FC94000 7FC94400 00000400 Writeable data
7FCA4000 7FCCE600 0002A600 Read-only data
7FD94000 7FD95000 00001000 Writeable data
LIBOTS;1
Base VA End VA Length Type
80482000 8048F600 0000D600 Resident Code
7FBC4000 7FBC6600 00002600 Read-only data
7FBD4000 7FBD5A00 00001A00 Linkage
7FBF4000 7FBF4200 00000200 Writeable data
LIBRTL;1
Base VA End VA Length Type
80400000 80481A00 00081A00 Resident Code
7FB54000 7FB64800 00010800 Linkage
7FB74000 7FB75000 00001000 Writeable data
7FB84000 7FB8D600 00009600 Read-only data
7FB94000 7FB94200 00000200 Writeable data
7FBA4000 7FBA5000 00001000 Demand-zero
7FBB4000 7FBB5400 00001400 Writeable data
3.INSTALL> LIST/FULL LOGINOUT
The command in this example displays a multiline description of
the known image LOGINOUT.
SYS$DISK:<SYS0.SYSCOMMON.SYSEXE>.EXE
LOGINOUT;3 Open Hdr Shar Priv
Entry access count = 44 1
Current / Maximum shared = 3 / 5 2
Global section count = 2 3
Privileges = CMKRNL SYSNAM TMPMBX EXQUOTA SYSPRV 4
1 Number of times known file entry has been accessed by this
node since it swas installed.
2 First number indicates the current count of concurrent
accesses of the known file. The second number indicates
the highest count of concurrent accesses of the file since
it was installed. This number appears only if the image is
installed with the /OPEN qualifier.
3 Number of global sections created for the known file;
appears only if the image is installed with the /SHARED
qualifier.
4 Translation of the privilege mask; appears only if the image
is installed with privileges.
4.INSTALL> LIST/GLOBAL
The command in this example displays all global sections for
shared images. Global sections created by INSTALL (prefix INS$)
for a specific image are listed following the name of that
image.
1 Display of global sections in memory.
2 Name of the image for which the following global sections
were created by INSTALL.
3 Name of global section. The prefix identifies the creator of
the section; for example, INS means the global section was
created by INSTALL. The number includes the address of the
section.
4 Version number (in hexadecimal) of global section; for
shareable images only, the high-order byte (01 in CRFSHR_
003) contains major identification, and low-order bytes
(0003E8 in CRFSHR_003) contain minor identification
determined by the programmer at link time. For executable
images, the number is a known unique value determined by the
system.
5 Attributes of the global section:
DZRO Global section is demand-zero.
GRP Along with a group number indicates a groupwide
section, which would be created by a program other
than INSTALL.
PRM Global section is permanent.
SYS Global section is systemwide.
TMP Indicates a temporary global section, which would be
created by a program other than INSTALL.
WRT Global section is writable.
6 Number of pages (VAX) or pagelets (Alpha) in the section and
number of page table entries currently mapped to this global
section. For a more detailed discussion of mapping global
sections, refer to the OpenVMS Programming Concepts Manual.
7 Number of global sections created, number of global pages
used, and number of global pages unused in local memory.
Note that, because of arithmetic rounding, the number of
global sections created will sometimes be greater than the
SYSGEN parameter GBLSECTIONS. When the size of the system
header is being computed, the values of the GBLSECTIONS and
SYSMWCNT parameters are combined with the size of the fixed
part of the process header. The result is rounded up to the
next page boundary. This rounding process sometimes adds
space to the global section table, depending on the values
of the two SYSGEN parameters and the amount of system paging
that preceded the running of INSTALL to create all of the
global sections.
5.INSTALL> LIST/GLOBAL/FULL
The command in this example displays a complete listing of
global sections for shared images. The /FULL qualifier adds
owner and protection codes to the display.
System Global Sections
NM_MAILSHR_003 (741A6919) PRM SYS Pagcnt/Refcnt=10/0
NM_MAILSHR_002 (741A6919) PRM SYS Pagcnt/Refcnt=1/0
NM_MAILSHR_001 (741A6919) PRM SYS Pagcnt/Refcnt=11/0
Owner: [1,4] 1
Protection: S:RWED,O:RWED,G:RWED,W:RE 2
.
.
.
1 UIC of the owner of the global section
2 Type of access allowed for the image