This section discusses the requirements for installing your DECwindows Motif Version 1.2-5 software using PCSI and the VMSINSTAL installation procedure.

The installation procedure checks the following:

• Whether you are logged in to an appropriately privileged account (VMSINSTAL installations only)
• Whether any other users are logged in to the system
• Whether you have the minimum required system account quotas and limits
• Whether you have the minimum required disk space
• Whether you have the minimum required system parameter values

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:

• Install fewer optional files.
• For VMSINSTAL installations, restart the installation and specify another disk to use as an alternate working device. See Section 3.1.2 for information about using an alternate working device.
• Terminate the installation, create more free disk space on the system disk, and restart the installation.
• Continue the installation and risk running out of disk space.

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.

Table 1-3 Approximate Required Disk Space by Component (in Blocks)

Component		Alpha	VAX
Base kit 1		50,000	43,200
	Runtime support	Not applicable	27350
	CDA support	Not applicable	3650
	Motif applications	Not applicable	12200
Desktop support		52,800 2	Not applicable
	New Desktop	42,000	Not applicable
	DECwindows desktop	8,000	Not applicable
	Manual pages for New Desktop	2,800	Not applicable
Programming environment		12,750 3	12,250 2
	C, C++	7,200	6,750
	FORTRAN	2,400	2,450
	Pascal	3,000	3,050
	New Desktop	150	Not applicable
Example programs		13,000 4	9550
	Sound examples	1,600	Not Applicable
	Programming examples	10,100	9550
	New Desktop examples	1,300	Not Applicable
Translated image support		33,600	Not applicable
NCSA Mosaic		Not applicable	1200 5
Total disk space required:		178,000	78,000

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

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

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 DECwindows Motif Version 1.2-5 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.

1.8.4.4 Changing System Parameter Values Using the AUTOGEN Utility

Use the AUTOGEN utility to change system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the values you reset manually. To change system parameters with AUTOGEN, edit the file SYS$SYSTEM:MODPARAMS.DAT.

To change a parameter value listed in this file, delete the current value associated with that parameter and enter the new value.

To add a new parameter, add a line to the file and include both the name of the parameter and its value. For example:

MIN_MAXBUF = 8192

To make incremental adjustments to parameters, such as global pages and global sections, use ADD_. The following example increases the global pages value by 30,000:

ADD_GBLPAGES = 30000

Table 1-6 lists the system parameters that you need to adjust incrementally.

Table 1-6 Recommended System Parameter Values to Use with the ADD_ Option

System Parameter	Alpha Increment	VAX Increment
SYSMWCNT	---	235
GBLSECTIONS	280	140
GBLPAGES	92,000	30,000
GBLPAGFIL	768	5,000
NPAGEDYN	300,000	500,000
PAGEDYN	180,000	100,000

After you enter all your changes, exit from the file and execute the AUTOGEN utility to recalculate your system parameters. Enter the following command to recalculate your system parameters and reboot the system:

$ @SYS$UPDATE:AUTOGEN GETDATA REBOOT

When you specify REBOOT, the AUTOGEN utility performs an automatic system shutdown and then reboots the system. Any users logged in to the system are immediately disconnected during the shutdown. The automatic reboot puts the new parameter values into effect.

For details about using AUTOGEN, see the section about the AUTOGEN utility in the OpenVMS System Manager's Manual and the AUTOGEN section in OpenVMS System Management Utilities Reference Manual.