Cognos Mobile service configuration settings
These settings are used to administer the delivery of IBM® Cognos® Business Intelligence content to mobile applications.
Some configuration advanced settings can also be configured for the Cognos Mobile service. For more information, see Cognos Mobile advanced settings.
Policy settings
These settings define how to deliver Cognos BI content to mobile applications.
- Maximum number of pages to store for each report
- Pages over the specified limit are automatically discarded from the device.
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 c10_location/templates/ps directory. If you add a root folder, use the syntax of the consumer-root setting in the system.xml file.
Tip: You can find the search path in IBM Cognos Connection. For the package or folder that you want to use as the Cognos Mobile root folder, click the Set properties icon. Then, click View the search path, ID and URL. - Mobile web application thumbnails
- Specifies if thumbnails are generated for the IBM Cognos Mobile web application.
Values: thumbsOn and thumbsOff
Default: thumbsOn
- Mobile theme support
- Specifies if custom mobile themes are supported for the IBM Cognos Mobile web application.
Values: themeOn and themeOff
Default: themeOff
- 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 Business Intelligence. 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 Business Intelligence 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.
- Notification email for Apple push notifications
- Specifies the email address or addresses of administrators that are notified about the Apple push notifications certificate expiry date.
The value for this setting is an email address in the following format: admin@domain.com. Multiple email addresses must be separated with a semicolon (;). For example, admin1@domain.com;admin2@domain.com
- 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
- Frequency check for Apple push notification certificate expiry date in hours
- Specifies, in hours, the frequency with which the Cognos Mobile service checks for the Apple push notifications certificate expiry date. The first check is done when the Cognos Mobile service is started.
Value: 1 to 8760
Default: 24
- Feedback interval for Apple push notifications in hours
- Specifies the time interval, in hours, for the Cognos Mobile server to check the Apple push notifications feedback service for failed notifications. The feedback service maintains a list of devices for which there were repeated, failed attempts to deliver notifications. The Cognos Mobile server will stop sending notifications to the devices that it obtained from the feedback service.
Values: 1 to 720
Default: 24
- Expiry threshold for Apple push notifications in days
- Specifies the number of days before the Apple push notifications certificate expiry date when the administrators start receiving emails about the approaching expiry date.
Value: 1 to 365
Default: 14