The following sections describe:

• Using MODPARAMS_EIS.DAT to update system parameters
• Calculating the values for GBLPAGES and GBLSECTIONS
• Checking system parameter values
• Changing system parameter values with AUTOGEN

If you are using Phase IV names with DECnet-Plus, you must determine the values for SCSNODE, SCSSYSTEMID, and SYSMWCNT (see the PATHWORKS^tm Version 6 for OpenVMS (Advanced Server) Server Installation and Upgrade Guide). For example:

SCSNODE = same as DECnet node name for the server SCSSYSTEMID = (1024x DECnet area number) + DECnet node number SYSMWCNT = current value of SYSMWCNT + (number of GBLPAGES being added / 128)

Round up SYSMWCNT to the nearest integer.

For example, if you are using GBLPAGES=78 000 to install PATHWORKS Version 6 for OpenVMS, add an additional 610 to SYSMWCNT.

2.4.2 OpenVMS Cluster System Parameters

The Enterprise Integration Packages provide the data file, MODPARAMS_EIS.DAT, that includes the minimum parameters necessary to install all the Enterprise Integration Packages components on OpenVMS Alpha. (Table 2-3 lists the parameter requirements for all the components.)

The MODPARAMS_EIS.DAT file enables you to optimize preinstallation tasks in the following ways:

• You can reset all your system parameters.
• You will need only one system reboot.

To reset all your system parameters using MODPARAMS_EIS.DAT:

1. Find MODPARAMS_EIS.DAT in the [DEIS020.DOCUMENTATION] directory; to locate the volume number of the CD where this directory resides, refer to your SPL master index.
2. Append the MODPARAMS_EIS.DAT file to the end of SYS$SYSTEM:MODPARAMS.DAT.
3. After combining the two files, delete the lines that contain the lower values if there are two values for the same MIN_parameter.
4. Use AUTOGEN to tune the parameters based upon your system workload.
5. Reboot the system.

You may need to increase the parameters specified in these files, depending on what other products are installed on your system.

2.4.4 Calculating the Values for Global Pages (GBLPAGES) and Global Sections (GBLSECTIONS)

To calculate how many unused global pages and global sections your system has:

1. Run the Install utility (INSTALL) using the following command:

   $ INSTALL LIST /GLOBAL /SUMMARY

   
   The Install utility displays a summary of global pages and global sections used by your system, as well as the current number of unused global pages. For example:

   Summary of Memory Global Sections 258 Global Sections Used, 22580/3420 Global Pagelets Used/Unused

2. Determine if the number of unused global pages (3420 in the example) is equal to or greater than what you need. If the number of unused pages is less than what you require, you need to increase the value for GBLPAGES.
3. Note the amount shown for global sections used (258 in this example).
4. Run the System Generation utility (SYSGEN) and use the SHOW command to determine how many global sections have been allocated. For example:

   $ RUN SYS$SYSTEM:SYSGEN SYSGEN> SHOW GBLSECTIONS Parameter Name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- GBLSECTIONS 512 250 20 4095 Sections

5. Add the amount shown in the example summary in step 1 (258) to the value for GBLSECTIONS in Table 2-3. If the resulting value is greater than the value for currently available GBLSECTIONS as shown in step 4, you must increase the value of the GBLSECTIONS parameter.

Section 2.4.7 describes the procedures for increasing these values using AUTOGEN. See the OpenVMS System Management Utilities Reference Manuals or the OpenVMS System Manager's Manual for information on using AUTOGEN.

You can use the WRITE command with the F$GETSYI lexical function to find the number of contiguous free global pages and global sections. The following example shows how to get this information at your terminal (the default for SYS$OUTPUT):

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

2.4.5 System Parameter Requirements

Table 2-3 lists the system parameters required if you install all of the components of the Enterprise Integration Packages. These system parameters are provided in the file MODPARAMS_EIS.DAT. See Section 2.4.7 to fine tune system parameters for the particular work load needs of your system.

Table 2-3 System Parameter Requirements for R2.0

Parameter	R2.0 Value	R1.1 Value	Notes
GBLPAGES	275000 1	240000 1
GBLPAGFIL	3248 1	3248 1
GBLSECTIONS	1525 1	1273 1
MAXPROCESSCNT	50	32
CLISYMTBL	512	512
RESHASHTBL	2048	2048
WSMAX	32768	32768
CHANNELCNT	568	568	Or any number larger than the largest FILLM used on the system (whichever is larger).
MAXBUF	8192	8192	If Motif is loaded.
PROCSECTCNT	100	100
SWPOUTPGCNT	512	512
NPAGEDYN	1642000	1642000
PAGEDYN	901120	901120
NPAGEVIR	6496256	6496256
KSTACKPAGES	2	2
WINDOW_SYSTEM	1	1
PQL_MASTLM	210	210
PQL_DBIOLM	100	100
PQL_MBIOLM	100	100
PQL_MBYTLM	100000	100000
PQL_MDIOLM	100	100
PQL_MENQLM	350	350
PQL_MFILLM	100	100
PQL_MPGFLQUOTA	32768	32768
PQL_MPRCLM	10	10
PQL_MWSDEFAULT	1024	1024
PQL_MWSEXTENT	8192	8192
PQL_MWSQUOTA	2048	2048
GH_RES_CODE	1024	1024
GH_RSRVPGCNT	2000	2000
IMGREG_PAGES	2000	2000
SCSNODE	--	--	See the discussion in Section 2.4.
SCSSYSTEMID	--	--	See the discussion in Section 2.4.
SYSMWCNT	--	--	See the discussion in Section 2.4.

To check the values of your system parameters:

1. Enter the following command at the DCL prompt to invoke the System Generation (SYSGEN) utility:

   $ RUN SYS$SYSTEM:SYSGEN

   
   The screen displays the SYSGEN> prompt.

2. Enter the SHOW command and a system parameter name to display the value of that parameter.
   The values displayed should equal or exceed the value of each system parameter listed in Table 2-3 for the Enterprise Integration Packages package you are installing.
   For example, the following command displays the value for the WSMAX system parameter:

   SYSGEN> SHOW WSMAX

3. After checking the parameters, enter EXIT at the SYSGEN> prompt to return to the DCL level.

Use the AUTOGEN command procedure to change system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the values you reset manually.

Each Enterprise Integration Packages component has its own system parameter requirements. If the components are treated separately, you will have to reboot, using AUTOGEN, for each component. See the individual component installation guides for detailed preinstallation information.

To change system parameters with AUTOGEN:

1. Edit the file SYS$SYSTEM:MODPARAMS.DAT using these guidelines:
   • 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 that includes both the name of the parameter and its value. For example:

     WSMAX = 4200

   • To modify incremental parameters such as GBLPAGES and GBLSECTIONS, use ADD_. For example, the following increases the global page setting by 2000:

     ADD_GBLPAGES = 2000

     
     When you set the page file quota, do not use a value that exceeds the amount of page file space available on the system.
     DIGITAL recommends that you use MIN_parameter to set parameters in MODPARAMS.DAT. (An exception does exist: values for NPAGEDYN are additive.) Add the values supplied in Table 2-3 to the current system values. Use SYSGEN to determine the current values of NPAGEDYN and NPAGEVIR. For example:

     $ MCR SYSGEN SYSGEN> USE ACTIVE SYSGEN> SHOW NPAGEDYN Parameter Name Current Default Min. Max. Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- NPAGEDYN 4884992 360000 16384 -1 Bytes

     
     The current column shows what your system is currently using. In this example you would add a line in the following format to your MODPARAMS.DAT file:

     MIN_NPAGEDYN = 4884992 + value-from-sys-param-table

     
     In this format, value-from-sys-param-table is the value from Table 2-3.

2. Exit from the editor and execute the AUTOGEN procedure to recalculate your system parameters. Reboot using the following command:

   $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT

   Note When you specify REBOOT, AUTOGEN 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.

   
   The AUTOGEN utility automatically adjusts some of the SYSGEN parameters based on the consumption of resources since the last reboot. If you do not want to take advantage of this automatic adjustment, include the NOFEEDBACK qualifier on the AUTOGEN command line.
   For more information about using AUTOGEN, refer to the OpenVMS System Manager's Manual: Essentials.