When you use RPE templates that use DOORS as a data source, RPE tries to identify the location of the DOORS installation as well as the default database to connect to.
RPE finds these values by querying the registry. Depending on the DOORS version used and the bitness of your OS this process can take a good few seconds. This happens every time you load an RPE template or when you use the DOORS Configuration Dialog.
With RPE 188.8.131.52 and newer you can completely circumvent this process and gain significant time with every document generation if you “tell” RPE these values instead of having it search them every time.
You do this by defining 2 Java properties and as usual you need to add them in the rpe-launcher.ini vs rpe-studio.ini:
- com.ibm.rational.rpe.doors.home – the full path to doors.exe
- com.ibm.rational.rpe.doors.data – the datacase connection
UPDATE: when doing the document generation with “new instance” set to “true” in the docspec, RPE will overwrite the DOORS home and DOORS data from the document specification with the value from these flags. This means that you should only use the technique if the following conditions apply:
- you use a running DOORS instance to extract the data (“new instance=false).
- you use a single DOORS database in which case the override does not change anything.
Test results – in a setup with RPE 184.108.40.206 and DOORS 9.6 64 bit defining these 2 flags reduce the load time of a docspec with 1 DOORS template from 4-5 seconds to less than 1 second. For a document specification with 2 DOORS templates the load time is reduced from 10-11 seconds to ~1 second.
-Dcom.ibm.rational.rpe.doors.home=C:\Program Files\IBM\Rational\DOORS\9.6\bin\doors.exe -Dcom.ibm.rational.rpe.doors.data=36677@giediprime
NOTE: if you use RPE through a Java API and you pass these values in a command line you must surround the values in quotes if they contain white spaces.
Java API usage sample
java -jar rpecmd.jar ... -Dcom.ibm.rational.rpe.doors.home="C:\Program Files\IBM\Rational\DOORS\9.6\bin\doors.exe" -Dcom.ibm.rational.rpe.doors.data=36677@giediprime