Preferences - IBM Cognos User Manual

Environment variables override settings in any preference file, and the command
line options override both the preference file settings and the environment variable
settings.
For example, to override the directory where source files are read, you can include
the following UNIX environment variable definition in the *.sh file:
DataSourceDirectory=$HOME/data; export $HOME/data
To use the command line to override the setting for the directory where the source
files are read, start Cognos Transformer using the following command:
cogtr -dDataSourceDirectory=$HOME/data
For more information, see "Preferences" and "Environment Variables" on page 200.

Preferences

This section describes the most common preference settings that you can specify
for Cognos Transformer.
Before you start specifying preferences, read the section "Controlling Processing
with Preference Settings or Environment Variables" on page 194.
Tip: When specifying the preference settings in the installation_location/
configuration/cogtr.xml file, use the installation_location/configuration/
cogtr.xml.sample file as a reference.
In most cases, preference files that contain invalid options are ignored and an error
message is written to the log file. This type of error-handling applies, for example,
if the preference file value for the ModelSaveDirectory is incorrect. However, if the
value for CubeSaveDirectory is incorrect, the variable is ignored, but no log file
entry is added. If the ChildRatioThreshold value is outside its acceptable range,
the invalid setting is changed at run time to either its maximum or minimum
value, depending on which value is closest to the incorrect setting.
Consider the following when using the command line options to specify
preferences:
v Command line syntax does not allow a space between -d and its preference_var
argument.
v Blank characters, tab characters, and lines beginning with the number sign (#)
are ignored.
Note: For each setting listed below, pathrefers to the directory and file name. For
non-Windowsplatforms, the default is the "temp" directory in the
installation_location/c10 directory. On Windows platforms different defaults apply,
as described below.
Directory
The following settings specify directories required by Transfomer.
v <Preference Name="ModelWorkDirectory" Value="path1;path2;..."/>
This setting specifies where Cognos Transformer creates the temporary file while
you work on your model. The default path is the value of ModelSaveDirectory.
Chapter 9. Guidelines for Optimizing Production Environments
195