Quarantine
The Quarantine page displays internal system messages that were intercepted because they were not processed correctly or because the server was not able to process them at all. Putting these messages in Quarantine helps checking them before taking action.
This page includes the following:
Overview
Internal messages control processing based on objects and their settings. This is why is so important to check the content of these messages.
Invalid messages cancel a server process. They are intercepted and displayed in the Quarantine page of the Administration perspective thus protecting your system, since quarantined messages do not affect the server processes.
Note: Quarantined messages are helpful for further analysis. In some cases messages should not be released without consulting CA Automic Support first, but it is always advisable to contact support before releasing a message.
When a message is intercepted and quarantined, a notification message is sent to all users with the in all clients of the system.
This area of the Administration perspective and the respective notification of new messages in Quarantine in the AWI are only displayed when the User object or UserGroup has the privilege Create diagnostic information and a modification right for server processes. For more information ,see Granting Automation Engine Privileges.
Click Open on the quarantine notification message to access the Requests dialog. The left panel of the dialog provides the list of tasks that triggered the requests while the right pane displays information on the triggering task and allows you to either Acknowledge the message or to open the Quarantine list.
The Quarantine List
The following columns are displayed by default:
-
Message number
-
Alarm
Indicates the message has not been acknowledged
-
Status symbol
-
Unprocessed: May be released after prior contact with CA Automic Support
-
Locked: Has been logged for analysis reasons but cannot be released
-
Processed: Has successfully been processed and can be deleted
-
-
Occurrence time
Time when the message was quarantined
-
Reason for failure
-
Replays
Number of release attempts
-
XML Stream
Message sections (if retrievable) for analysis
For more information, see Showing and Hiding Columns.
In the toolbar, the buttons Export and Refresh are available by default. These buttons allow you to refresh the content of the table and export it as a CSV file.
Deactivating Internal Message Checking
To deactivate this function use the parameter exception= in the Automation Engine's INI file. For more information, see Automation Engine.
Invalid Messages
Upon detecting an invalid message, the system processes them as follows:
- The message is put into quarantine.
- All database modifications made by this message are canceled.
- Further message information is written to the Automation Engine's log file.
- A trace file of the following name is created:
UC4Dump_name of the Server process_RunID_timestamp.txt
Example
c:\AUTOMIC\server\temp\UC4Dump_UC2T#WP002_40373135_20060406144901543.txt - If possible, a dump is created.
- The ServiceManager restarts the aborted server process.
- If the administrator has set the EXECUTE_ON_EXCEPTION key in the UC_SYSTEM_SETTINGS variable, the specified object starts. For more information, see EXECUTE_ON_EXCEPTION.
Working with Quarantined Messages
You can show the message internal information, release them to reprocess tasks, acknowledge unprocessed messages and delete processed messages.
Showing Messages
Right-click the relevant message and select Show Message to display the internal, technical information of the message. Click Close to go back to the Quarantine list.
Releasing Messages
Releasing messages allow you to reprocess tasks.
Note: Only release messages after contacting CA Automic Support.
Right-click the relevant message and select Release. A dialog opens in which trace options can be set. Select the server process you want to use to process the message and select Release. The status of the message changes to Processed and a notification at the top of your system shows the message has been released successfully. For more information, see Diagnostic Tools.
Note: Only the primary work process executes PWP messages.
The trace options that are specified are deactivated after the execution attempt. If the message could be processed without failure, it remains in the list but can be deleted with a context menu command.
Acknowledging Messages
Right-click one or more unprocessed messages an select Acknowledge to mark the messages as read. After acknowledging a message the alarm icon is no longer displayed in the Alarm column.
Deleting Messages
Right-click one or more messages and select Delete to remove them from the list after being successfully processed. You will be prompted to confirm your action.
See also: