SAND CDBMS Administration Guide
The Nucleus.ini File

The NUCLEUS Environment Variable

Any of the operating parameters that can be set in the nucleus.ini file can also be set for the current operating environment by including them in the NUCLEUS variable. Settings made in the NUCLEUS variable override those made in the nucleus.ini file. To set the NUCLEUS variable, refer to the set of instructions for the appropriate operating system/shell.

UNIX

Use the following syntax at the operating system command prompt (the quotation marks must be typed as shown):

Bourne and Korn Shells:

NUCLEUS='PARAMETER-NAME:value [PARAMETER-NAME:value...]'
export NUCLEUS

C Shell:

setenv NUCLEUS 'PARAMETER-NAME:value [PARAMETER-NAME:value...]'

Any number of parameters can be set in this way; each parameter-name/value pair must be separated by a space. All of the parameter-name/value pairs must be enclosed by quotation marks. If a dash ( - ) is specified for value, the SAND CDBMS default value is used.

Windows

Perform the following actions to set or edit the NUCLEUS environment variable in Windows. Normally, the NUCLEUS variable with the SUPPORT parameter is automatically set during the initial SAND CDBMS installation. Note that quotation marks must not surround the parameter value(s) in Windows.

Windows 2000:

1. Open the Windows Control Panel (Start Menu > Settings > Control Panel).
2. On the Control Panel, double-click System. The System Properties dialog box opens.
3. On the Advanced pane, click ENVIRONMENT VARIABLES (Alt+E). The Environment Variables dialog box appears.
4. On the Environment Variables dialog box, click NEW (Alt+N) under the system variables section to create the NUCLEUS variable, or select NUCLEUS and click EDIT (Alt+I) if the variable has already been defined. The New System Variable or Edit System Variable dialog box opens.
5. On the New/Edit System Variable dialog box, enter the required information:

   Variable Name (Alt+N): NUCLEUS
   Variable Value (Alt+V): PARAMETER-NAME:value [PARAMETER-NAME:value...]

   Any number of parameters can be set in this way; each parameter-name/value pair must be separated by a space. If a dash ( - ) is specified for value, the SAND CDBMS default value is used. Note that the SUPPORT parameter value must be a short path name; by default, this value is C:\PROGRA~1\SAND.

6. Click OK to make the settings and close the New/Edit System Variable dialog box.
7. Click OK to close the Environment Variables dialog box.
8. Click OK to close the System Properties dialog box.

Example (UNIX)

NUCLEUS='SUPPORT:/usr/sand RUNMODE:virtual PRIMARYDB:db1'
export NUCLEUS

Any database instance started subsequently will run in Virtual Mode, with db1 as the underlying primary ("real") database.