Document revision date: 15 July 2002

1. Executes the first pass of AUTOGEN during peak workload times to collect data on realistic work loads. This command runs a very fast image so it does not degrade system response.
2. Executes the second pass of AUTOGEN during off-peak hours to interpret the data collected in the first pass.
3. Mails the resulting report file named AGEN$PARAMS.REPORT to the SYSTEM account.
4. Cleans up the files created.
5. Resubmits the command procedure.

If the command procedure report described in Section 15.6 shows AUTOGEN's calculations are different from the current values, correct the tuning by executing AUTOGEN with one of the two following commands:

• If the system can be shut down and rebooted immediately, execute the following command:

  $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT FEEDBACK

• If the system cannot be shut down and rebooted immediately, execute the following command to reset the system parameters:

  $ @SYS$UPDATE:AUTOGEN GETDATA SETPARAMS FEEDBACK

  The new parameters will take effect the next time the system boots.

SYSMAN provides the ability to inspect and modify system parameters for an entire cluster or for any group of nodes, rather than just one system. The PARAMETERS commands available in SYSMAN duplicate the parameter functions of the System Generation utility (SYSGEN).

You can use SYSMAN to manage system parameters as follows:

Task	For More Information
Show parameter values	Section 15.7.2
Modify current values in the parameter file	Section 15.7.3
Modify active values on a running system 1	Section 15.7.4

SYSMAN provides the commands and functions shown in Table 15-3.

Table 15-3 SYSMAN PARAMETERS Commands

Command	Function
PARAMETERS SHOW	Displays parameter values. Requires the name of the parameter.
PARAMETERS USE	Reads a set of parameters from memory or disk into the work area for inspection or modification. Requires a file name or the additional parameters ACTIVE or CURRENT.
PARAMETERS SET	Changes parameter values only in the work area; more permanent modification requires the PARAMETERS WRITE command. Requires the name and value of the parameter.
PARAMETERS WRITE	Writes the content of the work area to memory or to disk. Requires a file name or the additional parameters ACTIVE or CURRENT.

For more information about the temporary work area, see the next section.

15.7.1 Understanding Parameter Values and SYSMAN

It helps to understand the different system parameter values explained in Section 15.1.1. Briefly, current values are stored in the default parameter file on disk. Active values are stored in memory and are used while the system is running. In addition to these values, SYSMAN writes a temporary copy into its own work area on disk. Figure 15-2 illustrates these different sets of values and how SYSMAN commands affect them. In this figure:

1. WRITE ACTIVE writes temporary parameter values to memory.
2. USE ACTIVE reads values from memory into the work area, where you can modify them.
3. WRITE CURRENT writes temporary parameter values to disk, where they become current values. They become active the next time the system boots.
4. USE CURRENT reads the current values from disk into the work area, where you can modify them.

Figure 15-2 SYSMAN Temporary, Active, and Current Parameter Values

During a typical session, you can display and change values in the following sequence:

1. Read values into SYSMAN's temporary work space with the USE command. USE ACTIVE reads in active values. USE CURRENT reads in current values.
2. Display the parameter values with the SHOW command.
3. Change a value with the SET command. You must use the WRITE command to activate the value.
4. Make the change effective with the WRITE command:
   • WRITE ACTIVE writes the value to the set of active values. (You can change an active value only if the parameter is a dynamic parameter.)
   • WRITE CURRENT writes the value to the set of current values.

For a list of all the system parameters, refer to the OpenVMS System Management Utilities Reference Manual.

15.7.2 Showing Parameter Values with SYSMAN

Use the SYSMAN command PARAMETERS SHOW to display parameter values for all the nodes in a cluster.

Examples

1. The following example shows one method to display information about parameters. In this case, using the /LGI qualifier displays all login security control parameters. You can display many categories of parameters, such as /ACP, /ALL, and /SPECIAL. Refer to the OpenVMS System Management Utilities Reference Manual for a complete list of parameters and parameter categories.

   $ RUN SYS$SYSTEM:SYSMAN SYSMAN> PARAMETERS SHOW/LGI Parameters in use: Active Parameter Name Current Default Min. Max. Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- LGI_BRK_TERM 0 1 0 1 Boolean D LGI_BRK_DISUSER 0 0 0 1 Boolean D LGI_PWD_TMO 30 30 0 255 Seconds D LGI_RETRY_LIM 3 3 0 255 Tries D LGI_RETRY_TMO 20 20 0 255 Seconds D LGI_BRK_LIM 5 5 0 255 Failures D LGI_BRK_TMO 300 300 0 -1 Seconds D LGI_HID_TIM 300 300 0 -1 Seconds D

2. The following example invokes SYSMAN and specifies the environment to be the local cluster, which consists of NODE21 and NODE22. The example also displays the active value for the LGI_BRK_TMO parameter, which controls the number of seconds that a user, terminal, or node is permitted to attempt login. In this case, it is 600.

   $ RUN SYS$SYSTEM:SYSMAN SYSMAN> SET ENVIRONMENT/CLUSTER %SYSMAN-I-ENV, Current command environment: Clusterwide on local cluster Username MORIN will be used on nonlocal nodes SYSMAN> PARAMETERS SHOW LGI_BRK_TMO Node NODE21: Parameters in use: ACTIVE Parameter Name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- LGI_BRK_TMO 600 300 0 -1 Seconds D Node NODE22: Parameters in use: ACTIVE Parameter Name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- LGI_BRK_TMO 600 300 0 -1 Seconds D

Use the SYSMAN command PARAMETERS WRITE to write system parameter values and the name of the site-independent startup command procedure to your choice of parameter file or the current system parameter file on disk.

The PARAMETERS WRITE CURRENT command sends a message to OPCOM to record the event, unless you have changed the system message format with the DCL command SET MESSAGE.

Examples

1. The following example creates a new parameter specification file:

   SYSMAN> PARAMETERS WRITE SYS$SYSTEM:NEWPARAM

2. When used with the PARAMETERS SET command, the PARAMETERS WRITE command modifies the current system parameter file on disk:

   SYSMAN> PARAMETERS SET LGI_BRK_TMO 300 SYSMAN> PARAMETERS WRITE CURRENT

Using the SYSMAN commands PARAMETERS SET, PARAMETERS WRITE, and PARAMETERS USE enables you to modify active parameter values.

Modifying active values immediately affects dynamic parameters by changing their values in memory. Appendix C of the OpenVMS System Management Utilities Reference Manual identifies dynamic parameters, as does the SYSMAN command PARAMETERS SHOW/DYNAMIC. Values for nondynamic parameters cannot be changed while the system is running.

Modifying active values does not affect current values in the system parameter file on disk, because the next time you boot the system, the values on disk are established as the active values.

If you set new active parameter values and you want to use the new values for subsequent boot operations, write the new values to the current parameter file with the PARAMETERS WRITE CURRENT command, as shown in the Examples section.

Examples

1. The following example changes the LGI_BRK_TMO value to 300 in the work area, writes this change into memory as an active value, and displays the active value:

   SYSMAN> PARAMETERS SET LGI_BRK_TMO 300 SYSMAN> PARAMETERS WRITE ACTIVE SYSMAN> PARAMETERS SHOW LGI_BRK_TMO Node NODE21: Parameters in use: ACTIVE Parameter Name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- LGI_BRK_TMO 300 300 0 -1 Seconds D Node NODE22: Parameters in use: ACTIVE Parameter Name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- LGI_BRK_TMO 300 300 0 -1 Seconds D

2. The following example calls the current parameter values, including LGI_BRK_TMO, from disk to the work area, then displays LGI_BRK_TMO. In this example, the current value on disk is 600.

   SYSMAN> PARAMETERS USE CURRENT SYSMAN> PARAMETERS SHOW LGI_BRK_TMO Node NODE21: Parameters in use: CURRENT Parameter Name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- LGI_BRK_TMO 600 300 0 -1 Seconds D Node NODE22: Parameters in use: CURRENT Parameter Name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- LGI_BRK_TMO 600 300 0 -1 Seconds D

3. The next example writes the LGI_BRK_TMO value of 600 from the work area to memory, where it becomes the active value on the running system. Note that the command PARAMETER WRITE ACTIVE writes all the parameter values from the work area into memory, not just the value of LGI_BRK_TMO.

   SYSMAN> PARAMETERS WRITE ACTIVE SYSMAN> PARAMETERS USE ACTIVE SYSMAN> PARAMETERS SHOW LGI_BRK_TMO Node NODE21: Parameters in use: ACTIVE Parameter Name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- LGI_BRK_TMO 600 300 0 -1 Seconds D Node NODE22: Parameters in use: ACTIVE Parameter Name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- LGI_BRK_TMO 600 300 0 -1 Seconds D

Although it is not the recommended method, you can also use the System Generation utility (SYSGEN) to manage system parameters as follows:

Task	For More Information
Show parameter values	Section 15.8.2
Modify current values in the default parameter file	Section 15.8.3
Modify active values on a running system 1	Section 15.8.4
Create a new parameter file	Section 15.8.5

SYSGEN provides the commands shown in Table 15-4 for managing system parameters. Refer to the SYSGEN section of the OpenVMS System Management Utilities Reference Manual for detailed descriptions of SYSGEN commands.

Table 15-4 SYSGEN Commands Used with System Parameters

Command	Function
SHOW	Displays parameter values.
USE	Reads a set of values from memory or disk into a temporary work area for inspection or modification.
SET	Changes parameter values only in the work area; more permanent modification requires the WRITE command.
WRITE	Writes the content of the work area to memory or to disk.

For more information about the temporary work area, see the next section.

15.8.1 Understanding Parameter Values and SYSGEN

You should understand the different system parameter values explained in Section 15.1.1. Briefly, current values are stored in the default parameter file on disk. Active values are stored in memory and are used while the system is running. In addition to these values, SYSGEN writes a temporary copy into its own work area on disk. Figure 15-3 illustrates these different sets of values and shows how SYSGEN commands affect them.

Figure 15-3 SYSGEN Temporary, Active, and Current Parameter Values

In a typical session, you might display and change values in the following sequence:

1. Read values into SYSGEN's temporary work space with the USE command. USE ACTIVE reads in active values. USE CURRENT reads in current values.
2. Display the parameter values with the SHOW command.
3. Change a value with the SET command. (Note, however that the SET command only changes the value in SYSGEN's temporary work area.)
4. Make the change effective with the WRITE command:
   • WRITE ACTIVE writes the value to the set of active values in memory. (You can change an active value only if the parameter is a dynamic parameter.)
   • WRITE CURRENT writes the value to the set of current values on disk.

For a list of all the system parameters, refer to the OpenVMS System Management Utilities Reference Manual.

15.8.2 Showing Parameter Values with SYSGEN

To display values for system parameters, perform the following steps:

1. Invoke SYSGEN by entering the following command:

   $ RUN SYS$SYSTEM:SYSGEN

2. Enter the USE command to specify which values you want to display, as follows:

   To Display	Enter
   Active values	USE ACTIVE
   Current values	USE CURRENT
   Values from another parameter file	USE file-spec
   	For file-spec, specify the parameter file from which you want to display values; for example, USE SYS$SYSTEM:ALTPARAMS.DAT

3. Enter a SHOW command in the following format:

   SHOW [/qualifier] [parameter-name]

   
   Specify qualifiers to display parameters grouped by type. For example:

   To Display Values For	Enter
   The WSMAX parameter	SHOW WSMAX
   All dynamic parameters	SHOW/DYNAMIC
   All parameters in the TTY category	SHOW/TTY
   All parameters	SHOW/ALL

For more information about the SYSGEN SHOW command and qualifiers, refer to the SYSGEN section of the OpenVMS System Management Utilities Reference Manual.

Example

The following example uses SYSGEN to show the current values of all TTY system parameters:

$ RUN SYS$SYSTEM:SYSGEN SYSGEN> USE CURRENT SYSGEN> SHOW/TTY

Parameters in use: Current(1) Parameter Name Current Default Min. Max. Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- (2) (3) (4) (5) (6) (7) TTY_SCANDELTA 10000000 10000000 100000 -1 100Ns TTY_DIALTYPE 0 0 0 255 Bit-Encode TTY_SPEED 15 15 1 16 Special TTY_RSPEED 0 0 0 16 Special TTY_PARITY 24 24 0 255 Special TTY_BUF 80 80 0 65535 Characters TTY_DEFCHAR 402657952 402657952 0 -1 Bit-Encode TTY_DEFCHAR2 135178 4098 0 -1 Bit-Encode TTY_TYPAHDSZ 78 78 0 -1 Bytes TTY_ALTYPAHD 2048 200 0 32767 Bytes TTY_ALTALARM 750 64 0 -1 Bytes TTY_DMASIZE 64 64 0 -1 Bytes D (8) TTY_CLASSNAME "TTY" "TTY" "AA" "ZZ" Ascii TTY_SILOTIME 8 8 0 255 Ms TTY_TIMEOUT 3600 900 0 -1 Seconds D TTY_AUTOCHAR 7 7 0 255 Character D SYSGEN>

SYSGEN displays the following information:

1. The values in use (in this example, current values)
2. The name of the system parameter
3. The value requested (in this example, the current value). The heading of this column is always "Current," regardless of whether it displays the current or active value of the parameter. In this context, "Current" refers to the value of this parameter currently in use, as specified by the USE command; it does not refer to the current value of the parameter stored on disk with the WRITE CURRENT command.
4. The default value
5. The minimum value
6. The maximum value
7. The unit of allocation
8. A "D," if the system parameter is dynamic

	privacy and legal statement
6017PRO_070.HTML