Command Line Syntax - IBM Cognos User Manual

The following example, run from the bin folder where Cognos Transformer is
installed, tests to ensure that your Windows operation ended successfully. If a
non-zero error code is returned, the process failed, or Cognos Transformer
terminated unexpectedly without completing the specified sequence.
cogtr.exe -n2 -s -i -nologo install_dir:\
filename.py? if errorlevel 1 goto error
:noerror echo no error was encountered pause goto end :error echo
Error
pause :end
In the following UNIX/Linux example, a Bourne Shell script is appended to the
cogtr command to perform a second action (b) on successful completion of the first
action (a):
#!/bin/sh if cogtr command_line_options then #perform action a if exit status is 0
else #perform action b fi

Command Line Syntax

To use command line options, you must start the Cognos Transformer executable,
cogtr.exe, from the directory in which it is installed.
The syntax for using command line options with optional arguments is as follows:
cogtr -option
[argument]
Notes
When using command line options, the following considerations apply:
v On Windows, you can use -n with some options to run Cognos Transformer in
v The option in the command line always starts with a dash (-).
v Command line options are case-insensitive. Arguments are case-sensitive.
v If there are spaces inside any argument, you must enclose the argument in
v For .py? files, the question mark (?) is replaced by the character that is used in
v You can use more than one option in a command line. If an option that is used
v
v When entering command line options, you must specify the name of the .mdl
210
IBM Cognos Transformer Version 10.1.1: User Guide
filename.py?|filename.mdl
batch mode.
double quotation marks, for example
cogtr -n -k"field three=CarlosR/pw462" Field3.mdl
your version of Cognos Transformer.
in a command line is incompatible with an option that appears earlier in the
command line, the earlier option is ignored.
The filename.py? and filename.mdl syntax applies to Windows only; use the -m
option on other platforms to specify the model file name.
and .py? file at the end of the command line after all the other parameters, for
example,
cogtr -n -s -mmodel.mdl
cogtr -n -s -pmodel.py?