BuildForge Help

integrate

The <integrate> element is similar to the <execute> element and can be used in its place. Like the <execute> element, the <integrate> element specifies a command line to be executed. It has the following differences:

The <integrate> element is useful for executing applications or scripts located on the Management Console machine, especially in the \integration directory.

When a <run> element calls the <command> element that contains the <integrate> element, the system replaces any positional variables in the <integrate> element with the parameters specified in the calling <run> element. A $1 in the <integrate> element is replaced by the first parameter, a $2 with the second parameter, and so on.

As with the <execute> element, you cannot use dot commands in an <integrate> element.

The following example, from the IBM Rational ClearQuest adaptor, sends data to ClearQuest by running the CQperl command (a ClearQuest program for executing Perl code) and feeding it the name of a Perl script located in the\integration directory. The example assumes ClearQuest is installed on the Management Console system.

<integrate>
cqperl bfcqresolve.pl $2 Fixed "Fixed in build $BF_TAG"
</integrate>