require CQPerlExt;o
use CQPerlExt;
En la versión 2003.06.00 y posteriores, puede utilizar la API de Rational ClearQuest con cqperl.exe o ratlperl.exe para aplicaciones externas. Si utiliza cqperl, se añaden implícitamente las vías de acceso de inclusión correctas a CQPerlExt.pm (el paquete Perl que proporciona la API de Rational ClearQuest). En el sistema UNIX y Linux, cqperl no se puede utilizar en la sentencia use o require de los scripts Perl. Si utiliza ratlperl en el sistema UNIX y en Linux, debe establecer la vía de acceso correcta. Por ejemplo, puede utilizar el archivo binario ratlperl, que se encuentra en el directorio /opt/rational/common, como por ejemplo /opt/rational/common/linux_x86/bin.
No puede utilizar CQPerlExt.pm con Perl estándar en lugar de ratlperl o cqperl. Si necesita efectuar la integración con otros módulos, debe compilarlos para la versión suministrada de ratlperl.
Las constantes enumeradas de Rational ClearQuest se cargan previamente y están disponibles para utilizarse en enganches de campo y scripts globales. Sin embargo, para utilizar las constantes en una aplicación externa, debe añadir las definiciones de constante al programa antes de poder utilizarlas en el programa, o los valores no se establecerán.