ENV_VARS

AccuRev Environment Variables

Usage

bash shell:             <AC_ENV_VAR>=<value>
Windows command line: set <AC_ENV_VAR>=<value>

Description

This Help page provides a list of AccuRev environment variables. (There is no “ENV_VARS” command.)

See AccuRev User Preferences for information about using these settings in the preferences.xml file.

Options

ACCUREV_BIN

Indicates to the GUI and the WebUI the directory on the client machine that contains the AccuRev executables. If ACCUREV_BIN is not set, the GUI and WebUI use the "ACCUREV_BIN:" path that is returned by the accurev info command (using the accurev binary selected by the PATH environment variable).

ACCUREV_COMMAND_LOGFILE

The accurev CLI tool checks whether this variable is defined and contains the pathname of a text file on the client machine. If the pathname is valid, a timestamped copy of the complete command line is appended to the log file when the command begins execution; another timestamped entry is written to the log file when the command completes. (The results of the command are not written to the log file.)

ACCUREV_CONSOLE

(used by AccuRev Server only) If this variable is set to 1, the AccuRev Server sends console messages to STDOUT in addition to the acserver.log file. (Alternative: start the AccuRev Server with the command-line argument console.)

ACCUREV_DIFF_FLAGS

diff command: the command-line options to be passed to the file-comparison program.

ACCUREV_GUI_INSTANCE

The value of this environment variable dictates the placement of the GUI splash and login screens when running multiple GUIs. Valid values take the format <m>:<n>, where <m> is the (1-based) number of this particular GUI instance and <n> is the total number of GUI instances you intend to run on the client machine. The GUIs can display up to 4 tiled splash and login screens and the value for <m> maps to the output display quadrants as follows:

1 2
3 4

Before running a given GUI instance, use this environment variable to specify the desired location. If, for example, you intend to have four GUIs running and you want the next GUI instance to appear in the upper-right quadrant of the screen (quadrant 2), specify the value of this environment variable as 2:4. Reset the value of this environment variable to the location you want before running the next instance of the GUI. If you run more than four GUI instances, the extra instances start to overlay the first four locations.

ACCUREV_HOME

The full pathname of the parent directory of the .accurev subdirectory. Setting this variable overrides AccuRev’s automatic determination of this subdirectory’s location.

ACCUREV_SERVER

Dictates the AccuRev Server that the AccuRev GUI interacts with when the GUI is started. Valid values take the format <server name>:<port>, for example bluto:5050 or cor-e6410:5050. If the ACCUREV_SERVER environment variable is not specified, the first server listed in the %user_profile%\.accurev\acclient.cnf file is used. If the file %user_profile%\.accurev\acclient.cnf does not exist, then the first server listed in the installed ACCUREV_BIN\acclient.cnf file is used.

The AccuRev GUI verifies that the specified AccuRev Server exists and can be connected to. If the user is not yet logged into that server, or if the server does not exist, then the GUI displays a login dialog. In that dialog, the user can choose what server to connect to. If the selected server is not already listed in the first line of the
%user_profile%\.accurev\acclient.cnf file, it is inserted or moved to the first line of that file.

ACCUREV_TOPDIR

Set by the start command to the pathname at which the specified workspace or reference tree is located.

ACCUREV_USE_MOD_TIME

If this variable is set to 1, the AccuRev commands co, pop, purge, revert, and update preserve timestamps when copying versions from the repository into a workspace.

ACCUREV_WATCHDOG_FAST_FAIL_DISABLE

If this variable is set to 1, the AccuRev Server Watchdog process never stops trying to restart the AccuRev Server process, no matter how many Server failures it detects. By default, the Watchdog stops trying after detecting 5 failures in a 3-minute timespan.

ACCUREV_WSPACE

Set by the start command to the name of the specified workspace or reference tree.

AC_BROWSER

The full pathname of the Web browser to be used for displaying the help screens of the AccuRev GUI context-sensitive help system.

AC_DIFF_CLI

diff command: the file-comparison program to run when this command is invoked. Default: the acdiff program in the AccuRev bin directory.

AC_EDITOR_CLI

The text editor invoked when the user must enter a comment (e.g. with the keep command). This preference has higher precedence than EDITOR. If no preference is set, a system-dependent editor is invoked.

AC_EDITOR_GUI

The text editor invoked by the AccuRev GUI File Browser tool when the user invokes the Edit command on a text-file element. This preference has higher precedence than EDITOR. If no preference is set, a system-dependent editor is invoked.

AC_KEEP_TMP_FILES

Set to true to log XML commands sent via accurev xml. Each logged command is saved in a file in a temporary directory under the user’s home directory.

AC_MERGE_CLI

merge command: the text-file merge program to run when this command is invoked. Default: the acdiff3 program in the AccuRev bin directory.

AC_OLD_UPDATE_PREVIEW

Specifies that the File > Update Preview menu option in the AccuRev GUI displays the old (pre-4.9) textual information, rather than the Update Preview filter display.

AC_SYNC

Applies only if the user issues an accurev command that includes the –t option along with a time specification (not a transaction number) and there is a timewarp (discrepancy) of more than 5 seconds between the client and server machines.

If not set or set to ERROR, a runtime error occurs and AccuRev displays a message that includes the timewarp details.

If set to WARN, no error occurs, but a warning that includes the timewarp details is displayed.

If set to IGNORE, no error occurs and no warning is displayed.

Note: The values for AC_SYNC are case-insensitive.

EDITOR

The text editor invoked when the user must enter a comment (e.g. with the keep command). This preference has lower precedence than AC_EDITOR_CLI. If no preference is set, a system-dependent editor is invoked.

HOME

The directory where the AccuRev configuration subdirectory, .accurev, is located. But this can be overridden by an ACCUREV_HOME specification.

HOMEDRIVE, HOMEPATH

The pathname formed by concatenating of these two preferences specifies the directory where the AccuRev configuration subdirectory, .accurev, is located. But this can be overridden by an ACCUREV_HOME specification.

PATH

Your operating system search path.

SHELL

Your default operating system command processor.

TEMP, TMP

Locations where temporary files can be created.

TZ

Used in rendering the system time as a human-readable string, and reported (if set) by the info command.