Notifications

You can configure KCM Core to notify an operator through the Event Log or by email if any KCM Core job exceeds the configured time. To activate this feature, add the following settings to the [Configuration] section of the dp.ini file in the KCM Core setup.

Ensure that all KCM Core Administrators are closed before adjusting the file dp.ini. After any adjustments are made, the KCM Core and KCM Document Processors need to be restarted in order to apply the changes.

; Notification settings
Notification=
NotificationEvent=
NotificationTo=
NotificationFrom=
NotificationSMTP=

The following is a description of the setting.

Notification

Amount of time before a notification is sent.

NotificationEvent

Windows server where the event is logged. ITPServerMSG.DLL contains the definition for the events and must be installed on the host.

NotificationFrom

Email address used to send emails. This address is only relevant if the email cannot be delivered to the addresses specified in the NotificationTo setting.

NotificationTo

A list of email addresses for recipients of the notification.

NotificationSMTP

SMTP server used to send the notification.

There are no defaults for these settings. If one of them is omitted, the appropriate notifications are not sent. Notifications are sent while the job is still being processed. The status of the job is not affected. If the job finishes while the notifications are still being sent, the KCM Document Processor waits until these notifications are completed.

The following parameters are used to write events to the Windows Event log:

  • Log: Application
  • Type: Error
  • Source: ITPEvent
  • Event ID: 24

The following is a list of the Event parameters:

  • Server
  • KCM Document Processor
  • Job ID
  • Timeout in seconds
  • Time that the timeout was triggered

An example is provided here.

; Notification settings
Notification=10
NotificationEvent=someserver
NotificationTo=operator@somewhere.com,administrator@somewhere.com
NotificationFrom=sender@somewhere.com
NotificationSMTP=smtp.somewhere.com