Copyright Digital Equipment Corp. All rights reserved.

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