- CCASE_ABE_INIT_TIMEOUT
- Specifies the maximum number of minutes that clearmake waits
for a new audited build executor (abe) to request an initial build
context.
Default: 3 minutes.
- CCASE_ABE_PN (or CLEARCASE_ABE_PN)
- The full path name with which clearmake invokes the
audited build executor (abe) on a local or remote host during a parallel
build. For more information about abe, see the IBM Rational ClearCase Guide to Building Software.
Default: ccase-home-dir/bin/abe
- CCASE_ABE_START_TIMEOUT
- Sets the maximum time allotted for starting the abe.
Default: 30
seconds.
- CCASE_ABE_TIMEOUT
- Specifies the maximum number of minutes that the abe should wait
for clearmake to reply after the abe requests a
target build.
Default: 180 minutes.
- CCASE_AUDIT_TMPDIR (or CLEARCASE_BLD_AUDIT_TMPDIR)
- Sets the directory where clearmake and clearaudit create
temporary build audit files. If this variable is not set or is set to an empty
value, clearmake creates these files in the directory specified
by the TMPDIR (UNIX and Linux) or TMP (Windows) environment variable.
Note: On Linux and the UNIX system
clearmake creates
these files in the
/tmp directory if neither EV is set.
All temporary files are deleted when clearmake exits.
If the value of CCASE_AUDIT_TMPDIR is a directory under a VOB tag, clearmake prints
an error message and exits.
Note: Multiple
build clients can use a common directory for audit files. Names of audit files
are unique because
clearmake names them using both the
ID of the
clearmake process and the host name of the machine
on which the process is running.
Default
for UNIX and Linux: /tmp
Default for Windows: None
- CCASE_AUTO_DO_CI
- Checks in DOs checked out by clearmake -c or omake -C unless
the build of the corresponding target fails or the automatic checkout of the
DO or a sibling DO fails. Checkout comments are preserved. The checkin command
is invoked with the -ptime option to preserve the DO's modification
time.
Default: Undefined
- CCASE_AUTO_SAVE_AUDIT_FILES
- Specifies that clearmake save any audit files that
generate a warning after being processed. clearmake prints
the path name of each audit file that it saves.
- CCASE_BLD_HOSTS
- Specifies one or more build hosts on which clearmake must
build targets. For more information, see the IBM Rational ClearCase Guide to Building Software.
Default: Undefined.
- CCASE_BLD_NOWAIT
- Disables clearmake's sleep-check cycle during a build.
When this environment variable is set, clearmake does not
check for a VOB lock (or wait for the VOB to be unlocked).
- CCASE_BLD_VOBS
- A list of VOB tags—separated by a space, tab, comma, or colon (on Linux and
the UNIX system),
or by a semicolon (on Windows)—to be checked for lock status
during a build. If a VOB on this list is locked, clearmake enters
a sleep-check cycle.
- CCASE_BLD_WAIT_NUSERS
- Specifies that when checking for a VOB lock, clearmake must
determine whether the current user is excluded from the lock. The type of
checking that this EV enables has a negative impact on performance.
- CCASE_CONC (or CLEARCASE_BLD_CONC)
- Sets the concurrency level in a clearmake build. This
EV takes the same values as the –J option. Specifying a –J option
on the clearmake command line overrides the setting of
this EV.
Default: None.
- CCASE_DIR_IGNORED_REUSE
- Prevents clearmake from considering directory versions
as significant when evaluating a DO for reuse or winkin. By default, clearmake treats
directory versions as significant only if they are listed in the makefiles
as a declared target dependency.
A related makefile special target, .DIRECTORY_IGNORED_FOR_REUSE,
has the same effect as this EV but can also be used to apply only to specified
targets. Another makefile special target, .DIRECTORY_AFFECTS_REUSE,
overrides both this EV and the .DIRECTORY_IGNORED_FOR_REUSE special
target.
- CCASE_DNVW_RETRY
- Specifies a time-out period, in minutes, for clearmake, omake, catcr, describe, or lsdo to wait before trying to contact an inaccessible
view listed in its cache. To disable the cache, set CCASE_DNVW_RETRY to 0.
For more information, see the clearmake or omake reference
pages.
Default: 60 minutes.
- CCASE_HOST_TYPE (or CLEARCASE_BLD_HOST_TYPE)
- Determines the name of the build hosts file to be used during a parallel
build (–J option): file .bldhost.$ CCASE_HOST_TYPE
in your home directory. (Your home directory is determined by examining the
password database.) See the clearmake reference page. For
information about bldhost, see the IBM Rational ClearCase Guide to Building Software.
Specifying a –B option on the
command line overrides the setting of this EV.
C
Shell Users: Set this EV in your .cshrc file, not
in your .login file. The parallel build facility invokes
a remote shell, which does not read the .login file.
CCASE_HOST_TYPE can also be coded as a make macro.
Default: None.
- CCASE_ISO_DATE_FMT
- When set to a value of 1, forces date and time information intended for
interpretation by programs or scripts to be formatted as specified by the
ISO 8601 standard. (Dates and times intended to be interpreted only by users
are always displayed in the format defined by the operating system, controlled
by the user's locale and preferences.) Set to a value of 0 to format dates
and times using the defaults from previous ClearCase releases. The following
table shows how the setting of CCASE_ISO_DATE_FMT affects the formatting of
date and time display.
| CCASE_ISO_DATE_FMT=0 |
CCASE_ISO_DATE_FMT=1 |
| dd-mmm-yy.hh:mm:ss |
yyyy-mm-ddThh:mm:ss±hh |
| dd-mmm-yy.hh.mm.ss |
yyyy-mm-ddThhmmss±hh |
| dd-mmm-yy.hh:mm:ssUTC |
yyyy-mm-ddThh:mm:ssZ |
| dd-mmm-yy |
yyyy-mm-dd |
| dd-mmm-yyyy |
yyyy-mm-dd |
| dd-mmm.hh:mm |
--mm-ddThh:mm±hh |
Default: 1
- CCASE_MAKE_CFG_DIR (or CLEARCASE_MAKE_CONFIG_DIR)
- In a makefile read by clearmake, expands to the full
path name of the clearmake configuration directory in the ClearCase installation
area—typically ccase-home-dir/config/clearmake (UNIX and Linux)
or ccase-home-dir\config\clearmake (Windows).
- CCASE_MAKE_COMPAT (or CLEARCASE_MAKE_COMPAT)
- Specifies a clearmake compatibility mode. This EV takes
the same values as clearmake's –C option.
Specifying –C on the command line overrides the setting of
this EV.
Default: None.
- CCASE_MAKEFLAGS
- Provides an alternative or supplementary mechanism for specifying clearmake command
options. CCASE_MAKEFLAGS can contain the same string of key letters used for
command-line options, except that options that take arguments are not allowed.
Options on the clearmake command line override the setting
of this environment variable, if there is a conflict. For more information,
see the IBM Rational ClearCase Guide to Building Software.
Default: None.
- CCASE_MAX_OPLOG_TRIM_ENTRIES
- When set to an integer value between 1 and 100, specifies the maximum
number of oplog entries that the vob_scrubber removes in
a single transaction. If set to a value greater than 100 or smaller than 1,
the vob_scrubber behaves as though this EV had been set
to 100.
- CCASE_NO_LOG
- Suppresses log creation for the update command and
other commands (catcs, edcs, and so
on.) that initiates the update operation.
Default: Undefined.
- CCASE_NO_WINKIN_VIEWS
- A list of white space-separated view tags. This is the opposite of CCASE_WINKIN_VIEWS.
When this environment variable is set (and when CCASE_WINKIN_VIEWS is unset),
it excludes the specified views from the list of views from which clearmake winks
in derived objects.
- CCASE_OPTS_SPECS (or CLEARCASE_BLD_OPTIONS_SPECS)
- A list of path names, separated by colons (UNIX and Linux) or semicolons (Windows),
each of which specifies a BOS file to be read by clearmake.
You can use this EV instead of specifying BOS files on the clearmake command
line with one or more –A options.
Default: Undefined.
- CCASE_SHELL_FLAGS (or CLEARCASE_BLD_SHELL_FLAGS)
- Specifies clearmake command options to be passed to
the subshell program that executes a build script command.
Default
for UNIX and Linux: –e
Default for Windows: None.
- CCASE_SHELL_REQUIRED
- Forces clearmake to execute build scripts in the shell
program that you specify with the SHELL macro. To make clearmake execute
builds scripts in the shell program, set this EV to TRUE. To allow clearmake to
execute build scripts directly, unset the EV.
Default: clearmake executes
build scripts directly.
- CCASE_VERBOSITY (or CLEARCASE_BLD_VERBOSITY)
- An integer that specifies the clearmake message logging
level, as follows:
If you also specify –v or –d on
the command line, the higher value prevails.
Default: 0
- CCASE_WINKIN_VIEWS
- A list of white space-separated view tags. If this environment variable
is set, clearmake winks in only derived objects that were
built in one of the specified views.
- CLEARAUDIT_SHELL
- The program that clearaudit runs in an audited shell.
You must set this environment variable to the program's full path name. For
example, on UNIX and Linux:
/bin/csh or /usr/home/myscript
On Windows:
\windows\system32\cmd.exe or \users\anne\bin\myscript
Default on UNIX and Linux: clearaudit runs
the program specified by the SHELL environment variable or, if SHELL is undefined,
a Bourne shell (/bin/sh).
Default
on Windows: clearaudit runs
the program specified by the COMSPEC environment variable or, if COMSPEC is
undefined, cmd.exe.
See
also: SHELL.
- CLEARCASE_AVOBS
- A list of VOBs to process when you use the –avobs option
in the find, findmerge, lscheckout, lshistory,
or rmview commands. If this EV is not set, specifying –avobs invokes
the command on all VOBs mounted on the host. If there are many such VOBs,
the command can take a long time to complete.
Specify
CLEARCASE_AVOBS as a list of VOB tags separated by commas, white space, or
colons (UNIX and Linux)
or by semicolons (Windows).
Default: None.
- CLEARCASE_CMNT_PN
- The path name of the file in which cleartool and multitool cache
the most recent user-supplied comment. Defining or removing this EV enables
or disables comment caching.
- CLEARCASE_OBSO_SYN
- Detects instances of the obsolete option-argument style of specifying
an object (see the cleartool reference page).
If
you set this environment variable to the value WARN,
it issues warnings when it detects obsolete syntax. When set to SILENT,
it silently accepts obsolete syntax. When set to FAIL,
it issues errors when it detects obsolete syntax.
Default: FAIL.
- CLEARCASE_PERLLIB
- Set to nonzero to force ccperl to ignore the PERLLIB
environment variable, if it is set.
Default: Undefined.
The HTML type manager looks for Perl libraries in the directory specified
by the PERLLIB environment variable, if it is set. This can cause conflicts
if PERLLIB refers to Perl installations other than ClearCase Perl.
To prevent such conflicts, set this environment variable to a nonzero value.
- CLEARCASE_PROFILE
- The file that contains your ClearCase user profile, which includes
rules that determine the comment option default for one or more cleartool and multitool commands.
This setting must be a full path name.
Default: The
default is .clearcase_profile in your home directory.
- CLEARCASE_RGY_QUICK
- Causes lsview –host and lsvob –host to
use the –quick functionality by default. This provides faster
lookup for the –host option by listing views and VOBs as
currently stored in the registry. One use of this EV is to change the run-time
behavior of a script that uses the –host option, without
modifying the script.
CLEARCASE_RGY_QUICK has no effect on the lsview or lsvob command
if the –region option is also used and the region is specified
with a wildcard.
Default: Undefined. The command examines the
file system to list views and VOBs.
- CLEARCASE_TAB_SIZE
- Specifies the tab width for output produced by cleardiff, xcleardiff,
and source lines listed by the annotate command.
Default: 8
- CLEARCASE_TRACE_TRIGGERS
- A flag variable. If defined as a nonzero value, it causes all triggers
to behave when they fire as if they were defined with the –print option.
See the mktrtype reference page.
Default: Undefined.
- CLEARCASE_VOBLOCKWAIT
- (MultiSite only) Specifies the number of minutes for syncreplica to
keep retrying exports or imports when the VOB is locked. During that time, syncreplica retries
the write operation every minute. If the time elapses and the VOB is still
locked, syncreplica exits with an error. For more information,
see the syncreplica reference page in the IBM Rational ClearCase MultiSite Administrator's
Guide.
- EXPORT_REPLACE_CHAR
- A character used by the clearexport_* utilities to
replace invalid characters in exported label and branch names.
Default: . (period
character)
- EXPORT_REPLACE_COMM
- A character string used in the data file created by clearfsimport as
the comment for create version event records.
Default: made from flat
file.
- EXPORT_REPLACE_STRING
- A character string used by the clearexport_* utilities
to replace an invalid string in exported labels and branch names. This environment
variable is used if the exporter cannot replace invalid characters with the
EXPORT_REPLACE_CHAR EV.
Default: REPLACED
- HOME
- UNIX and Linux systems:
Not used. ClearCase programs
determine your home directory by reading the password database, not by using
this environment variable.
Windows systems:
User's home directory; must be set for ClearCase to work correctly. HOME
is used to search for various resources, including file-typing information
(see also the cc.magic reference page). HOME must be a
full path name, including drive specification. For example, C:\users\anne is
a valid value; \users\anne is not.
Note: Windows sets two variables, HOMEDRIVE and HOMEPATH,
which combine to specify the current user's home directory as supplied by
the Administrator when the user account was created. So, unless HOMEDRIVE
and HOMEPATH have been reassigned, HOME can be set to
%HOMEDRIVE
%%HOMEPATH
%.
- MAGIC_PATH
- A colon-separated (UNIX and Linux) or semicolon-separated(Windows)
list of directories to be searched for magic files. Various ClearCase and
programs consult magic files to perform file-typing on file system objects.
See the cc.magic reference page.
Default
for UNIX and Linux: home-directory/.magic:$CLEARCASEHOME/config/magic
Default
for Windows: home-directory\.magic;ccase-home-dir\config\magic\
- MAKEFLAGS
- One or more flags to be passed to make. clearmake reads
the contents of MAKEFLAGS at startup and amends it to include
any flags not specific to ClearCase passed at the command line. Any flags
specific to ClearCase are
passed through CCASE_MAKEFLAGS and if clearmake detects
these flags in MAKEFLAGS, it moves them to CCASE_MAKEFLAGS.
Flags
passed through MAKEFLAGS:
-I, -p, -N, -w, -e, -r, -i, -k, -n, -q, -s
Flags passed through CCASE_MAKEFLAGS:
-A, -B, -N, -b, -v, -C, -U, -M, -V, -O, -T, -F, -R, -c, -u, -d
Default: None.
- SHELL
- The default shell program to be run by various commands and programs,
including the shell and setview commands.
On UNIX and Linux,
the clearaudit utility uses the value of SHELL if the environment
variable CLEARAUDIT_SHELL is undefined.
Default
for UNIX and Linux: Set
by your shell program.
Default for Windows: Not
set by most Windows shells; some shells that are ported from UNIX and Linux (for
example, Hamilton csh, MKS korn sh, and so on.) may set it.
- TZ
- Time zone for the host. If the TZ environment variable is set to a value
different from the time maintained by the operating system, the TZ time, not
the system time, is used. In this case, file creation and change dates can
be in error, and config specs do not work as expected.