Publishing in Batch-mode

The -f command can be used to publish PowerCubes in batch mode.

The syntax is

cogtr -fspec_file.xml -n2
-ox filename.mdl

where spec_file.xml represents the path and name of the publish specification file, and where -ox disables the generation of categories and cube creation.

For information about creating a publish specification to publish all cubes in a model, see Publishing PowerCubes.

The following table describes the parameters specified in the publish specification file.

Parameter name	Description
`CubeName`	The name of the PowerCube in the model. This is a mandatory value.
`CognosConnectionDataSourceName`	The name of the data source. This is a mandatory value. The set will fail if it is not defined. Default: The name in the model
`DataSourceWindowsLocation`	The Windows location of the data source. Default: The current cube location on Windows
`DataSourceUnixLinuxLocation`	The UNIX and Linux® location of the data source. Default: Empty
`ReadCacheSize`	The read cache size for PPDS. Default: 0
`DataSourceNameSpace`	The authentication namespace used to log on to the data source. Default: Empty
`DataSourceSignon`	The command used to create the data source signon, if needed. Default: False
`DataSourceDescription`	The description of the data source. Default: Empty
`DataSourceToolTip`	The tool tip for the data source. Default: Empty
`DataSourceUpdate`	The command used to update a data source. Default: FALSE
`PackageName`	The name of the package in Content Manager. This is a mandatory value. The set will fail if it is not defined. Default: The name in the model
`Packagelocation`	The location of the package. Default: Team content
`PackageDescription`	The description of the package. Default: Empty
`PackageToolTip`	The tool tip for the package. Default: Empty
`PackageUpdate`	The command used to update the existing package when its settings change. Default: FALSE
`PackageAllowNullSuppression`	The command used to specify whether suppression is available to IBM Cognos studio users when working with this package. Default: TRUE
`PackageAllowMultiEdgeSuppression`	The command used to specify whether IBM Cognos studio users can suppress both rows and columns. If this option is set to FALSE, users can suppress rows only or columns only. If this parameter is set to TRUE, the PackageAllowNullSuppression parameter must also be set to TRUE. Default: TRUE
`PackageAllowAccessToSuppressionOptions`	The command used to specify whether IBM Cognos studio users can control the types of empty values that will be suppressed, such as zero or missing values. Types of empty values that users can choose to suppress depend on the studio. If this parameter is set to TRUE, the `PackageAllowNullSuppression` parameter must also be set to TRUE. Default: TRUE

Note: After running this command, the cube status in Cognos Transformer still shows that the cube is not published.

If you want to re-publish a cube that was originally published using the command line, you can do this using either the Cognos Transformer user interface or the command line after changing the DataSourceUpdate and PackageUpdate parameters in the publish specification file to TRUE.

Example

The following example of a publish specification file shows the xml code for publishing a cube.

<Command Name="Publish">
	<Parameter Name="CubeName" Value="NATIONAL"/>
	<Parameter Name="CognosConnectionDataSourceName" Value="NATIONAL"/>
	<Parameter Name="DataSourceWindowsLocation" Value="c:\test\cube.mdc"/>
	<Parameter Name="DataSourceUnixLinuxLocation" Value=""/>
	<Parameter Name="DataSourceNameSpace" Value=""/>
	<Parameter Name="ReadCacheSize" Value="0"/>
	<Parameter Name="DataSourceSignon" Value="FALSE"/>
	<Parameter Name="DataSourceDescription" Value=""/>
	<Parameter Name="DataSourceToolTip" Value=""/>
	<Parameter Name="DataSourceUpdate" Value="FALSE"/>
	<Parameter Name="PackageName" Value="NATIONAL"/>
	<Parameter Name="Packagelocation" Value=""/>
	<Parameter Name="PackageDescription" Value=""/>
	<Parameter Name="PackageToolTip" Value=""/>
	<Parameter Name="PackageUpdate Value="FALSE"/>
	<Parameter Name="PackageAllowNullSuppression" Value="TRUE"/>
	<Parameter Name="PackageAllowMultiEdgeSuppression" Value="TRUE"/>
	<Parameter Name="PackageAllowAccessToSuppressionOptions" Value="TRUE"/>
</Command>