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}

. realroot -q

UNIX Bourne Shell

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

UNIX C Shell

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

Windows Command Prompt

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

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 V15.1, specify 15.1. If you wish, you can include the instance number as part of the release; for example, 15.1_1  selects instance 1 of release V15.1.

path The path to the required Reality release or instance. For example, to select instance 1 of Reality V15.1 on a Windows host, you might specify c:\realman\15.1_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\15.1_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 15.1 1 ; . realroot

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

. set argv="c:\realman\15.1_1" ; . realroot

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

realroot c:\realman\15.1 1

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

realroot

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