BuildForge Help

ClearCase and ClearQuest Environment Variables

The ClearCase and ClearQuest adaptor templates use the environment variables in the following table to execute cleartool commands.

Not every environment variable in the following table is required for each ClearCase or ClearQuest adaptor template.

In each adaptor template, required environment variables are listed in the <env> elements in the <template> section.

Before running a ClearCase or ClearQuest adaptor project, supply real values for the required variables or accept defaults. Edit variable values in the environment assigned to the adaptor.

Adaptor templates are located in the following directory:

<bf-install>\interface

Table 1. Environment Variables for ClearCase and ClearQuest
Environment Variable Name Substitution Variable Description
VIEW value=my_adaptor_view Set this variable to the name of the ClearCase view that you want to use with the adaptor.
VOB_PATH value=\c_vob Set this value to the name of your component VOB, and optionally, its subdirectories.
PROJECT_VOB value=\ProjectVob When you use the ByBaseline adaptor, set this variable to the name of your Project VOB (only used with UCM ClearCase).
CCSERVER value=BFServerName Set this variable to the name of a Build Forge server that has the ClearCase client installed and running.
CurDate value=.date %d-%b-%y.%H:%M:%S Supplies the current date to the adaptor, using a .date command to generate the date in the format expected by ClearCase. Do not change this value.
LAST_RUN value=1-Jan-05.00:00:00 For ByDate adaptors, the system uses this value to determine whether any changes have occurred; it's the date of the last successful run. You can manipulate this value when testing the adaptor to force the adaptor to run, by picking a date that you know precedes some changes. If the adaptor allows run to continue, it automatically updates this value to the current date. The default value is 1-Jan-05.00:00:00.
LABEL value=BUILD_1 For ByLabel adaptors, when you use your adaptor to generate differences by label (with the ByLabel adaptor), the system uses this value as the label.
BASELINE value=BUILD_1 For ByBaseline adaptors, when you use your adaptor to generate differences by baseline, the system uses this value as the baseline.
ACTIVITIES value=SAMPL00000001@\ProjectVob For the ClearQuestClearCaseByActivity adaptor, a space-delimited set of activity IDs.