IBM Support

IBM Cognos Performance Management Hub Service Names and Properties for TM1 10.2.2

Product Documentation


Abstract

The names of services and their properties on the IBM Cognos Performance Management Hub Administration and Configuration page are very technical in nature. This note documents their meaning in a more friendly way. Additionally, the note provides guidance on the possible property values.

Content

In the Performance Management (PM) Hub, configuration properties can be viewed and updated in the Administration and Configuration page, by any user who has ‘admin’ rights. These settings (listed in tables below) will apply to the PM Hub instance and the services running on it. Any updates performed on the Administration and Configuration page are saved so that if PM Hub is restarted they are still available.

The Administration and Configuration page is available at a URL similar to the following:

<font>localhost:9510/pmhub/pm/admin</font>

The following table and fields describe the property and service names on the Administration and Configuration page:

The ‘Property Technical Name’ column lists the technical property names that currently appear on the PM Hub 10.2, Administration and Configuration page.

The ‘Name’ column lists the actual property names that we would want to show instead of the technical names.

The ‘Description’ column contains the technical notes for each item.

Configuration Properties listed by component ID:

· com.ibm.ba.pm.resource.apns - Mobile Notification Service

Property Technical NameDefault ValueNameDescription
Service.pidcom.ibm.ba.pm.resource.apnsMobile Notification ServiceName of the service configuration.
ApplePushNotification.FeedBackIntervalHours24APN feedback interval (in hours)The time interval at which the service should check with the APN server for failure feedback on known devices. When a failure is recorded, the device is removed from the database.
ApplePushNotification.Level
APN levelThe APN level, which determines how communication is to take place with the APN server.
ApplePushNotification.ExpiredThresholdDays14APN expiry threshold (in days)The threshold (in days) at which warning messages should be written to the log file about pending APNS certificate expiry. For example, a value of 14 would cause warning messages to start appearing in the log file 14 days before the certificate is set to expire.
ApplePushNotification.CheckFrequencyHours24APN certificate validation frequency (in hours)The time interval at which the service should check if the APNS certificate is about to expire.

· com.ibm.ba.pm.resource.mobile - Mobile Service

Property Technical NameDefault ValueNameDescription
Service.pidcom.ibm.ba.pm.resource.mobileMobile ServiceName of the service configuration.
Database.NamemobDatabase nameName of the mobile database.
Database.Username
Database usernameThe username used to connect to the mobile database.
Database.MaxConnectionPoolSize5Max connection pool sizeThe maximum connection pool size for the mobile database.
Database.MaxBlobChunkSize
Max blob chunk sizeThe maximum blob chunk size for the mobile database.
Database.ServiceName
Database service nameThe service name for the mobile database.
Database.HostPort
Database host:portThe host-port combination for the mobile database. The expected format is <host>:<port>.
Database.MaxConnectionPoolWaitSeconds0Max connection pool wait time (in seconds)The maximum connection pool wait time (in seconds).
Database.DeviceExpiryIntervalDays45Device expiry interval (in days)The device expiry time, in days. Any device record that has not been updated within that period will be removed from the database.
Database.DriverEmbeddedDerbyDatabase driverThe driver for the mobile database.
Database.Specifier
Database specifierThe specifier of the mobile database.
Database.MessageExpiryIntervalDays45Message expiry interval (in days)The message expiration time, in days. Any message record older than this period will be removed from the database.

· com.ibm.ba.pm.resource.queue - Queue Service

Property Technical NameDefault ValueNameDescription
Service.pidcom.ibm.ba.pm.resource.queueQueue ServiceName of the service configuration.
RetryAfter5Retry-After header valueThe Retry-After response header. Number of seconds to retry requesting job status if the job is still in pending or running state.

· com.ibm.ba.pm.resource.security – PM Hub Security

Property Technical NameDefault ValueNameDescription
Service.pidcom.ibm.ba.pm.resource.securityPM Hub SecurityName of the service configuration.
CAMGatewayCmd../pmhub.htmlPM Hub redirect page Location of the PM Hub call-back page relative to the BI Gateway cgi-bin directory.
CAMBIURL
BI Dispatcher URIBase URI to the local or remote Dispatcher (for example <font> localhost:9300/p2pd/servlet/dispatch</font>). It should be similar to the ServerCAMURI parameter in the tm1s.cfg files or to the Internal Dispatcher URI parameter in Cognos Configuration.
CAMGatewayEnv/portal/variables_plan.xml
CAM gateway variables file.
CAMServletURL<font>localhost:9315/p2pd/cam </font>CAM Servlet URIBase URI to the CAM Servlet (e.g. <font>localhost:9510/camsrv/cam </font>). When specified, PM Hub talks strictly to the CAM Servlet. BI URIs will be ignored.
AdminGroups
Admin Groups ListList of groups that have admin rights on PM Hub (such as accessing the Configuration Admin page), using a comma as the delimiter.
CAMGatewayURL
BI Gateway URIBase URI to BI Gateway (e.g. <font> localhost/ibmcognos.cgi/cognosisapi.dll</font>). Should be similar to ClientCAMURI parameter in tm1s.cfg files or Gateway URI parameter in Cognos Configuration.

· com.ibm.ba.pm.resource.session – PM Hub Session

Property Technical NameDefault ValueNameDescription
Service.pidcom.ibm.ba.pm.resource.sessionPM Hub SessionName of the service configuration.
CookieSecurefalseSession cookie – secure propertyWhen false, the session cookie can be accessed via HTTP/HTTPS. When true, the session cookie can be accessed only via HTTPS.
MaxInactivityTimeout3600Idle session time-out (seconds)Time in seconds before inactive sessions will expire automatically. Any request to PM Hub will reset the inactivity timer, but background activity does not.

· com.ibm.ba.pm.resource.tm1 - TM1 Service

Property Technical NameDefault ValueNameDescription
Service.pidcom.ibm.ba.pm.resource.tm1TM1 ServiceName of the service configuration.
version90502000

columns-1Cellset columns per pageThe number of cellset columns to be displayed per page. Use ‘-1’ for no maximum set.
hostlocalhostTM1 admin hostsTM1 admin hosts. Multiple hosts can be specified using a comma as the delimiter.
Rows-1Cellset rows per page The number of cellset rows to be displayed per page. Use ‘-1’ for no maximum set.

· watchlist.notification.config - Watchlist Notifications Service

Property Technical NameDefault ValueNameDescription
Service.pidwatchlist.notification.configWatchlist Notifications ServiceName of the service configuration.
MetricsPollerInterval5Polling Interval (min)Represents the value, in minutes, of the polling interval. Information on a watchlist is read when the polling interval is achieved. If there were any changes, a notification is sent to the watchlist owner.

· com.ibm.ba.pm.pmpsvc.config - Planning Service

Property Technical NameDefault ValueNameDescription
Service.pidcom.ibm.ba.pm.pmpsvc.configPlanning ServiceName of the service configuration.
ServerNamepmpsvc
Name of the web service (appears in the URL after ‘host:port/’ ).
UseSOAPRequestsTrue
Currently this is the only option supported. PM Hub will use SOAP to communicate with the planning service (as the planning service is running outside the PM Hub application).
ServerLocationlocalhost:9510
Host and port number where the planning service is installed.

· com.ibm.ba.pm.opsconsole.monitor.OpsConsoleMonitor - OpsConsole

Property Technical NameDefault ValueNameDescription
Service.pidcom.ibm.ba.pm.opsconsole.monitor.OpsConsoleMonitor OpsConsoleName of the service configuration.
cookiepath/pmhub/pm/opsconsoleCookie pathOpsConsole cookie path.
DashBoardRefreshRate5Dashboard Refresh RateSpeed in seconds at which the dashboard is refreshed.
EnhancedStatusDetailtrueEnhanced Status DetailProvide the enhanced status as well as the basic status in Ops Console. Enhanced status provides more detail but does have a slight performance hit.
ICAS_skin0ICAS_skinObsolete, leave at 0.
LoggingType1Logging TypeUse .csv log files (1) or TM1 Top style log files (0).
PersistenceEnabledTRUEPersistence EnabledIf persistence is enabled the current windows are stored on log off.
UserdataC:\DecTools\eclipse\opsconsoledataUser dataThe location of OpsConsole data and log files.
WatchdogMaxRetries-1Watchdog Maximum RetriesNumber of times the watchdog should retry if it cannot connect to the TM1 server: -1 means continue retrying. If it reaches the failure count the watchdog will stop.

· com.ibm.ba.pm.opsconsole.monitor.tm1.TM1OpsConsoleMonitor - OpsConsole TM1

Property Technical NameDefault ValueNameDescription
Service.pidcom.ibm.ba.pm.opsconsole.monitor.tm1.TM1OpsConsoleMonitor OpsConsole TM1Name of the service configuration.
DefaultAdminHost
Default TM1 Admin HostAdmin host for a server used to secure OpsConsole (can be a comma separated list).
DefaultGroup
Default GroupServer used to secure OpsConsole (can be a comma separated list).
DefaultServer
Default ServerGroup used to secure OpsConsole (can be a comma separated list). DefaultAdminHost, DefaultGroup and DefaultServer must be used together.
SingleSignOnfalseSingle Sign OnSingle Sign on is enabled if CAM is configured.

[{"Product":{"code":"SS9RXT","label":"Cognos TM1"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"TM1","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"10.2.2","Edition":"All Editions","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
17 June 2018

UID

swg27044062