Command Line Options

Transformer supports the following command line options. Detailed explanations are provided in the subsections that follow.

Command line options are case-insensitive.

-c; use with -i, -m, or -p to generate categories and creates cubes.
-d; overrides the specified user preference settings
-e; updates the model structure but not the data
-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.
-g; copies newer versions of cubes to deployment locations and activates the newer versions.
The command pcactivate enables you to activate PowerCubes that are updated in the production environment.
-i; opens the specified .py? model and restarts a failed process from the beginning. Cannot be used with -s.
-j; publishes a single PowerCube or all enabled PowerCubes in a cube group
-h; displays help for the command line
-k; specifies database signon information for IBM® Cognos® Series 7
-l; specifies user authentication information for IBM Cognos Analytics environment
-m; opens the specified .mdl file or accepts Model Definition Language (MDL) statements
-o; turns off various model and cube creation actions
-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. Not valid with an MDL file.
-r; specifies the level of detail for error-logging reports. Valid levels are 0, 1, 2, 3, and 4.
-s; saves the model. Cannot be used with -i or -p.
-t; sets the current period
-u; gets the partition status for previously generated cubes. Cannot use this option with secured cubes.
-v; use with -c, -m, or -p to specify the number of records for the test cube
-x; updates the column and measure scales based on the data source
-y; specifies how IBM Cognos Series 7 user-class security conversion is performed.
- Use -y1 to preserve both the IBM Cognos Series 7 user classes and custom views associated with the IBM Cognos Series 7 model.
- Use -y2 to preserve only the custom view associated with the IBM Cognos Series 7 model.
- Use -y3 to discard the IBM Cognos Series 7 user classes and custom views associated with the IBM Cognos Series 7 model.

-c option
This option loads a model file, interprets MDL statements, generates categories, and creates cubes.
-d option
This option sets a new value for a Transformer user preference. The value overrides settings from the Preferences property sheet for this instance only.
-e option
This option updates and saves all the cube metadata that is defined in the model, but does not update the data. The cube metadata consists of object names, labels, short names, descriptions, drill-through reports, and security information.
-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.
-g option
This option copies newer versions of cubes to deployment locations and activates the newer versions.
-h option
This option displays help for the command line. Help is also displayed if you do not provide any command options.
-i option
This option opens a saved model, regardless of the existence of a checkpoint file.
-j option
This option is used to publish a single PowerCube or all enabled PowerCubes in a cube group. Both the data source connection and the package are published for a particular PowerCube.
-k option
This option supplies the signon information needed to establish one or more database connections during batch processing.
-l option
This option specifies the user authentication information for IBM Cognos.
-m option
This option specifies the .mdl-format model or script file to be processed.
-o option
This option loads the model file, but turns off population of the model with data and cube creation.
-p option
This option opens the checkpoint file or loads a binary model file and processes it, beginning from the last checkpoint saved in the checkpoint file if this exists, or beginning from the start of the .py? file. All changes are saved on termination.
-r option
This option sets the degree of detail for messages written to the log file.
-s option
This option, after successful creation of a cube, saves the model with any new categories added during the category generation process, then closes Transformer.
-t option
This option sets the current period for the purpose of calibrating relative time calculations.
-u option
This option writes the partition information for a specified cube to the log file, using the following format:
-v option
This option specifies how many data source records to use to create a test cube.
-x option
This option updates the column and measure scales of the MDL model, provided the data source can handle queries about scale. Therefore the option is supported for relational data sources, but not ASCII or other flat-file data sources.
-y options
This option specifies how IBM Cognos Series 7 user-class security conversion is performed.

Parent topic: Cognos Transformer Commands