Style Management Utility Commands

The following commands are supported.
Table 1. Style management utility commands

Command

Description

Delete

Syntax:

delete style_name

Removes an existing style from Content Manager. The directory containing the style is not deleted.

The delete command cannot be used to delete any of the predefined styles: Business, Classic, Contemporary, Corporate, Modern, and Presentation.

Download

Syntax:

download style_name

Downloads an existing style from Content Manager for updating.

Help

Syntax:

help

help command_name

Retrieves a list of valid commands. The help command followed by a command name retrieves detailed information about that command.

Generate

Syntax:

generate style_name

Creates a folder for a new style on all the IBM® Cognos® Business Intelligence gateways in the c10_location\temp directory. The folder contains all the files needed for the new style, including the cascading style sheets and images.

The generate command prompts you to save before proceeding. If you respond No to the prompt, the generate command does not execute.

List

Syntax:

list

Retrieves the current list of styles available. The same list appears in the Styles section on the Configuration tab in IBM Cognos Administration.

Logoff

Syntax:

logoff or exit

Exits the style management utility.

New

Syntax:

new style_name_existing style_name_new

Creates a new style based on an existing style. An XML file is created in the c10_location\temp directory. You can customize style.xml by editing the colors and images in a text or XML editor.

Publish

Syntax:

publish style_name

After deploying a new style to all gateways, the publish command makes the style available to end users.

Save

Syntax:

save style_name

Saves the custom style to Content Manager for later retrieval.

Validate

Syntax:

validate style_name

Validates the custom style file, style.xml.

Zip

Syntax:

zip style_name

Packages the output of the generate command into a zip file named style.zip in the c10_location\temp folder. The zip file must be extracted to the c10\webcontent\skins directory on all the gateways.