Chapter 3. Configuring NQE variables

The NQE configuration utility (nqeconfig(8)) assists administrators in creating and maintaining the NQE configuration file (nqeinfo file). The NQE configuration file contains the NQE configuration variables and is created by the NQE installation procedure. All configured NQE server nodes and clients must each have a unique NQE configuration file.

When you use the NQE configuration utility, each NQE configuration variable is displayed along with its value. Most variables are configurable. However, some variables are derived from the values of other variables and may not be changed. This helps to ensure that changes are propagated throughout the file and reduces the risk of misconfiguration due to conflicting values of related variables.

Note: Some variables may be set in the user's environment to indicate individual preferences. The NQE configuration file variables are used only if an individual has not indicated a preference.

This chapter describes how to start and use the NQE configuration utility. For a complete list of all NQE configuration variables, see the nqeinfo(5) man page or the NQE configuration utility Help facility.

Note: For UNICOS 9.0.x and 9.1 systems upgrading to this NQE release, Appendix C, “config.h/nqeinfo File Variables”, includes a list of NQE configuration file (nqeinfo file) names that were previously included in the config.h file.

Starting the NQE Configuration Utility

To start the NQE configuration utility, use the nqeconfig(8) command. The nqeconfig(8) command has the following syntax:

nqeconfig [-a] [-f filename][-o filename] [-D variable=value[,variable=value,...]]
The nqeconfig(8) command accepts the following options:



Instructs nqeconfig(8) to run in autopilot mode. No prompting occurs when this command is run in this mode. The configuration file is generated using the values from the file indicated by the NQEINFOFILE environment variable (or from the /etc/nqeinfo file if the NQEINFOFILE variable is not set), from the values in the input file specified on the command line with the -f option, and from other values specified with the -D option.

-f filename 

Indicates the input file used to specify additional configuration variables and new values for existing variables. The format of this file is the same as that of the nqeinfo file.

-o filename 

Specifies the file location for the new configuration file. This location may be overridden in the File menu of the nqeconfig(8) display.

-D variable=value [,variable=value,...] 

Allows you to specify, on the command line, additional configuration variables and new values for existing variables. The argument to this variable is a comma-separated list of variable=value pairs. Multiple -D options may be specified.

Editing the NQE Configuration Variables

By default, after you execute the nqeconfig(8) command, the following NQE Configuration display appears, as shown in Figure 3-1:

Figure 3-1. NQE Configuration Display, Condensed View

Caution: Always stop NQE before making changes to the NQE configuration. Each NQE command and server program reads the configuration file once during command or server initialization. Changes made to the configuration file while NQE is running can result in NQE commands and servers using different configuration file values, which will result in unpredictable problems.

The NQE Configuration display presents the NQE configuration variables and their associated values. Values with a dark background are derived from the values of other variables and may not be edited. Other values may be edited either by entering the appropriate text or by choosing a value from a set of options. The scrollbar allows you to scroll through the list.

When you have finished making configuration changes, write the configuration changes to the new configuration file by clicking on the OK button, or you can cancel the changes by clicking on the Cancel button.

Context-sensitive help is available at the bottom of the display.

NQE Configuration Display Menus

The following menus provide additional functionality:



File menu 

Contains options that allow you to save your changes to the default file location, to the location specified with the -o option on the command line, to specify another file and save the changes, or to exit the utility without saving changes. The File menu is as follows:

Figure 3-2. NQE Configuration Display, File Menu

Action menu 

Allows you to revert to the NQE default configuration values, to revert to the values in use when the utility started, or to add variables to or remove variables from the configuration. The Action menu is as follows:

Figure 3-3. NQE Configuration Display, Action Menu

View menu 

Allows you to select one of three views: Condensed, Full, or Install. The View menu is as follows:

Figure 3-4. NQE Configuration Display, View Menu

The Condensed view displays only the variables that you may modify. This is the default view when you execute the nqeconfig(8) command. The Condensed view is shown in Figure 3-1.

The Full view, as shown below, displays all variables that will be placed in the output file:

Figure 3-5. NQE Configuration Display, Full View

The Install view, which is shown as follows, is functional only during the NQE installation process; this view applies to all systems except UNICOS/mk systems, UNICOS systems, and IRIX systems that use the inst utility:

Figure 3-6. NQE Configuration Display, Install View