[Digital logo]
[HR]

OpenVMS System Management Utilities Reference Manual


Previous | Contents

Both the fatal and nonfatal memory entries are similar in their format. The memory error log reports can be divided into two logical areas of information. The first section of a memory error log report is the identification area. The second section contains memory controller-specific information. This data represents the information contained within the memory controller registers at the time of the memory error. Bit-to-text translation of the registers is performed and then listed on the right side of the report.

**************************** ENTRY       7. **************************** 
ERROR SEQUENCE 4.                                 LOGGED ON SID 03003700 
 
MEMORY ERROR,  6-MAR-1996 10:11:34.70 
               KA730 REV# 0. MIC# 55. 
 
      CSR0            00166200 
                                      ERROR SYNDROME = 7F 
                                      CORRECTED ERROR, BIT #31. 
                                      ARRAY #1. IN ERROR 
      CSR1            18000000 
                                      MEMORY MAPPING ENABLE 
                                      ENABLE "CRD" REPORTING 
      CSR2            8100000F 
                                      MEMORY SIZE = 2048.K 
                                      64K RAMS PRESENT 

**************************** ENTRY 91. **************************** ERROR SEQUENCE 342. LOGGED ON SID 0138207A FATAL MEMORY ERROR, 4-MAR-96 08:16:45.20 KA780 REV# 7. SERIAL# 122. CONTROLLER AT TR #5. PRTCFNG 00000040 ADAPTER IS MULTI-PORT MEMORY PORT NUMBER = 0. PRTCR 00000003 MASTER INTERRUPT ENABLE PORT INTERFACE INTERRUPT ENABLE RAM COUNT 0. PCSR 07870003 ERROR INTERRUPT ENABLE IVDTCR 01870001 INVALIDATE CACHE DEVICE ID = 0. 8. ARRAY BOARD(S) PRESENT MEMORY BASE ADDRESS = 6144.K AER 16A70005 ERROR SYNDROME = 05 RDS ERROR ARRAY #6. IN ERROR ARRAY BANK #1. IN ERROR ERROR LOG REQUEST CSR0 0000C2C8 MEMORY CONTAINS VALID DATA PORT #2. POWERED DOWN PORT #3. POWERED DOWN ERROR INTERRUPT FROM PORT #1. PORT #2. OFFLINE PORT #3. OFFLINE CSR1 0000380A PORT #0. CONNECTED TO AN SBI PORT #1. CONNECTED TO AN SBI PORT #2. NOT PRESENT PORT #3. NOT PRESENT INVALIDATION MAP PRESENT PORT #0. INVALIDATION ACK RECEIVED PORT #1. INVALIDATION ACK RECEIVED MAT 0000C000

10.4.5 Nonfatal and User Bugchecks Entry Example

The following is an example of a fatal bugcheck. Nonfatal and user bugcheck reports have the same format. These reports consist of three sections: identification, bugcheck reason and process information, and system register information.

 Error Log Report Generator                                         Version 7.1 
 
 ******************************* ENTRY      25. ******************************* 
 ERROR SEQUENCE 15.                              LOGGED ON:  CPU_TYPE 00000002 
 DATE/TIME 22-JUL-1996 13:43:48.96                           SYS_TYPE 00000003 
 SYSTEM UPTIME: 90 DAYS 00:07:26 
 SCS NODE: LSR3                                                VAX/VMS V7.1 
 
 FATAL BUGCHECK SYS_TYPE = 03 
 
 OPERATOR, Operator requested system shutdown 
 
       PROCESS NAME    Aut 
       PROCESS ID      00010004 
 
       ERROR PC        00000000 000304A0 
 
    Process Status = 08000000 00001F03, SW = 03, Previous Mode = USER 
    System State = 00, Current Mode = KERNEL 
    VMM = 00 IPL = 31, SP Alignment = 8 
 STACK POINTERS 
    
 KSP 00000000 7FF95F08  ESP 00000000 7FF9A000  SSP 00000000 7FFA04C0  
 USP 00000000 7FE63B80 
 
 GENERAL REGISTERS 
    
 R0  00000000 00000001  R1  00000000 00000000  R2  FFFFFFFF 805ED100 
 R3  00000000 00000001  R4  00000000 00000001  R5  00000000 00000001 
 R6  00000000 00000000  R7  00000000 00000000  R8  00000000 7FFA05F8 
 R9  00000000 7FFA0800  R10 00000000 00000000  R11 00000000 7FFBE3E0 
 R12 00000000 00000004  R13 00000000 00010100  R14 00000000 02080061 
 R15 FFFFFFFF 80403C30  R16 00000000 00000474  R17 00000000 00004000 
 R18 00000000 00000000  R19 00000000 00000000  R20 FFFFFFFF 805C04B6 
 R21 00000000 00800000  R22 FFFFFFFF 804308E8  R23 88000000 E4000003 
 R24 00000000 00000000  R25 00000000 00000001  R26 00000000 00000002 
 R27 00000000 00000002  R28 00000000 00030440  FP  00000000 7FF95F10 
 SP  00000000 7FF95F08  PC  00000000 000304A0  PS  08000000 00001F03 
 SYSTEM REGISTERS 
    
       PTBR            00000000 000005D3 
                                       Page Table Base Register 
       PCBB            00000000 00B98080 
                                       Privileged Context Block Base 
       PRBR            FFFFFFFF 805C0000 
                                       Processor Base Register 
       SCBB            00000002 00000000 
                                       System Control Block Base 
       SISR            00000000 0000017B 
                                       Software Interrupt Summary Register 
       ASN             00000000 00000000 
                                       Address Space Number 
       ASTSR_ASTEN     00000000 0000003F 
                                       AST Summary/AST Enable 
       AT              00000000 0000000F 
                                       Absolute Time 
 

10.4.6 Unknown Entries Examples

The following are sample reports for error log entries of unknown type. Each report has an identification section and an error log record section. The error log record section contains two types of records: interpretable and noninterpretable. If ERROR LOG can interpret the fields of the record, the utility gives the name of the field, its contents, and interprets what the field is. If the utility cannot interpret the fields of a record, it gives the longword value of the field and its contents in hexadecimal format.
**************************** ENTRY      95. **************************** 
ERROR SEQUENCE 2.                                 LOGGED ON SID 03003600 
 
"UNKNOWN DEVICE" ENTRY,  4-MAR-96 10:12:12.44 
                         KA730 REV# 0. MIC# 54. 
 
ERROR LOG RECORD 
 
      ERF$L_SID       03003600 
                                      SYSTEM ID REGISTER 
      ERL$W_ENTRY         0062 
                                      ERROR ENTRY TYPE 
      EXE$GQ_SYSTIME  C9764980 
                      008C2F30        64 BIT TIME WHEN ERROR LOGGED 
      ERL$GL_SEQUENCE     0002 
                                      UNIQUE ERROR SEQUENCE = 2. 
      UCB$W_STS           0110 
                                      DEVICE STATUS 
      UCB$B_DEVCLASS        42 
                                      DEVICE CLASS = 66. 
      UCB$B_DEVTYPE         42 
                                      DEVICE TYPE = 66. 
      UCB$W_UNIT          0000 
                                      PHYSICAL UNIT NUMBER = 0. 
      UCB$W_ERRCNT        0001 
                                      UNIT ERROR COUNT = 1. 
      UCB$L_OPCNT     00000001 
                                      UNIT OPERATION COUNT = 1. 
      ORB$L_OWNER     00010004 
                                      OWNER UIC = [001,004] 
      UCB$L_DEVCHAR   0C440007 
                                      DEVICE CHARACTERISTICS 
      UCB$B_SLAVE           00 
                                      DEVICE SLAVE CONTROLLER = 0. 
      DDB$T_NAME      41515403 
                      00000000 
                      00000000 
                      00000000 
                                      /.TQA............/ 
      LONGWORD 1.     00000008 
 
      LONGWORD 2.     00000007 
 
      LONGWORD 3.     00000502 
 
      LONGWORD 4.     04000000 
 
      LONGWORD 5.     00010000 
 
      LONGWORD 6.     00000000 
 
      LONGWORD 7.     00000080 
 
      LONGWORD 8.     00000000 
 
      LONGWORD 9.     00000000 
 
 
 
**************************** ENTRY     161. **************************** 
ERROR SEQUENCE 213.                               LOGGED ON SID 070001FF 
 
"UNKNOWN ENTRY", 4-MAR-96 11:35:15.73 
                 UVAX1 REV# 255. MIC# 1. 
 
ERROR LOG RECORD 
 
      ERF$L_SID       070001FF 
                                      SYSTEM ID REGISTER 
      ERL$W_ENTRY         0008 
                                      ERROR ENTRY TYPE 
      EXE$GQ_SYSTIME  89953F20 
                      008C3E2A        64 BIT TIME WHEN ERROR LOGGED 
 
      ERL$GL_SEQUENCE     00D5 
                                      UNIQUE ERROR SEQUENCE = 213. 
      LONGWORD 1.     00000001 
                                      /..../ 
      LONGWORD 2.     00410001 
                                      /..A./ 

10.4.7 Example of a Brief Report

The following is an example of a report generated with the /BRIEF qualifier.

 
 Error Log Report Generator                                   Version 7.1 
 
 **************************** ENTRY       1. **************************** 
 ERROR SEQUENCE 11.                          LOGGED ON:      SID 08000000 
 DATA/TIME 18-JUL-1996 22:53:41.57                      SYS_TYPE 00000000 
 
 DEVICE ERROR  KA630 
 
 RD32 SUB-SYSTEM, UNIT _RICHIE$DUA0: 
 
       DMA ADDRESS       000000 
 
       DSECT      CHEAD      DHEAD      CCYL       DCYL       SCNT       
       06         14         14         9C         9C         01         
 
       RTCNT      CSTAT      MODE       DSTAT      TERM       ISTAT      
       F0         08         C0         B2         BD         28         
 
       CMD        
       56         
 


Chapter 11
Install Utility

11.1 INSTALL Description

The Install utility (INSTALL) creates known file entries to improve the performance of executable and shareable images, especially those that run frequently, run concurrently with several processes, or allow images to run in a privileged context.

Known file entries last only while the system is operating. If the system is shut down or fails for any reason, you must reinstall all known images after the system is rebooted. For this reason, you are encouraged to include additional INSTALL commands for selected images in the site-specific command procedure SYS$MANAGER:SYSTARTUP_VMS.COM.

11.2 INSTALL Usage Summary

Use the Install utility (INSTALL) to enhance the performance of selected executable and shareable images, to assign enhanced privileges to images, and to support user-written system services. The system stores the name and attributes of installed images on known file lists.

Format

INSTALL [command]


PARAMETER

command

Specifies an INSTALL command. This parameter is optional. If no command is specified, the utility displays its prompt and waits for command input.

DESCRIPTION

To invoke INSTALL, enter the DCL command INSTALL at the DCL prompt as follows:
$ INSTALL

The utility responds with the following prompt:

INSTALL>

You can then perform INSTALL operations by entering the appropriate INSTALL commands.

To exit from the Install utility, enter the EXIT command at the INSTALL> prompt or press Ctrl/Z. Either method returns control to the DCL command level.

Alternatively, you can enter a single INSTALL command on the same line as the command that invokes the utility, for example:

$ INSTALL LIST/FULL SYS$SYSTEM:LOGINOUT

11.3 INSTALL Commands

This section describes and provides examples of the INSTALL commands. Table 11-1 summarizes the INSTALL command functions.

Table 11-1 INSTALL Command Summary
Command Function
ADD Synonym for the CREATE command
CREATE Installs the specified image as a known image
DELETE Synonym for the REMOVE command
EXIT Exits from INSTALL
HELP Describes how to use INSTALL
LIST Displays a description of each specified known image, global sections, and the addresses of known image data structures
PURGE Deletes all known images installed without the /NOPURGE qualifier
REMOVE Deletes a known image
REPLACE Associates a known image with the latest version of the image file or modifies the attributes of an installed image


ADD

Installs the specified image file as a known image. The ADD command is a synonym for the CREATE command.

CREATE

Installs the specified image file as a known image. The CREATE command is a synonym for the ADD command.

Requires the CMKRNL privilege. Also requires the SYSGBL privilege to create system global sections and the PRMGBL privilege to create permanent global sections.


Format

CREATE file-spec


PARAMETER

file-spec

Names the file specification of an image to be installed as a known image. The file specification must name an existing executable or shareable image, which must have been linked with the /NOTRACEBACK qualifier. If you omit the device and directory specification, the default SYS$SYSTEM is used. The default file type is .EXE.

The highest existing version of the file is used by default. However, you can specify another version of the file as the known version of the image. Even if other versions of the file exist, the version that you specify will be the version that satisfies all known file lookups for the image.


QUALIFIERS

/ACCOUNTING

/NOACCOUNTING (default)

Enables image-level accounting for the specified image even if image accounting is disabled (by using the DCL command SET ACCOUNTING/DISABLE=IMAGE). When image accounting is enabled on the local node, it logs all images, and the /NOACCOUNTING qualifier has no effect.

/EXECUTE_ONLY

/NOEXECUTE_ONLY (default)

The /EXECUTE_ONLY qualifier is meaningful only to main programs. It allows the image to activate shareable images to which the user has execute access but no read access. All shareable images referenced by the program must be installed, and OpenVMS RMS uses trusted logical names (those created for use in executive or kernel mode).

You cannot specify this qualifier for an executable image linked with the /TRACEBACK qualifier.

/HEADER_RESIDENT

/NOHEADER_RESIDENT

Installs the file as a known image with a permanently resident header (native mode images only). An image installed header resident is implicitly installed open.

/LOG

/NOLOG (default)

Lists the newly created known file entry along with any associated global sections created by the installation.

/OPEN

/NOOPEN

Installs the file as a permanently open known image.

/PRIVILEGED[=(priv-name[,...])]

/NOPRIVILEGED[=(priv-name[,...])]

Installs the file as a known image with the privileges specified. Then, if the image is not located on the system volume, the image is implicitly installed open.

The /PRIVILEGED qualifier applies only to executable images.

You cannot specify this qualifier for an executable image linked with the /TRACEBACK qualifier.

You can specify one or more of the privilege names in Table 11-2.

Table 11-2 Privileges for Installed Images
ACNT ALLSPOOL ALTPRI
AUDIT BUGCHK BYPASS
CMEXEC CMKRNL DETACH
DIAGNOSE DOWNGRADE EXQUOTA
GROUP GRPNAM GRPPRV
IMPORT LOG_IO MOUNT
NETMBX OPER PFNMAP
PHY_IO PRMCEB PRMGBL
PRMMBX PSWAPM READALL
SECURITY SETPRV SHARE
SHMEM SYSGBL SYSLCK
SYSNAM SYSPRV TMPMBX
UPGRADE VOLPRO WORLD

/PROTECTED

/NOPROTECTED (default)

Installs the file as a known image that is protected from user-mode and supervisor-mode write access. You can write into the image only from executive or kernel mode. The /PROTECTED qualifier together with the /SHARE qualifier are used to implement user-written services, which become privileged shareable images.

/PURGE (default)

/NOPURGE

Specifies that the image can be removed by a purge operation; if you specify /NOPURGE, you can remove the image only by a remove operation.

/RESIDENT[=([NO]CODE,[NO]DATA)]

On Alpha systems, causes image code sections or read-only data sections to be placed in the granularity hint regions and compresses other image sections, which remain located in process space. If you do not specify the /RESIDENT qualifier, neither code nor data is installed resident. If you specify the /RESIDENT qualifier without keyword arguments, code is installed resident, and data is not installed resident.

The image must be linked using the /SECTION_BINDING=(CODE,DATA) qualifier. An image installed with resident code or data is implicitly installed header resident and shared.

/SHARED

/NOSHARED

Installs the file as a shared known image and creates global sections for the image sections that can be shared. An image installed shared is implicitly installed open.

/WRITABLE

/NOWRITABLE

Installs the file as a writable known image as long as you also specify the /SHARED qualifier. The /WRITABLE qualifier only applies to images with image sections that are shareable and writable. The /WRITABLE qualifier is automatically negated if you do not specify the /SHARED qualifier.

Examples

  1. INSTALL> CREATE/OPEN/SHARED WRKD$:[MAIN]STATSHR 
    

    The command in this example installs the image file STATSHR as a permanently open shared known image.
  2. INSTALL> CREATE/OPEN/PRIVILEGED=(GROUP,GRPNAM) GRPCOMM 
    

    The command in this example installs the image file GRPCOMM as a permanently open known image with the privileges GROUP and GRPNAM.
    Any process running GRPCOMM receives the GROUP and GRPNAM privileges for the duration of the execution of GRPCOMM. The full name of GRPCOMM is assumed to be SYS$SYSTEM:GRPCOMM.EXE.
  3. INSTALL> CREATE/LOG GRPCOMM 
    

    The command in this example installs the image file GRPCOMM as a known image and then displays the newly created known file entry.

DELETE

Deletes a known image. The DELETE command is a synonym for the REMOVE command.

EXIT

Terminates INSTALL and returns control to the DCL command level. You can also exit from INSTALL by pressing Ctrl/Z.

Format

EXIT


HELP

Displays information about how to use INSTALL.

Format

HELP [command]


PARAMETER

command

Specifies the name of a command for which help infomation is to be displayed. If you omit a command name, a list of commands is displayed and you are prompted for a command name.

Examples

  1. INSTALL> HELP 
    

    The command in this example displays a list of INSTALL topics and a Topic? prompt. Any topic from the list can be entered at the prompt.
  2. INSTALL> HELP LIST 
     
    LIST 
     
     
      For display of a one-line description of the specified known image, 
      or if no file is specified, then for all known images.  Use with 
      /FULL to obtain a multiline description. 
     
      Format:         LIST [file-spec] /qualifier 
     
     
         QUALIFIER COMBINATION   BEHAVIOR 
     
         LIST [file-spec]        List the known image for file-spec 
         LIST                    List all entries 
     
     
      Additional information available: 
     
      Qualifiers 
      /FULL      /GLOBAL    /STRUCTURE    /SUMMARY 
    

    The command in this example displays help information on the LIST command.

LIST

Displays a description of each specified known image or, if no file is specified, all known images.

Format

LIST [file-spec]


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.

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 on how to estimate the size of installed images, see the OpenVMS System Services Reference Manual.

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 on 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.

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 on registered images, see the OpenVMS System Manager's Manual: Essentials.
      SHAR Image is shared (/SHARED).
      WRT Image is writable (/WRITABLE).
      XONLY Only execute access to image is allowed (/EXECUTE_ONLY).

      +VAX specific
      ++Alpha specific

  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 was 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 
     
                  
    DSA1000:<SYS2.SYSCOMMON.SYSLIB>SLS$USSSHR.EXE 
     INS$86D9BFB0_003  (14000001)        PRM SYS (5)   Pagcnt/Refcnt=1/1 (6)
     INS$86D9BFB0_002    (14000001)          PRM SYS      Pagcnt/Refcnt=3/3 
     INS$86D9BFB0_001    (14000001)          PRM SYS      Pagcnt/Refcnt=1/1 
       .
       .
       .
    RMS$87A63B00         (00000000) WRT DZRO TMP SYS      Pagcnt/Refcnt=74/74 
       .
       .
       .
     671 Global Sections Used, 102138/22862  Global Pages Used/Unused (7)
     
    
    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, see 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] 
                   Protection:  S:RWED,O:RWED,G:RWED,W:RE 
    . 
    . 
    . 
    
    1. UIC of the owner of the global section
    2. Type of access allowed for the image


Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]

[HR]

  6048P022.HTM
  OSSG Documentation
  26-NOV-1996 12:42:50.58

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal