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 command line is executed on the Management Console system, not the server that executes the adaptor.
The command line uses the \integration directory (a subdirectory of the installation directory) as its current directory.
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>