-f option

This option specifies the user-defined preference file or files to use. If you do not include the full directory path with the file name, Transformer searches the executable directory of your most recently installed rendition of the product for the required .xml file.

This option is also used to include prompts in an XML command file using the XML schema for preference files XML Schema for Preference Files, and to publish PowerCubes in batch mode Publishing in Batch-mode.

If you are performing batch tasks that require the use of multiple preference files, Transformer combines the settings in each file successively; later settings override previously defined ones.

Similarly, if you specify the -f option after the -d option, the -f setting overrides the setting for -d. The reverse is also true; the last-appearing option overrides the options that precede it.

No space may appear between the -f option and its argument, preference_file .

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 basic 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 -fc:\Monthly.xml -mTransact.mdl

The following example parses the go_sales.mdl model file using mypref.prf as the specified preference file:

cogtr -fmypref.prf -mgo_sales.mdl