realroot

Selects a specified Reality release or instance, by setting the necessary environment variables (REALROOT, PATH, etc.).

Syntax

UNIX Korn Shell

. realroot {[release || path]} {instance}

UNIX Bourne Shell

set {[release || path]} {instance} ; . realroot

Note: You can also use this syntax in the Korn shell.

UNIX C Shell

set argv="{[release || path]} {instance}" ; . realroot

Windows Command Prompt

realroot {[release || path]} {instance}

All Environments

realroot –q

Parameters

instance A single digit in the range 1 to 9 that identifies the required instance of the current version of Reality (the base instance).

release The version number of the required Reality release (without the initial letter). For example, to select Reality V12.0, specify 12.0. If you wish, you can include the instance number as part of the release; for example, 12.0_1 selects instance 1 of release V12.0.

path The path to the required Reality release or instance. For example, to select instance 1 of Reality V12.0 on a Windows host, you might specify c:\realman\12.0_1.

If you specify an instance but no release, the specified instance of the currently selected release is selected.
If you specify a release or path, but no instance, the base instance of the specified release is selected.
If you do not include any parameters, the base instance of the live release is selected.

Note that Reality instances are not supported on versions of Reality earlier than V12.0.

Options

–q Displays the currently selected instance. For example, on Windows:

realroot -q
Running Reality at C:\realman\12.0_3

Comments

Many Reality host utilities operate on the selected release or instance.

Examples

. realroot 1

When run in a UNIX Korn Shell, this command selects instance 1 of the live release.

set 12.0 1 ; . realroot

When run in a UNIX Bourne Shell, this command selects instance 1 of Reality V12.0.

. set argv=”c:\realman\12.0_1” ; . realroot

When run in a UNIX C Shell, this command selects instance 1 of Reality V12.0.

realroot c:\realman\12.0 1

When run at the Windows command prompt, this command selects instance 1 of Reality V12.0.

realroot

When run at the Windows command prompt, this command selects the base instance of the live release.