Clearing an alert

To clear an alert from the command line, use the following syntax:

fathom [-httpport <port-number>] -clear [option] [-comment '<comment text>'] 

Note: You specify -httpport only if OpenEdge Management is running on a port other than the default of 9090.

Table 2–5 lists options to use with the fathom -clear command.

Table 2–5: Clear alert command options
Option syntax
Purpose
How to use
-httpport <port-number>
Use to identify the port number if it is not the default port of 9090.
Provide the -httpport option followed by the port number.
-comment '<comment-text>'
Use to provide a comment when clearing an alert.
Provide the -comment option followed by the comment text. The text must be enclosed in single quotation marks.
-alert <alert-name>
[-container <container>]|
[-resource <resource>]|
[-restype <resource type>]
Use to clear all instances of a particular alert for one specific resource, or for all resources within a specific container.
Provide the -alert command followed by the alert name. Then provide either the resource name or the resource type.
Options are defined as follows:
  • -container — The name of a container as defined in OpenEdge Management.
  • -alert — The name of the alert as defined in OpenEdge Management.
  • -resource — The name or the reference key of the resource as defined in OpenEdge Management. See the "Using the alertlist command with additional options" section for details about the reference key.
  • -restype — The resource type. The type of resource is limited to one of the following: database, file, network, openedge, or system.
-alertid <alert id number>
Use to clear an alert by its number (regardless of the resource or its type).
Provide the -alertid option followed by its number.
-all
[-restype <resource type>]|
[-resource <resource>]|
[-alert <alert name>]|
[-container <container>]|
[-severity <severity>]
Use to clear:
  • All alerts.
  • All alerts for a particular resource type.
  • All alerts for a particular resource.
  • All instances of a particular alert for all resources.
  • All alerts for a specific container.
  • All alerts for a specific severity.
Provide the -all command without an option to clear all alerts, or with one of these options to clear particular alerts:
  • -restype — The resource type. The type of resource is limited to one of the following: database, file, network, openedge, or system.
  • -resource — The name or the reference key of the resource as defined in OpenEdge Management. See the "Using the alertlist command with additional options" section for details about the reference key.
  • -alert — The name of the alert as defined in OpenEdge Management.
  • -container — The name of a container as defined in OpenEdge Management.
  • -severity — The alert severity: Severe, Error, Warning, or Informational.

Example

OpenEdge Management polls your Sports2000 database and sends an alert for Record Waits High (the alert sent when waits for records are above a defined threshold). To clear this alert from the command line, enter:

fathom -httpport 8080 -clear -alert RecordWaitsHigh -comment 'Cleared by 
Admin' 

Note: You specify -httpport only if OpenEdge Management is running on a port other than the default of 9090.

Copyright © 2008 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095