Cognos Mobile service configuration settings
These settings are used to administer the delivery of IBM® Cognos® Analytics content to mobile applications.
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
This setting is applicable to drill-through target reports that are launched from IBM Cognos Workspace.
Default: 5Tip: 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
- 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
- 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.
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-rootsetting in the
system.xmlfile.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
- 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
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
- 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
The value of 0 pushes reports to be downloaded on devices immediately.
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: AES128Tip: 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
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
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.
- 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