Overview of the AccuRev® Command-Line Interface : AccuRev User Preferences

AccuRev User Preferences
Some accurev commands use AccuRev user preferences to control or modify their operation. User preferences can be supplied in either of these ways:
As a setting in your AccuRev user preferences file: preferences.xml in the .accurev subdirectory of your AccuRev home directory. You can use the AccuRev commands setpref and getpref to maintain the contents of this file.
If an environment variable has the same name as an entry in the user preferences file, accurev commands follow the environment variable and ignore the preference-file entry.
Following is an alphabetical listing of the AccuRev user preferences.
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. See also AC_DIFF_CLI.
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_IGNORE_ELEMS
A SPACE-separated list of up to 50 pathname patterns used in AccuRev’s pathname optimization facility. See Pathname Optimization: ACCUREV_IGNORE_ELEMS and .acignore on page 7 of AccuRev Technical Notes.
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 Java 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.
USE_IGNORE_ELEMS_OPTIMIZATION
When set to TRUE (case-insensitive), causes the update command to use the pathname optimization facility (see ACCUREV_IGNORE_ELEMS) when searching the workspace for modified files.

AccuRev, Inc.
Phone: 781-861-8700
Fax: 781-861-8704
support@accurev.com