Question & Answer
What environment variable can you set to assist in determining if an IBM® Rational® ClearCase® trigger has fired and if so, the elapsed time spent in the trigger logic?
You can set the CLEARCASE_TRACE_TRIGGERS environment variable before performing the operation that is expected to fire the trigger.
If there is a question about whether or not a trigger is actually fired as expected when performing a specific operation, setting this environment variable can provide that initial validation by indicating when the trigger is firing (example: Firing pre-operation trigger type "SLOW_DOWN_CO").
Setting the CLEARCASE_TRACE_TRIGGERS environment as described below causes exactly 2 lines to be printed:
- The start time of trigger execution
- The end time of the trigger execution
The main purpose of this environment variable is to time how long one spends in the trigger logic.
%cleartool checkout -unr clearping
Checkout comments for "clearping":
>>> 04:38:44.048 (cleartool): Firing pre-operation trigger type "SLOW_DOWN_CO"...
>>> 04:38:46.239 (cleartool): ... trigger type "SLOW_DOWN_CO" done.
Checked out "clearping" from version "/main/13".
From the above output, one can deduce that of the overall time that the checkout command took, 2.191 seconds were spent in the trigger logic.
Setting the environment variable CLEARCASE_TRACE_TRIGGERS
UNIX®/Linux® example (for csh shell):
setenv CLEARCASE_TRACE_TRIGGERS 1
setenv CLEARCASE_TRACE_TRIGGERS 0
Note: The syntax to set the environment variable will differ depending on the shell in use.
Microsoft® Windows® example:
Review the Rational ClearCase Reference Guide on the topic of env_ccase (cleartool man env_ccase) for a complete list of ClearCase variables.
Note: For even more detailed debugging information, modify your trigger scripts to display information as it executes.
Below is a basic example of a post-op checkin trigger on Windows:
- Here are the details of the trigger type:
M:\def1\test-vob>cleartool describe -l trtype:ci_trigger
- The trace environment variable is set as following:
trigger type "ci_trigger"
created 2009-07-14T13:16:38-04:00 by Denise (denise.user@MYHOST-I)
all element trigger
action: -exec \\myhost-I\data\testscript.bat
- Perform the checkout operation to fire the trigger
M:\def1\test-vob>cleartool checkin -nc zero.txt
>>> 13:37:26.36261790404838314 (cleartool): Firing post-operation trigger type "ci_trigger"...
>>> 13:37:27.36261790404837549 (cleartool): ... trigger type "ci_trigger" done.
Checked in "zero.txt" version "\main\8".
29 September 2018