To use Cognos product documentation, you must enable JavaScript in your browser.

Entry Properties

You can control the way an entry appears and behaves by modifying its properties. The properties for entries vary depending upon the type of entry selected and your privileges. For example, reports have properties to control run options while folders do not. If a property is not applicable to the type of entry you are customizing, it will not appear in the Set properties page.

General Properties

General properties appear on the General tab of the Set properties page.

Property

Description

Type

The type of entry.

Owner

The owner of the entry. By default, the owner is the person who created the entry. When the owner no longer exists in the namespace, or is from a different namespace than the current user, the owner shows as Unknown.

If you have Set policy permissions, click Make me the owner to become the owner of the entry.

Contact

The person responsible for the entry. Click Set the contact and then click Select the contact to set the contact for the entry or click Enter an email address to enter the contact’s email address.

Location

The location of the entry in the portal and its ID. Click View the search path, ID and URL to view the fully qualified location and the ID of the entry in the content store.

Entries are assigned a unique identification (ID) number. For more information, see Organizing Entries.

Created

The date the entry was created.

Modified

The most recent date that the entry was modified.

Icon

The icon for the entry. Click Edit to specify an alternative icon. For more information, see Specify an Alternative Icon for an Entry

Disable this entry

When selected, users that do not have write permissions for this entry cannot access it. The entry is no longer visible in the portal.

If an entry is disabled and you have write access to it, the disabled icon appears next to the entry.

Language

A list of languages that are available for the entry name, screen tip, and description according to the configuration set up by your administrator.

Click Remove values for this language to remove the entry name, screen tip, and description for a specified language.

Name

The name of the entry for the selected language.

Screen tip

An optional description of the entry. The screen tip appears when you pause your pointer over the icon for the entry in the portal. Up to 100 characters can be used for a screen tip.

Description

An optional description of the entry. It appears in the portal when you set your preferences to use the details view.

Details view appears only in Public Folders and My Folders.

Run history

The number of occurrences or period of time to retain run histories for the entry.

Report output versions

The number of occurrences or period of time to keep report outputs.

Setting this value to zero (0) saves an unlimited number of versions.

Package

The package that is associated with the entry. If the source package was moved or deleted, the text reads "Unavailable."

Click Link to a package to link the entry to a different package. For more information, see Select a Link for an Entry.

URL

A URL to either a file or Web site address. For more information, see Create a URL.

This field is visible only if you have read permissions for the entry. If you have write permissions without read permissions, this property is not visible.

Source report

A path to the source entry for a report view. If the source entry was moved or deleted, the text reads "Unavailable."

Click Report Properties to view the properties of the source report. Click Link to a report to link the entry to a different package. For more information, see Select a Link for an Entry.

Source agent

A path to the source entry for an agent view. If the source entry was moved or deleted, the text reads "Unavailable."

Click Agent Properties to view the properties of the source report. Click Link to an agent to link the entry to a different package. For more information, see Select a Link for an Entry.

Shortcut to

A path to the entry that the shortcut points to. If the referred entry no longer exists, the text reads "Source entry not found."

Click Source Properties to view the properties of the source entry.

Advanced routing

A list of keywords used to direct requests by package, user group, or user role to dispatchers in identified server groups.

Click Set to add routing keywords for packages, user roles, or user groups. The rules used to direct the requests are part of Cognos Administration.

Gateway

The location of the web server where the originating Cognos product resides. Applies only to Series 7 PowerPlay reports.

Permissions

Permissions appear on the Permissions tab of the Set properties page.

Property

Description

Override the access permissions

Whether to replace the permissions that are inherited from the parent entry.

Access permissions (Name, Type, Permissions)

The permissions that are set for the entry. You can grant or deny read, write, execute, set policy, and traverse permissions. For more information, see Access Permissions.

Click Add to add more names to the list. Click Delete to delete names from the list.

Delete the access permissions of all child entries

Whether to remove the existing access permissions for all child entries so that they will use the access permissions for this entry.

Report, Query, Analysis, and PowerPlay Report Properties

Report properties appear on the following tabs of the Set properties page:

You can select the available paper sizes. In Cognos Connection, click Cognos Administration and then click Configuration. Click Dispatchers and Services and then click the define paper sizes button . To add new paper sizes, click New. To delete paper sizes, click Delete.

Property

Description

Default action

The default action when the report is run.

Report options: Override the default values

Whether to override default run options for the report. When selected, the values that you can override appear.

Format

The default format, orientation, and paper size to use when the report runs. Appears only if Override the default values is selected.

Language

The default language to use for the report data when the report runs. Appears only if Override the default values is selected.

Prompt values

The values that are used to filter data when a report is run .

Run as the owner

Whether to use the owner credentials when the report is run.

HTML options: Open in design mode

Whether to open an HTML-format Series 7 PowerPlay report in design mode.

Number of rows per Web page in HTML reports

The number of rows you want to appear per Web page in HTML reports

Enable selection-based interactivity in HTML reports

Whether to enable the following in HTML reports that are viewed in Cognos Viewer: drill up and drill down, drill through, Cognos Search, watch rules, and agent notification. For more information, see

Note that to have watch rules evaluated in saved report output, you must select the Enable enhanced user features in saved output versions check box.

Enable alerts about new versions

Whether to allow report consumers to receive alerts about new versions of a saved report. If this check box is cleared, you are prompted whether to remove all users from the alert list.

Enable enhanced user features in saved output versions

Whether to create additional output formats so that watch rules can be evaluated and saved output versions can be imported into Cognos 8 Go! Office.

Note that to enable watch rules, you must select the Enable selection-based interactivity in HTML reports check box.

Job Properties

Job properties appear on the Job tab of the Set properties page.

Property

Description

Steps

A list of steps in the job.

Submission of steps

Whether to run job tasks all at once or in sequence.

Defaults for all steps

Set default values at the job level. Click Set, then specify the defaults for all steps of the job. If no defaults are set, the defaults for the individual steps are used.

Agent Properties

Agent properties appear on the Agent tab of the Set properties page.

Property

Description

Tasks

A list of tasks in the agent.

Default action

The default action when the agent is run.

Prompt values

The values that are used to filter data when an agent is run .

Run as the owner

Whether to use the owner credentials when the agent is run.

Alert list

Whether to allow users to add themselves to the alert list for an agent.

Page Properties

Page properties appear on the Layout and Content and Page Style tabs of the Set properties page.

Property

Description

Number of columns

The number of columns used to organize the content of a page.

Up to three columns can be used.

Content

Type of content added to a page.

Use to add and remove portlets, distribute the portlets between the columns, change the order of columns and specify their width.

Language

The language in which the page title and instructions can be typed. It should match the product language.

Title

The page title. You can format the title by changing the font and character style, and the text alignment. To return to the default browser settings, click Return to default. To modify the default settings, click Custom.

You can hide the title.

Instructions

Additional information about the page. You can format the text of instructions by changing the font and character style, and the text alignment. To return to the default browser settings, click Return to default. To modify the default settings, click Custom.

You can hide the instructions.

Portlet style

The way a portlet appears on a page. To avoid cluttering the page, you can hide the portlet borders, title bars, and the edit button on the title bar.

Rule Properties

Use the rule properties to define or modify a watch rule. You can access the rule properties from the My Watch Items, Rules tab by clicking the set properties icon for a watch rule entry. The properties are located on the Rule tab of the Set Properties page.

The rule properties specify conditions in saved HTML report output so that when the report is saved and the conditions are satisfied, you are alerted.

For information about creating watch rules, see .

The following table describes the rule properties that are available.

Property

Description

Disable the rule

Whether to disable the watch rule. When disabled, the watch rule is not applied when report output is generated.

Send an alert when the report reportname contains:

The name of the report and the rule defined for the watch rule.

To edit the definition, click the existing filter condition, such as > (greater than) and in the list that appears, click a different condition. Specify a different value in the box.

For the selected context

The objects in the report to which the rule applies.

Alert type

The type of alert you receive when the rule is satisfied. You can be alerted by email or news item.