IBM Cognos, User Manual, Page: 247 / 411

The following example opens the model Year3.mdl, sets the current period to the
category which has a category code of 20061201-20061231, then runs the process in
batch mode to create all defined cubes.
cogtr -n -t"20061201-20061231" -sYear3.mdl
-u option
The -u option writes the partition information for a specified cube to the log file.
It uses the following format:
date
time
Cube
[ powercube_name ]|[ powercube_group_name /
child_cube_name ] partition report Partition#
Category Code Category Name Partition Size
You must generate cubes before their partition status can be reported. If the
command line includes options to generate categories and create cubes, those
options are processed before the partition information is obtained.
Partition information cannot be provided for cubes and cube groups to which
security has been applied. To obtain the partition information of cubes in a cube
group, you must specify the individual cube names, not the cube group name.
The cube name is case-sensitive; for example, you must type uNorth not unorth,
for the example below to be valid. No spaces can appear between the option and
its argument.
The syntax for using the
-u
option is as follows:
cogtr -u[ powercube_name ]|[
powercube_group_name / child_cube_name ] -p
filename.py? |-m filename.mdl
The powercube_name parameter represents the name of the cube in the Cognos
Transformer model. If powercube_name specifies a cube group that is not a
time-based partitioned cube, all child cubes of the cube group are copied to the
deployment location and activated. If
powercube_name specifies a time-based
partitioned cube, it is processed as a single cube; member cubes are not deployed
individually.
If a name conflict exists with a child cube of a cube group that has the same name
as another cube in the model, use the
powercube_group_name / child_cube_name
parameters.
This Windows example opens the model file Roofing.mdl, discarding a checkpoint
file if one exists. It then creates all defined cubes and writes the partition
information of cubes North and East to the log file F:\Roof.log.
cogtr -i -n -uNorth -uEast -dLogFileName=F:Roof.log -mRoofing.mdl
-v option
This option specifies how many data source records to use to create a test cube. If
you have a large data source file, this option enables you to do a test run on a
limited number of records before processing the entire file.
If the number of records you specify for the test is greater than the total number of
records in the source file, the process runs normally, using the entire file.
Appendix A. Command Line Options
233