Publishing in Batch-mode

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

Example

The syntax is

cogtr -fspec_file.xml -o
-mfilename.mdl

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

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

CubeName
Specifies the name of the PowerCube in the model. This is a mandatory value.
CognosConnectionDataSourceName
Specifies 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
Specifies the Windows location of the data source.

Default: The current cube location on Windows.
DataSourceUnixLinuxLocation
Specifies the UNIX and Linux® location of the data source.

Default: Empty
ReadCacheSize
Specifies the read cache size for PPDS.

Default: 0
DataSourceNameSpace
Specifies the authentication namespace for the data source.

Default: Empty
DataSourceSignon
Specifies the command used to create the data source signon, if needed.

Default: False
DataSourceDescription
Specifies the description of the data source.

Default: Empty
DataSourceToolTip
Specifies the tool tip for the data source.

Default: Empty
DataSourceUpdate
Specifies the command used to update a data source.

Default: FALSE
PackageName
Specifies 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
Specifies the location of the package.

Default: Public Folders
PackageDescription
Specifies the description of the package.

Default: Empty
PackageToolTip
Specifies the tool tip for the package.

Default: Empty
PackageUpdate
Specifies the command used to update the existing package when its settings change.

Default: FALSE
PackageAllowNullSuppression
Specifies the command used to specify whether suppression is available to IBM® Cognos® studio users when working with this package.

Default: TRUE
PackageAllowMultiEdgeSuppression
Specifies 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
Specifies 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

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>