Compaq DECwindows Motif
for OpenVMS
Installation Guide
Previous Contents Index

1.7 Saving Customized Bookreader Files

The installation procedure replaces the following file with a new version:

SYS$SYSROOT:[DECW$BOOK]LIBRARY.DECW$BOOKSHELF

If you customized this file and want to save it, copy the file to another directory or rename the file prior to the installation of Compaq DECwindows Motif for OpenVMS software so that it is not deleted.

To copy your customized file to another directory, create the directory and define a global symbol in the file DECW$PRIVATE_APPS_SETUP.COM.

To create a Bookreader directory called SYS$COMMON:[DECW$BOOK_LOCAL], perform the following steps:

  1. Create the directory and assign world read access as follows: 


    $ CREATE/DIRECTORY/PROTECTION=WORLD:R -
_$ SYS$COMMON:[DECW$BOOK_LOCAL]

  2. Copy the LIBRARY.DECW$BOOKSHELF file to the new directory as follows: 


    $ COPY SYS$SYSROOT:[DECW$BOOK]LIBRARY.DECW$BOOKSHELF -
_$ SYS$COMMON:[DECW$BOOK_LOCAL]*/LOG

  3. If the SYS$MANAGER directory does not contain the DECW$PRIVATE_APPS_SETUP.COM command file, copy the template file to a command file as follows: 


    $ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE -
_$ SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM/LOG

  4. Edit the DECW$PRIVATE_APPS_SETUP.COM file and define the global symbol DECW$BOOK to point to your Bookreader directory by adding the following line to the file: 


    $ DECW$BOOK == "SYS$COMMON:[DECW$BOOK_LOCAL]"

  5. Restart DECwindows Motif using the following command if you performed step 4 after installing the product and after DECwindows had been started (for example, after a reboot): 


    $ @SYS$MANAGER:DECW$STARTUP RESTART

For more information about customizing your DECwindows Motif environment, see Managing DECwindows Motif for OpenVMS Systems.

1.8 Installation Procedure Requirements

This section discusses the requirements for installing the Compaq DECwindows Motif for OpenVMS software using PCSI and the VMSINSTAL installation procedure.

The installation procedure checks the following:

See Section 3.1 for information on requirements specific to VMSINSTAL installations.

1.8.1 Process Account Quotas

The installation procedure requires that the installation account has the minimum quotas shown in Table 1-2.

Table 1-2 Process Quotas for the Installation Account
Quota Name Alpha Value VAX Value
ASTLM 250 24
BIOLM 150 18
BYTLM 64,000 32,768
DIOLM 150 18
ENQLM 2,000 30
FILLM 100 20

Use the OpenVMS AUTHORIZE utility to verify and to change process quotas for the installation account in the user authorization file (UAF). (Some sites may restrict the use of the AUTHORIZE utility to certain accounts or users.) For example, to change the BYTLM quota for the account-name installation account, enter the following commands: 


$ SET DEFAULT SYS$SYSTEM
$ RUN AUTHORIZE
UAF> SHOW account-name
UAF> MODIFY account-name /BYTLM = 32768
UAF> SHOW account-name
UAF> EXIT
$ LOGOUT

After you change the quotas for the installation account, log out of the installation account and log in again for the new quotas to take effect. You can then proceed with the installation.

User account quotas are stored in the file SYS$SYSTEM:SYSUAF.DAT. For more information about modifying account quotas, see the description of the AUTHORIZE utility in the OpenVMS System Management Utilities Reference Manual.

1.8.2 Disk Space

Use Table 1-3 to determine the amount of free disk space that is required on the system disk to install DECwindows Motif components. However, because you can choose not to install all the components, your actual disk space requirement may be less.

To determine the number of free blocks on the system disk, enter the following command at the DCL prompt: 


$ SHOW DEVICE SYS$SYSDEVICE

The installation procedure checks for free disk space on the system disk. If sufficient space is not available, the installation procedure provides the following options:

Note
If you run out of free disk space during the installation, the installation procedure fails.

Table 1-3 Approximate Required Disk Space by Component (in Blocks)
Component Alpha VAX
Base kit 1 65,818 81,891
  Runtime support Not applicable 66,021
  CDA support Not applicable 3,650
  Motif applications Not applicable 12,220
Desktop support 71,066 2 Not applicable
  New Desktop 47,314 Not applicable
  DECwindows desktop 20,952 Not applicable
  Manual pages for
New Desktop 		2,800 Not applicable
Programming environment 63,192 3 13,500 2
  C, C++ 19,916 8,190
  FORTRAN 14,792 2,187
  Pascal 15,656 3,123
  New Desktop 12,828 Not applicable
Example programs 51,652 4 12,672
  Sound examples 14,220 Not Applicable
  Programming examples 23,440 12,672
  New Desktop examples 13,992 Not Applicable
Translated image support 39,632 Not applicable
NCSA Mosaic Not applicable 1,200 5


Total disk space required:

291,360

109,263

1This number includes all base kit files. For Alpha systems, the indicated subcomponents are always included in the base kit.
2This number includes all desktop support. The number of blocks required for the individual desktop options is shown in the subtable.
3This number includes all programming language support. The actual number of blocks required for the individual programming languages is shown in the subtable.
4This number includes all examples programs. The actual number of blocks required for the individual example programs is shown in the subtable.
5NCSA Mosaic available only on VMS 5.5--2 systems.

For VMSINSTAL installations, refer to Section 3.1.2 for information on using an alternate working device and Section 3.1.3 for information on using the Distributed File Service.

1.8.3 System Parameters

Table 1-4 lists the minimum required system parameter values for the installation. Depending on the kinds of programs and applications running at your site, you might need higher values for some settings.

Table 1-4 Minimum Required System Parameter Values
System Parameter Alpha Value VAX Value
GBLSECTIONS 600 1 420 1
GBLPAGES 150,000 1 62,000 1
GBLPAGFIL 1,024 6,024
SWPOUTPGCNT 512 500
MAXBUF 8,192 2,048
VIRTUALPAGECNT --- 50,000
CHANNELCNT 255 255
PROCSECTCNT 64 40
PQL_DPGFLQUOTA --- 32,768
PQL_MPGFLQUOTA 32,768 ---
PQL_MASTLM 100 100
PQL_MBIOLM 100 100
PQL_MBYTLM 100,000 48,000
PQL_MDIOLM 100 100
PQL_MENQLM 300 200
PQL_MFILLM 100 100
PQL_MPRCLM 10 8
PQL_MWSDEFAULT 1,024 512
PQL_MWSQUOTA 2,048 1,024
PQL_MWSEXTENT 8,192 2,048
CLISYMTBL 512 256
GH_RES_CODE 1,024 2 ---
IMGREG_PAGES 2,000 2 ---
WINDOW_SYSTEM 1 1
NPAGEDYN 1,998,848 999,936
PAGEDYN 600,000 400,000
WSMAX 12,000 4,096

1If you have installed other software that uses global pages or global sections, you might need a higher minimum value. When you boot your system and DECwindows Motif starts, the values of free GBLPAGES and GBLSECTIONS are checked for your system. If you do not have sufficient values for GBLPAGES and GBLSECTIONS, the DECwindows Motif startup procedure prints a warning and provides a recommended value for these parameters.
2This system parameter is available only on OpenVMS Alpha Version 6.2 (or higher) systems.

Caution
If you do not ensure that your system has the necessary number of global pages and global sections for the installation, the DCL tables can become corrupted.

1.8.4 Additional System Maintenance Procedures

This section explains how to use the System Generation utility (SYSGEN) and the AUTOGEN utility to prepare your system for the Compaq DECwindows Motif for OpenVMS installation. The AUTOGEN utility uses system configuration data to automatically set system parameters.

Note
The DECwindows Motif installation and startup procedures automatically check for required system parameter values and pass the appropriate values to AUTOGEN. Therefore, in most cases you do not have to check and modify these values manually.

1.8.4.1 Checking System Parameter Values

To check the values of your system parameters, invoke the SYSGEN utility by entering the following command at the DCL prompt: 


$ RUN SYS$SYSTEM:SYSGEN
SYSGEN>

At the SYSGEN prompt, enter the SHOW command to display the value of a system parameter. The following command displays the value for the MAXBUF system parameter: 


SYSGEN> SHOW MAXBUF

After checking the parameters with the SHOW command, enter the EXIT command at the SYSGEN prompt to return to DCL level.

If the current values are less than the values in Table 1-4, increase the system parameter settings. Section 1.8.4.4 describes the procedures for using the AUTOGEN utility to increase these values.

1.8.4.2 Calculating the Number of Free Global Pages and Global Sections

If your system parameter values are equal to or greater than the minimum values specified in Table 1-4, you can continue with the product installation. However, to install and run Compaq DECwindows Motif for OpenVMS software, you must have sufficient free global pages and global sections for the DECwindows Motif software and the file SYS$LIBRARY:DCLTABLES.EXE.

First, determine how many free global pages and global sections exist on your system and how many are required to reinstall a new version of SYS$LIBRARY:DCLTABLES.EXE. Then, if necessary, use the AUTOGEN utility to increase the values of the GBLPAGES and GBLSECTIONS system parameters.

Enter the following DCL command to determine the number of global pages required for SYS$LIBRARY:DCLTABLES.EXE: 


$ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE

This command returns the size (in blocks) of the file SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this figure as the number of global pages needed for the file.

Enter the WRITE command with the F$GETSYI lexical function to find the number of contiguous free global pages and the number of free global sections. The following example shows how to obtain this information at your terminal, which is the default for SYS$OUTPUT: 


$ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") [Return]
15848
$ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") [Return]
24

See Table 1-5 to determine whether the number of contiguous free global pages and the number of free global sections is sufficient. If these values are not sufficient to continue with the installation, then see Section 1.8.4.4, which describes the procedures for increasing these values using the AUTOGEN utility.

Table 1-5 Required Number of Contiguous Free Global Pages and Free Global Sections
Currently Running DECwindows Motif
System Resource Alpha Value VAX Value
CONTIG_GBLPAGES 12,000 6,000
FREE_GBLSECTS 20 20
     
Not Currently Running DECwindows Motif
System Resource Alpha Value VAX Value
CONTIG_GBLPAGES 92,000 47,000
FREE_GBLSECTS 260 130

1.8.4.3 Setting the Size of the Page File

In order for DECwindows Motif to run with acceptable performance, the page file must be large enough to handle the virtual memory requirements of your system. The optimal size of the page file depends on many factors, such as the amount of physical memory on the system and the application work load.

As a general rule, the page file size should be at least 75,000 blocks on OpenVMS Alpha systems and 50,000 blocks on OpenVMS VAX systems. However, these sizes may be too small on systems where a large number of applications are run. On a heavily loaded system it may be possible to achieve large performance improvements by increasing the size of the page file by a factor of two or more.

Normally you should run AUTOGEN with feedback and let AUTOGEN calculate the size of the page file based on the usage pattern on your system. To run AUTOGEN with feedback, enter the following DCL command: 


$ @SYS$UPDATE:AUTOGEN SAVPARAMS REBOOT FEEDBACK

You can also increase the size of the page file by running the SYSGEN utility or by invoking the command procedure SYS$UPDATE:SWAPFILES.COM.

For more information about setting the size of the page file and running AUTOGEN, see the Guide to Setting Up an OpenVMS System. For more information about performance tuning in general, see the Guide to OpenVMS Performance Management.

Previous Next Contents Index