Appendix A. The policy_vars.sh File
This appendix lists the environment variables contained in the policy_vars.sh file that you can use to configure the ClearCase/Tracker Integration. They are listed in three tables:
Tracker-specific environment variables
environment variables that help establish and enforce site policies
environment variables that set miscellaneous system parameters
Table A-1 lists the Tracker-specific environmental variable that can be set in the policy_vars.sh file. This variable is also used by commands such as dml.
Table A-1. Tracker-Specific Environmental Variables
Environmental Variable
| Description
| Values
|
|---|
TVBUGBASE
| UNIX directory for Tracker
database.
| any UNIX pathname
default: /usr/Tracker/db
|
Table A-2 lists the policy environmental variables in the policy_vars.sh file.
Table A-2. Policy Environmental Variables
Environmental Variable
| Description
| Values
|
|---|
BUGNUM_REQ_CO
| must user enter a bug
number on checkout?
| TRUE, FALSE
default: FALSE
|
BUGNUM_REQ_CI
| must user enter a bug
number on checkin?
| TRUE, FALSE
default: FALSE
|
BUG_NONE
| no bugfix string; used only if
BUGNUM_REQ_CO and
BUGNUM_REQ_CI both
have “FALSE” value
| any character string
default: "0"
|
BUGTRACK_ADMIN
| user to receive mail when
update of Tracker database
fails
| Tracker Administrator's
UNIX login name, or any
other valid UNIX login
name
default: root
|
CYCLE
| determines handling of an
incomplete cycle
(for example,
user enters one bug number
on checkout, and another bug
number on checkin)
| NONE: allow incomplete
cycle
WARN: display message
and proceed
ERROR: abort ClearCase
operation
default: WARN
|
VALIDATE_BUG
| bug-validation command,
executed at checkout and
checkin
| validate_bug $CYCLE
validate_bug $CYCLE
$CLEARCASE_USER
default: first form (no
validation of username
against “Assigned to” field
in Tracker database)
|
Table A-3 lists miscellaneous environmental variables.
Table A-3. Miscellaneous Environmental Variables
Environmental Variable
| Description
| Values
|
|---|
MKTYPE_COMMENT
| creation comment for
meta-data types
| any character string
default: “Created for
use with bug tracking
triggers.”
|
PRE_CI_TRIG
POST_CI_TRIG
PRE_CO_TRIG
POST_CO_TRIG
PRE_UNCO_TRIG
| ClearCase pre-operation
and post-operation trigger
type names for checkin,
checkout,Glossary terand
uncheckout commands
| any valid ClearCase
trigger name
defaults:
tracker_pre_ci_trig
tracker_post_ci_trig
tracker_pre_co_trig
tracker_post_co_trig
tracker_pre_unco_tri
g
|
WIP_NAME
| “work in progress”
attribute type
| any valid ClearCase
attribute name
default: WIP
|
FIXES_NAME
| “fixed problem” attribute
type
| any valid ClearCase
attribute name
default: FIXES
|