Launcher command-line options

You can run the Rational® Publishing Engine Launcher from a command-line prompt. You can also create a definitions file
%RPE_HOME%\launcher\rpe-launcher.exe -option parameter

About using the command line

When you are running the Rational Publishing Engine Launcher from a command-line prompt, keep in mind that:

Command-line options

Table 1. Valid options to use with the rpe-launcher command
Option Notes
-err publish Be prompted during the publishing process if all of the data sources are not configured. When this parameter is omitted, the prompts are suppressed.
-makedocspec definition_file.xml Include this parameter with a path to a file that definitions file to create a document specification.
-noresult Hides both the Document specification configuration window that prompts you during publishing to specify details for the document specification and hides the Results window that displays the links to each output format.
path filepath_filename.dsx To open a file in the Launcher, include this parameter with the path to a document specification file.
-publish filepath_filename.dsx

-publish -makedocspec filpath_filename.dsx

Include this parameter with the path to a document specification file to generate the report without using the Publish wizard.

With the -makedocspec parameter, the document specification is created and published from the definition file.

-wizard

-wizard definitions_file.xml

Minimizes the Launcher and starts the Configure and Generate Document wizard in the foreground.

You can also add the path to a definition file, which preconfigures the data source in the template that is selected in the wizard.

Example definition file

You can specify a definition file with the -makedocspec option to generate a document specification from the command line.

A definition file is structured with three main sections:
  1. The docspec section includes the file name and location that the document specification is created in.
  2. Each datasource section includes the details for the data sources and their properties.
  3. Each template section lists a template path to specify in the document specification.

The following example shows a sample definition file that can be used as a template for configuring IBM® Rational RequisitePro® and IBM Rational DOORS® data sources.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<definition xmlns="http://www.ibm.com/rational/rpe/definitionFile" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

	<docspec>c:\temp\generatedDocSpec.dsx</docspec>

	<datasource name="DOORS 1" type="DOORS">
		<property name="URI">/demo/car/System requirements</property>
		<property name="baseline">Currentname="baseline">Current</property>
		<property name="view">Industrial</property>
	</datasource>

	<datasource name="ReqPro_PR" type="REST">
		<property name="URI">http://localhost:8080/dataservices/RequisitePro/Learning Project Traditional/requirements/PR</property>
		<property name="username">john.doe</property>
		<property name="password">password</property>
	</datasource>

	<template>c:\temp\sampleTemplate.dta</template>
</definition>

Feedback