Index syndication
comment syndication

Clearcase Tips Number 02 – Triggers and email

December 18, 2007 at 09:00 · Filed under clearcase, unix

I was looking for a simple way to have someone emailed when an event occurred in Rational Clearcase, like a new branch type being created. If you run Clearcase on UNIX (i.e. Solaris or similar) you can whip up a simple shell script and create your trigger. I will assume you have sendmail or similar already configured on your host so that mail utilities can send smtp mail

Lets have a go at it.

Write a shell script that uses mailx to send a message with some Clearcase trigger variables embedded in it, something like this:


# Comma delimited email list of mail recipients
adminmail="[email protected]"
#This gets the host name
host=`uname -a |awk '{print $2}'`

#Begin send of message
echo "\
Creation of brtype \"$CLEARCASE_BRTYPE\"
by: $CLEARCASE_USER
comment: $CLEARCASE_COMMENT" \
| /usr/bin/mailx -s "[$host:CLEARCASE] New branchtype $CLEARCASE_BRTYPE created"

You can download this mail_new_brtype.sh if you are in a rush.

In this script you will see a number of variables starting with $CLEARCASE. These variables will be populated as environment variables when a trigger event occurs and launches the shell script.

The script should be saved somewhere it can be run on the UNIX server hosting the VOB, so when Clearcase triggers it can run the script. An appropriate location would be in the home directory of the VOB owner, for example:
/home/ccadmin/ccscripts/mail_new_brtype.sh

One you have saved the script, you need to actually make the trigger in Clearcase. Consider the following on creating this trigger type

  • We need the trigger to run after the event, this is what is known as a “Post Operation”
  • We want the trigger to be enacted after a new type is made, of type branchtype.
  • We want the trigger to execute our shell script on the event occurring

You can research these options by viewing the man page of the command used to make a new trigger type:
cleartool man mktrtype

Once you have had a read of the man page, you should see some examples and options that can be used. Have a go at running the command yourself. This is what I came up with and should cover all our considerations:
cleartool mktrtype -c "Trigger to email cfgmgr on new brtype creation" -type -postop mktype -brtype -all -exec /home/ccadmin/ccscripts/mail_new_brtype.sh new_branch_trigger
My example shown here is relevant to Clearcase V6, so YMMV.

Once that has been run, you can see your new trigger listed in the trigger type list:

cleartool lstype -kind trtype
18-Dec.10:27   ccadmin     trigger type "new_branch_trigger"
  "Trigger to email cfgmgr on new brtype creation"

Next time a user creates a branch type, you will receive an email with the branch type name, branch type comment and whom created it!

Look for more upcoming tips; including how to make a trigger use a perl script to validate label names.

Tech Debug » Clearcase Tips Number 03 - managing label conventions with perl said,

February 26, 2008 @ 01:01

[…] previously showed you how to use a shell script with Rational Clearcase, to alert you when a new branch type was […]

RSS feed for comments on this post · TrackBack URI

Leave a Comment