How to suppress new alerts in the Alert Manager after upgrading Control-M Server?- INCLUDES VIDEO

Knowledge Article

Article Number

000252908

Old Article Number

000030038

Article Type

FAQ/Procedural

Title

How to suppress new alerts in the Alert Manager after upgrading Control-M Server?- INCLUDES VIDEO

Summary

How to suppress new alerts in the Alert Manager after upgrading Control-M Server?

Product

Control-M/Server for UNIX and Microsoft Windows

Component

Control-M/Server for UNIX and Microsoft Windows

Applies to

Control-M Server 7.0.00 Fix Pack 200 (PACTV.7.0.00.200) and later.

Question

How to suppress some of the alerts appearing in the Alert Manager or Global Alert Server (GAS)?

Answer

The following video demonstrates this solution:

To disable these new Alerts, follow these directions:

1. Identify the Message ID of the Alert that should be disabled and not showing in the Alert Manager / GAS
- Find the Message ID by reviewing the Control-M Job Log
- Find the Message ID in the dbs_msgtbl or dbs_ag_msgtbl file under the <ctm_server_home>/data directory

2. Login to the Control-M/Server

3. Navigate to the <ctm_home>/ctm_server/data directory

4. Make a backup copy of config.dat file

5. Open the config.dat file in an editor of your choice

6. Check the config.dat file and see if the following line exists in the file:

ALERT_ON_MESSAGES 5141 5211 5745 5273 5274 5275 5217 5135 5220 0008 0012 0014 0016 0018 5126 5127 5128 5129 5172 5173 5762 5763

7. If the line doesn't exist in the file, move to the end of the file and add the line
*If adding to end of config.dat make sure to leave the empty line at the end.

8. Using the Message ID which is identified in Step 1 above, locate and remove the 4-digit code in the existing line or line that is added in Step 7.
- For example, remove Message ID 0012 if ""JOB LOG COPY TO <X> FAILED" alert is not required.
- After deletion, the new line would look like this:

ALERT_ON_MESSAGES 5141 5211 5745 5273 5274 5275 5217 5135 5220 0008 0014 0016 0018 5126 5127 5128 5129 5172 5173 5762 5763

9. Save the config.dat file

10. Refresh the Control-M/Server to have it reread the config.dat file by executing the command:

  ctmipc -dest ALL -msgid cfg

Note- if after ctmpic the problem still occur please recycle the Control-M/server (there were some cases that the problem resolved just after recycle Control-M/Server)
11. From this point forward, the "JOB LOG COPY TO <X> FAILED" alert will no longer display in the Alerts Manager.

Additional Information:

With enhancement CAR00042665 for Control-M/Server Version 7.0, Control-M/Enterprise Manager send alerts when background actions fail,
For example, shouts, do mail, do remedy, and do force job.
This enhancement can be configured by setting the parameters ALERT_ON_MESSAGES and ALERT_ON_SHOUT_FAILURE, introduced from Control-M Server 7.0.00 Fix Pack 200 (PACTV.7.0.00.200) and later.
ALERT_ON_MESSAGES:
The value of this parameter is a space separated list of error message numbers that, when written to the IOALOG, is echoed as alerts to Control-M/EM.
Use the following format for message ID entries: <message-id>:<urgency>
Urgency values are: R - regular (default) U - urgent V - very urgent For example: ALERT_ON_MESSAGES 5141:U 5211 5745:V 5273:R 5274:V 5275
By default, the parameter is set to:
```
  ALERT_ON_MESSAGES 5141 5211 5745 5273 5274 5275 5217 5135 5220 0008 0012 0014 0016 0018 5126 5127 5128 5129 5172 5173 5762 5763
```
ALERT_ON_SHOUT_FAILURE:
Whether to send Alerts to Control-M EM whhen shouts that are issued by background activities fail.
Value: Y (Default) - An alert is sent to Control-M/Enterprise Manager in the event of shout failure.
The alert message is SHOUT TO <shout destination> FAILED.
N - No alert is sent to Control-M/Enterprise Manager in the event of shout failure
To disable this enhancement,
Set ALERT_ON_MESSAGES to "0" to disable the Alerts Message
Set ALERT_ON_SHOUT_FAILURE to "0" to disable Alert when SHOUT failed.

In case of setting ALERT_ON_MESSAGES be sure not to use the "Tab" Key, use space bar instead, using "Tab" key will cause CE not to resolve the correct value of parameter

Where to find the Message ID?

- The message: "FAILED TO DELETE CONDITION:" is message id 5763. Message ID's can be found in the dbs_msgtbl file in <ctm_server_home>/data directory.
- The message: "JOB LOG COPY TO <X> FAILED" is message id 0012. Message ID's can be found in the dbs_ag_msgtbl file in <ctm_server_home>/data directory.

Attachment(s):