Environment Variables for Windows

A number of configuration parameters can be specified by setting host environment variables. These are set using the System option on the Control Panel - select the Advanced tab and click the Environment Variables button; system variables are listed in the bottom half of the dialog.

A particular version or instance of Reality:

$REALROOT/files/realityrc. The environment variables defined in this file affect all processes using the associated version of Reality.

Use netadmin to set the default database.

Note: You can set REALDBASE in $REALROOT/files/realityrc, but this will only set the default database for Reality commands entered at the command prompt. The preferred way of doing this is to use the netadmin utility.

Reality Version

The REALROOT and PATH environment variables define the location of the Reality software and therefore define the version of Reality which is run by a user. These variables are set to the live version of Reality when the user logs on, but can be changed to specify a non-live version by running the the realroot command.

Environment variables in Windows are set using the System option on the Control Panel - select the Advanced tab and click the Environment Variables button; system variables are listed in the bottom half of the dialog.

Setting Environment Variables at Logon

On Windows, when you log on via telnet, you can set environment variables by appending them to your user name. For example, to log on to an account called SUPPORT as the SYSMAN user, enter the following at the Logon please :  prompt:

SYSMAN REALACC=SUPPORT

You can enter multiple variables separated by spaces.

Available Environment Variables

The following table lists the available host environment variables.

Environment Variable	Purpose	Corresponding Database Configuration Parameter
MVSTYLEITEMLOCKS	If set, specifies that a single RELEASE operation will simultaneously release all the locks taken on a file item. Note that, unless ROSSTYLEITEMLOCKS has been explicitly cleared, setting this parameter also sets ROSSTYLEITEMLOCKS.	MvStyleItemLocks
REALACC	The Reality account and optional password (comma separated). See Database, User-id and Account for details.
REALADMINKEY	Specifies the host file that contains the administration encryption key. See Data Encryption for details.
REALBREAK	Specifies the Reality break key. See Reality Break Character for details.
REALCASEINSENSITIVE	Specifies that mkdbase should create item-id case-insensitive databases.
REALCIP_LOGLIMIT	The clean log size at which an autoswitch is executed. See Defining Clean Log Size Limit for details.
REALCIP_RLOGSPACECRITICAL	Specifies the threshold at which the oldest outstanding transaction is removed from the raw log (default, 85%).
REALCLOGPREFIX	The prefix used in clean log names. See Specifying the Clean Log Prefix for details.
REALCOMPTAPEIMAGE	Specifies the level of compression used when saving to a tape image file. See Tape Images for details.	CompressTapeImage
REALDBASE	The default database - this can be the database's full pathname or its network name as defined in the ROUTE-FILE /etc/ROUTE-FILE is a file on a UNIX host containing items that control the routing a particular process will take through a network. Routing control includes destination system names, network addresses, etc. On Windows hosts, this information is held in the Registry. For Reality external components that use the PC Standard Network Interface for Windows (PCSNI), routing information is held in a file called winsni.ini in the Windows folder. . See Database, User-id and Account for details.
REALDUMP	Determines the behaviour if a reality process aborts, as follows: 0 Abort into the system or DataBasic debugger. Do not generate a core dump or Dr Watson report. 1 Abort into the system or DataBasic debugger and generate a core dump or Dr Watson report. 2 Generate a core dump but do not enter the debugger (default) - this setting is recommended because it generates the most accurate core dump.
REALIDLEDESPOOLERSLEEP	Specifies the interval between despooler checks for jobs to be printed. See Despoolers for details.	RealIdleDespoolerSleep
REALLISTALLLOCKS	Specifies whether an item locks special file created with MAKE-SPECIAL should list all item locks or only those that are in contention.
REALLOGLEVEL	The minimum level of messages logged in the daemon log. See Master Database Files for details.
REALMAXLOGSIZE	The maximum size of the daemon.log. See Daemon Log Rotation for details.
REALNOAUTOSTART	If set, specifies that the Reality daemons/services should not be started automatically when the host starts.
REALNOREJECTCLEAR	Specifies that TL-REJECT should not be cleared after each clean log restore. See Disabling Clearance of TL-REJECT Log for details.
REALOLDLOGDIR	The directory in which old log files are saved. See Daemon Log Rotation for details.
REALOLDLOGMAX	The maximum number of old log files that can be held in the old logs directory. See Daemon Log Rotation for details.
REALOLDSAVE	Specifies that data should be saved in a format that compatible with versions of Reality earlier than V9.0. See Transferring Data between Different Versions of Reality for details.
REALPLIDFORMAT	Allows you to specify a user-defined PLid format.
REALPRIORITYINC	Specifies the amount by which the SET-PRIORITY command changes the priority of the reality process.
REALRESERVERLTYXDSP	The number of ports reserved for despooler connections.
REALRESERVEROSFS	The number of ports reserved for network connections to the remote file server.
REALRESERVERSCSRVR	The number of ports reserved for network connections to the remote subroutine server.
REALRESERVERWSRVR	The number of ports reserved for network connections to the RealWeb server.
REALRESERVESQLSRVR	The number of ports reserved for network connections to the SQL server.
REALROOT	The location of the Reality software and therefore the version of Reality which is run by a user. See Reality Version for details.
REALTAPE	Specifies a tape definition to be used in the database configuration file.
REALTLDUMPDEN	Specifies the tape density used by tlmenu for archiving and loading clean logs. See Specifying Tape Density for Clean Logs
REALTLDUMPSIZE	Specifies the tape block size used by tlmenu for archiving and loading clean logs. See Specifying Tape Block Size for Clean Logs for details.
REALUSER	The Reality user-id and optional password (comma separated). See Database, User-id and Account for details.
REALUSEMMAP	On Windows REALUSEMMAP=0 suppresses use of memory mapped I/O.
REPLICATEITEMLOCKS	If set, specifies that item locks are replicated if you copy the contents of a file variable to another variable. Note that the resulting locks must be separately released; releasing a lock on one file variable does not release that on the other.	ReplicateItemLocks
RFSSETFREE	Specifies that every block in the database should be marked as free or in use (the default is to mark only the first block of each contiguous set of blocks). Selecting this option makes the free space check option (-f) available on the realdbck utility, but can reduce performance in normal use. You should only set this option if directed by Northgate support staff.	ForceFreeSpaceUpd
ROSSTYLEITEMLOCKS	If set, specifies that item locks should be held separately from any file variable; as a result, closing a file will not release any item locks.	RosStyleItemLocks
UC_PROCPLID	Specifies the PLId format used for daemon processes that do not already have a PLId. For details, see Environment Variables in UNIX-Connect System Administration
UC_TLI_CONNECT_TO	Specifies the length of time, in milliseconds, for which the UNIX-Connect software will attempt to establish an outgoing connection. For details, see Environment Variables in UNIX-Connect System Administration.