Command Line Options For Transformer

Transformer (cogtr.exe) supports the following Windows and UNIX/Linux command line options. Detailed explanations are provided in the subsections that follow.

Command line options are case-insensitive.

Option Meaning
-a Runs AutoDesign then creates a cube, opens PowerPlay (Windows), and displays the report.

cogtr -a data_source
Restriction: Use on Windows only, with -d, -f, -r, and -nologo options.

-c Generates categories and creates cubes.

-c -pfilename.py?|-mfilename.mdl
Restriction: Use with -i, -m, or -p.

-d Overrides the specified user preference setting.

-dpreference_var=setting -pfilename.py?|-mfilename.mdl

-e Updates the model structure but not the data.

-e -pfilename.py?|-mfilename.mdl
Restriction: Cannot be used with -c; use this option with -n and -o.

-f Specifies the user-defined preference file.

Can be used to publish PowerCubes in batch mode and include prompts in an XML command file using the XML schema for preference files.

-fpreference_file -pfilename.py?|-mfilename.mdl

-i Opens the specified .py? model and restarts a failed process from the beginning.

-i -pfilename.py?
Restriction: On UNIX and Linux, cannot be used with -s.

-h Displays help for the command line.

cogtr -h

-k Specifies database signon information for Series 7.

-ksignon=userid/password -pfilename.py?|-mfilename.mdl

-l Specifies user authentication information for Cognos 8.

-lsignon=userid/password -pfilename.py?|-mfilename.mdl

-m Opens the specified .mdl file or accepts Model Definition Language (MDL) statements.

-mfilename.mdl
Restriction: On Windows, use with -n.

-n Runs cogtr in batch mode.

-ndisplay_state -pfilename.py?|-mfilename.mdl
Restriction: Use on Windows only.

-nologo
Omits splash screen display when opening Transformer.

-nologo -pfilename.py?|-mfilename.mdl
Restriction: Use on Windows only.

-o Turns off various model and cube creation actions.

-o -pfilename.py?|-mfilename.mdl

-ox Disables category creation and cube rebuild.

-ox -pfilename.py?|-mfilename.mdl
Restriction: Use on Windows only.

-p Opens the specified binary model file, .py?, where the question mark (?) is replaced by the character that is used in your version of Transformer

-pfilename.py?
Restriction: Not valid with an MDL file.

-r Specifies the level of detail for error-logging reports.

-rlog_level -pfilename.py?|-mfilename.mdl
Restriction: Valid levels are 0, 1, 2, 3, and 4.

-s Saves the model.

-s -pfilename.py?|-mfilename.mdl
Restriction: On Windows, use with -n; cannot be used with -i or -p.

-t Sets the current period.

-tcategory_code -pfilename.py?|-mfilename.mdl
Restriction: On Windows, use with -n.

-u Gets the partition status for previously generated cubes.

-upowercube_name -pfilename.py?|-mfilename.mdl
Restriction: Cannot use this option with secured cubes. On Windows, use with -n.

-v Specifies the number of records for the test cube.

-vdata_subset_number
Restriction: Use with -c, -m, or -p.

-x Updates the column and measure scales based on the data source.

-x -mfilename.mdl

-y Specifies how Series 7 user-class security conversion is performed.

Use -y1 to preserve both the Series 7 user classes and custom views associated with the Series 7 model.

-y1namespaceName=username/password

Use -y2 to preserve only the custom view associated with the Series 7 model.

cogtr.exe -n2 -ox -s -y2 -mfilename.mdl

Use -y3 to discard the Series 7 user classes and custom views associated with the Series 7 model.

cogtr.exe -n2 -ox -s -y3 -mfilename.mdl