Cognos Mobile service configuration settings

These settings are used to administer the delivery of IBM® Cognos® Analytics content to mobile applications.

Policy settings

These settings define how to deliver Cognos Analytics content to mobile applications.

Maximum number of pages to store for each report
Pages over the specified limit are automatically discarded from the device.

This setting is applicable to drill-through target reports that are launched from IBM Cognos Workspace.

Default: 5

Tip: If your Cognos Mobile environment includes only native clients, set up the default to 50 pages. Otherwise, use the suggested default of 5.
Maximum number of days to store a report
Specifies the maximum time, in days, that a report is stored in the database. Reports that exceed this limit are automatically removed from the device.

Value: 1 to 999

Default: 30

Maximum number of hours between runs of the source and target reports
Specifies, in hours, the maximum amount of time allowed between the runs of the source and target reports when using the application drill-through feature with active reports in the iOS native app. When the difference between the two runs exceeds this amount, the application drill-through target is not used.

The default value of 1 means that as long as the target report was run within 1 hour after the source report was run, the target report can be opened successfully.

The value of 0 disables the application drill-through functionality. When running the source report after the target report using this value, the target report does not open and an error message is displayed. The error message states that the target report does not exist and needs to be run first.

This setting is not applicable for the Android native app.

Permission to share report screen captures
Allows or disallows the users of a native client to share screen captures of the reports that they are viewing. Users can share report screen captures by email or by other methods.

Value: True or False

Default: True

Mobile root folder
Specifies the name of the root folder that Cognos Mobile users must start from when browsing or searching content from a mobile device.

Default: blank

The value for this setting must be the Content Manager search path in the following format: /content/package[@name='<root_folder_name>'].

If the setting is blank, Cognos Mobile uses the root content folder or the root folder that is specified in the portal system.xml file stored in the install_location/templates/ps directory. If you add a root folder, use the syntax of the consumer-root setting in the system.xml file.

Tip: To find the search path in IBM Cognos Analytics, view the properties of the package or folder that you want to use as the Cognos Mobile root folder. Then, click View the search path, ID and URL.
Mobile theme support
Specifies if custom mobile themes are supported for the IBM Cognos Mobile web application.

Values: themesOn and themesOff

Default: themesOff

Maximum number of hours to access Mobile local data stored on a device
Specifies the maximum number of hours when users of mobile devices can access the Cognos Mobile local data stored on a device.

Value: 0 to 8760

Default: 36

The value of 0 disables the lease key mechanism.

Maximum number of hours to store cached credentials
If you do not want to store credentials on a device, type 0. To store credentials on a device, type any value that is greater than the current timeout setting for IBM Cognos Analytics. As long as users are logged on, they will have access to their cached credentials.

Value: 0 to 8760

Default: 0

Maximum number of hours that the client can remain out of date with scheduled reports
This setting applies to the cases where an administrator schedules reports for a user on the server and the user does not otherwise communicate with the server before the time expires, for example, to retrieve other reports or to browse the IBM Cognos Analytics portal. In the majority of cases, such as when reports originate from existing schedules or from user-initiated actions, this setting will not be a factor because, typically, the device lags behind the server by only seconds.

Value: 0 to 999

Default: 24

The value of 0 pushes reports to be downloaded on devices immediately.

Security settings

These settings are used to secure the Cognos Mobile application.

Local storage encryption level for IBM Cognos Mobile applications
Specifies the method by which data that is stored on iOS or Android devices is encrypted.

Values: NONE, AES128, AES256

Default: AES128

Tip: The web application does not store data locally and is not affected by this setting.
Security code session timeout in seconds
Specifies the need for a security code when accessing the Mobile application and the maximum number of seconds that the application can remain inactive. The security code cannot contain consecutive or repeated numbers.

Value: 1 to 8760

Default: -1

A value of -1 means that no security code is needed. A value of 0 means that the user must create a security code and enter it every time to access the app.

A value greater than 0 indicates that the user must create a security code and can leave the app inactive for the number of seconds specified in the setting before needing to reenter the code to use the app. For example, if the value is set to 60, the user must enter a security code and can leave the Mobile app inactive for 60 seconds.

Maximum number of attempts to enter a security code when accessing the IBM Cognos Mobile application
Specifies the maximum number of times that users can try to enter their security code when accessing the Mobile application.

Value: 1 to 99

Default: 10

Notification settings

These settings are used to configure Apple push notifications.

Support for Apple push notifications
Enables Apple push notifications for the iOS native app, and specifies the wording of the message that is displayed to the iOS device users. The values are:
  • None - Apple push notifications are disabled and messages are not sent from the server to the Apple Push Notification Service.
  • Name - Apple push notifications are enabled. The messages sent from the server to the Apple Push Notification Service include the report name.
  • Generic - Apple push notifications are enabled. The messages sent from the server to the Apple Push Notification Service do not include the report name. Instead, a generic message is displayed.

Default: Name

The following settings have been deprecated:
  • Notification email for Apple push notifications
  • Frequency check for Apple push notification certificate expiry date in hours
  • Feedback interval for Apple push notifications in hours
  • Expiry threshold for Apple push notifications in days
Note: These settings have been removed from Cognos Analytics 11.0.13 FP4 and newer. These settings are present in versions prior to 11.0.13 FP4, but the settings have no functionality.