Event management service advanced settings

This section describes advanced settings for the event management service.

Parent topic: Advanced settings reference

run.task.max.thread

Specifies the maximum number of threads that are allocated to transfer scheduled requests to a holding queue.

When the event management service runs a task, the task is placed in a queue, awaiting resources to run it. A thread is created to handle the request for the scheduler thread of the event management service.

Default value: 20

Data type:
Integer
Default:
20
Note:

You must restart the service for this setting to take effect.

authenticate_when_scheduled

Determines whether a runAt request header is checked for execute permission for the object that will be executed.

If a check is required and it fails, an exception is thrown.

If set, this check also fails if the user has the permissions but the credentials necessary to run the task at a scheduled time can not be retrieved.

Data type:
Boolean
Default:
false

enable.tide.metrics.jobqueue

Enables the collection and display of specific metrics for the event management service in IBM Cognos Administration.

The following metrics are included:

  • Time in queue high water mark
  • Time in queue low water mark
  • Time in queue
  • Number of queue requests
  • Queue length high water mark
  • Queue length low water mark
Data type:
Boolean
Default:
false

ems.action.requires.permissions.check

Forces the checking of object permissions.

If enabled, a caller with the canUseMonitorActivityTool user capability must also meet one of the following conditions before calling the runSpecification() method against the event management service:

  • The account of the caller must match the account credential used to schedule the event.

  • The caller must have traverse and execute permissions on the target object.

Data type:
Boolean
Default:
false

emf.schedule.validation.enabled

Validates schedule properties such as start date, end date, data types, and user account credentials when Content Manager processes requests to add or update schedules. Disables invalid schedules.

Details of disabled schedules are logged in log files.

Data type:
Boolean
Default:
false

emf.dls.attachment.timestamp.enabled

When set to true, email attachments have report names with a date time stamp. The default format for the timestamp is: yyyy.MM.dd, where yyyy is the four-digit year, MM is the two-digit month, and dd is the two-digit day.

For example, if you attach the report Annual Result in a message, the email that is sent has the following attachment: Annual result - 2014.07.15.pdf.

Set this advanced property if you need to add a date time stamp to report attachments in email. Optionally, change the default dateTime format by setting the advanced property emf.dls.attachment.timestamp.format.

Data type:
Boolean
Default:
false

emf.dls.attachment.timestamp.format

Specifies the dateTime format that is added to report names in email attachments when the emf.dls.attachment.timestamp.enabled advanced property is set to true.

Possible values include various date formats. For example, 15.07.2014 has the format dd.MM.yyyy and 140704120856-0700 has the format yyMMddHHmmssZ. For more information on SimpleDateFormat, see the Oracle website. Do not use a slash or special characters in the format.

Data type:
String
Default:
yyyy-MM-dd