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. |
|
|
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. |
|
|
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. |
|
|
REALDBASE |
The default database - this can be the database's full pathname or its network name as defined in the ROUTE-FILE |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
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 Public Services support staff. |
|
|
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. |
||
|
RWSMAXSIZE |
Sets the maximum size, in kilobytes, of the workspace. This value is capped at 2097151 KB. |
|
|
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. |
|
