IBM Cognos User Manual page 232

Tip: You can base your preference file entries on the settings the cogtr.xml file, and
then run batch jobs by referencing the appropriate file using the -foption. Set your
environment variables globally or use the -doption for specific command
sequences.
The syntax for using the -f option is as follows:
cogtr -fpreference_file -p
filename.py?|-mfilename.mdl
The following example sets the preference file to C:\Monthly.xml, opens the model
file Transact.mdl, then runs the process in batch to create all of the cubes defined
in the model:
cogtr -n -fc:\Monthly.xml -mTransact.mdl
The following UNIX and Linux example parses the go_sales.mdl file using
mypref.prf as the specified preference file:
cogtr -fmypref.prf -mgo_sales.mdl
Note: If you change a preference using the -foption, you cannot use the
Preferences property sheet in Windows to edit the preference that you changed.
The Windows control for the preference that you changed using the -foption is
inactive.
XML Schema for Preference Files
The XML file format supports multi-value commands and user-defined preference
files. Commands in XML files are executed sequentially unless specific rules are
defined.
Example
The XML schema can have multiple sections and multiple commands. Commands
can contain multiple parameters and parameters can have multiple values.
The cogtr.xml file conforms to the XML schema. The cogtr.xml file contains two
major predefined groups of xml elements:
v a section which contains a list of preferences, for example:
v a Commands section, which will be empty in most cases. The Commands
218
IBM Cognos Transformer Version 10.1.1: User Guide
<Sections>
<Section Name="Transformer">
<Preference Name="DataWorkDirectory" Value="..\temp"/>
<Preference Name="AutoEdit"Value="0"/>
<Preference Name="ChildRatioThreshold" Value="35"/>
<Preference Name="CubeSaveDirectory" Value="..\temp"/>
<Preference Name="DataSourceDirectory" Value="..\temp"/>
</Section><Section Name="RecentFileList">
<Preference Name="File1" Value="NationalOriginal.mdl"/>
<Preference Name="File2" Value="Cubexx.mdl"/>
<Preference Name="File3" Value="GreatOutdoorsCompany_Slow_v1.mdl"/>
<Preference Name="File4" Value="testcube.mdl"/>
</Section>
</Sections>
section passes commands to Cognos Transformer when it is used in batch mode.