1 LIST Displays a description of each specified known image or, if no file is specified, all known images. Format LIST [file-spec] 2 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. 2 Qualifiers /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. /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. /RESIDENT Displays a description of each resident image. /STRUCTURE Lists addresses of known image data structures. /SUMMARY Used with the /GLOBAL qualifier, displays the global section and global page usage on the system for local and shared memory global sections. 2 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:.EXE AUTHORIZE;1 (1) Open Prv (2) CDU;1 Open Hdr Prv DCL;1 Open Hdr Shared FAL;1 Open Hdr SharAddr INSTALL;1 Prv LOGINOUT;1 Open Hdr SharAddr Prv MAIL;1 Open Hdr SharAddr MAIL_SERVER;1 Open Hdr SharAddr Prv REQUEST;1 Prv SET;1 Open Hdr SharAddr Prv SETAUDIT;1 Prv SETP0;1 Open Hdr SharAddr Prv SETRIGHTS;1 Open Prv SHOW;1 Open Hdr SharAddr Prv SHWCLSTR;1 Open Hdr SharAddr Prv SUBMIT;1 Open Hdr SharAddr Prv SYSMAN;1 Open Prv SYS$DISK:.EXE CONVSHR;1 DCLTABLES;1 Open Hdr Shared Lnkbl . . . LIBOTS;1 Open Hdr SharAddr Lnkbl Resid LIBRTL;1 Open Hdr SharAddr Lnkbl Resid MAILSHR;1 Open Hdr SharAddr 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). ArbSupp Image is installed with Access Rights Block (ARB) support options (/ARB_SUPPORT). Authprv Image has authorized privileges (/AUTHPRIVILEGES). Hdr Image header is permanently resident (/HEADER_ RESIDENT). GlxIdent Image is writable with shared data in a Galaxy global section identified by the image ident (/WRITABLE=GALAXY=IDENT). GlxWrite Image is writable with shared data in a Galaxy global section (/WRITABLE=GALAXY=IDENT). 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. Shared Image is shared (/SHARED). SharAddr Image has shared address data (/SHARED=ADDRESS_DATA). Wrt Image is writable (/WRITABLE). Xonly Only execute access to image is allowed (/EXECUTE_ONLY). 2.INSTALL> LIST/RESIDENT The command in this example displays a single-line description of all resident images. The description includes the location in memory, the size of the code segments/sections, and the type of segment/section. System Resident Sections SYS$DISK:.EXE . . . DECC$SHR;1 Base VA End VA Length Type FFFF8300.088E6000 FFFF8300.08D14137 00000000.0042E138 Resident Code FFFF8300.08D78000 FFFF8300.08DAAB17 00000000.00032B18 Unwind Data FFFF8300.08DAC000 FFFF8300.08DB4A17 00000000.00008A18 Resident Code FFFFFFFF.85A16000 FFFFFFFF.85A2C5BF 00000000.000165C0 Resident Code 00000000.7BB76000 00000000.7BB81EBB 00000000.0000BEBC Writeable data 00000000.7BB82000 00000000.7BB8A0FF 00000000.00008100 Demand-zero 00000000.7BB8C000 00000000.7BB8C028 00000000.00000029 Writeable data 00000000.7BB8E000 00000000.7BB93BCB 00000000.00005BCC Read-only data 00000000.7BB94000 00000000.7BB9B59B 00000000.0000759C Read-only data . . . LIBOTS;1 Base VA End VA Length Type FFFF8300.08610000 FFFF8300.08610012 00000000.00000013 Resident Code FFFF8300.08612000 FFFF8300.0861DFAF 00000000.0000BFB0 Resident Code FFFF8300.0861E000 FFFF8300.0861F247 00000000.00001248 Unwind Data FFFF8300.08620000 FFFF8300.08620017 00000000.00000018 Resident Code FFFFFFFF.85A04400 FFFFFFFF.85A0590F 00000000.00001510 Resident Code 00000000.7B2E8000 00000000.7B2E800F 00000000.00000010 Read-only data . . . LIBRTL;1 Base VA End VA Length Type FFFF8300.08443000 FFFF8300.08443597 00000000.00000598 Resident Code FFFF8300.08445000 FFFF8300.085E8BDF 00000000.001A3BE0 Resident Code FFFF8300.085FD000 FFFF8300.0860C6B7 00000000.0000F6B8 Unwind Data FFFF8300.0860D000 FFFF8300.0860FFDF 00000000.00002FE0 Resident Code FFFFFFFF.85A00400 FFFFFFFF.85A0434F 00000000.00003F50 Resident Code 00000000.7B2BE000 00000000.7B2C190F 00000000.00003910 Writeable data 00000000.7B2C2000 00000000.7B2D8607 00000000.00016608 Demand-zero 00000000.7B2DA000 00000000.7B2DA029 00000000.0000002A Writeable data 00000000.7B2DC000 00000000.7B2DDADD 00000000.00001ADE Read-only data 00000000.7B2DE000 00000000.7B2E689F 00000000.000088A0 Read-only data 3.INSTALL> LIST/FULL LOGINOUT The command in this example displays a multiline description of the known image LOGINOUT. SYS$DISK:.EXE LOGINOUT;1 Open Hdr SharAddr Prv Entry access count = 44 (1) Current / Maximum shared = 3 / 5 (2) Global section count = 15 (3) Privileges = CMKRNL SYSNAM IMPERSONATE LOG_IO ALTPRI TMPMBX SYSPRV SYSLCK AUDIT SECURITY (4) Authorized = CMKRNL SYSNAM IMPERSONATE LOG_IO ALTPRI TMPMBX SYSPRV SYSLCK AUDIT SECURITY Resident section count = 0000 ARB Support = READ_ONLY (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. System Global Sections (1) . . . SYS$DISK:DEC$BASRTL.EXE (2) INS$812E2AE0_009(040003EA) (3) PRM SYS (4) Pgltcnt/Refcnt=115/0 (5) INS$812E2AE0_008(040003EA) DZRO PRM SYS Pgltcnt/Refcnt=32/0 INS$812E2AE0_007(040003EA) DZRO PRM SYS Pgltcnt/Refcnt=16/0 INS$812E2AE0_006(040003EA) DZRO PRM SYS Pgltcnt/Refcnt=64/0 INS$812E2AE0_005(040003EA) PRM SYS Pgltcnt/Refcnt=1195/0 INS$812E2AE0_004(040003EA) PRM SYS Pgltcnt/Refcnt=5/0 INS$812E2AE0_003(040003EA) PRM SYS Pgltcnt/Refcnt=6/0 . . . 570 Global Sections Used, 16340/85840 Global Pagelets Used/Unused (6) (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. Version number (in hexadecimal) of global section; for shareable images only, the high-order byte (04 in INS$812E2AE0_nnn) contains major identification, and low-order bytes (0003E8 in INS$812E2AE0_nnn) contain minor identification determined by the programmer at link time. For executable images, the number is a known unique value determined by the system. (4) 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. (5) Number of pagelets 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. (6) Number of global sections created, number of global pagelets used, and number of global pagelets 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 . . . X86VMS$DKA0:EDTSHR.EXE INS$81297980_009(00000000) PRM SYS Pgltcnt/Refcnt=48/0 INS$81297980_005(00000000) PRM SYS Pgltcnt/Refcnt=444/0 INS$81297980_004(00000000) PRM SYS Pgltcnt/Refcnt=17/0 INS$81297980_003(00000000) PRM SYS Pgltcnt/Refcnt=1/0 Owner: [SYSTEM] (1) Protection: S:RWED,O:RWED,G:RE,W:RE (2) . . . (1) UIC of the owner of the global section (2) Type of access allowed for the image