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