> #### Creating a Simple Network Management Protocol (SNMP) trap action

> You use the SNMP trap action if you want Fathom resource-related event notifications to be sent to your SNMP management console. You define name, description, host, port, and read community details to send event notifications, referred to as traps, to SNMP management consoles such as BMC's PATROL Enterprise Manager Connect SNMP and Tivoli Enterprise Console.

> The SNMP trap action generates an asynchronous message to an SNMP management console.

> Note the following information about SNMP trap actions:

> - To define SNMP trap actions, you must have previously installed the Fathom SNMP Adapter product. Also, you must define the Fathom SNMP Adapter option on the Fathom Management Configuration page.
> - To send SNMP trap actions and make SNMP requests, the SNMP agent must be running. To review or change the current status of the SNMP agent, select Options from the menu bar and select SNMP to display the SNMP Adapter page. Note that this page also displays a summary of the SNMP information set up on the Fathom Management Configuration page. You can elect to edit this information.
> - All Fathom-specific SNMP variables and tables are located in the Fathom Management Information Base (MIB). The MIB file, `PSC-FM-MIB.txt,` is located in the `<`Fathom-install-dir`>\config` directory. Review the contents of this file and focus specifically on the `fmalertTable`, which contains information specific to each alert. The alert ID information in this file allows you to understand the contents of this table.
> Table 4–4 presents two examples that identify how you can obtain alert details from the `fmalertTable`.

> Table 4–4: Alert details obtained from the fmalertTable
> To obtain an alert reason associated with Alert ID... | Issue an SNMP GET request using this Object Identifier (OID)...
> --- | ---
> 3 | `1.3.6.1.4.1.1730.1.2.1.1.6.1.6.3`
> 4 | `1.3.6.1.4.1.1730.1.2.1.1.6.1.6.4`

> For more information about the SNMP Adapter and its configuration, see the Installation and Configuration Guide. For information about initiating SNMP GET requests from an SNMP agent, see the SNMP management console documentation for your particular SNMP management console product.

> To create an SNMP Trap Action:

> 1. Select Library from the menu bar. The Fathom Component Library page appears in the detail frame.
> 2. Click Create SNMP Trap Action. The SNMP Trap Action page appears:

> 3. Enter the name in the Name field.
> 4. Enter a description in the Description field.
> 5. Enter the name of the host machine on which the SNMP management agent resides in the Host field. Traps will be sent to this host machine. (If you set a default value for the Host field on the Fathom Management Configuration page, that value appears in this field.)
> 6. Enter the port number of the host machine on which the SNMP management agent resides in the Port field. Traps will be sent to this port number on the host machine. (If you set a default value for the Post field on the Fathom Management Configuration page, that value appears in this field.)
> 7. Enter the community who will have read access to the trap information in the Read Community field. Your choices are public, private, or any other community you have set up for access. (If you set a default value for the Read Community field on the Fathom Management Configuration page, the value appears in this field.)
> 8. Click Save to submit your selections.

> Once you have set up SNMP trap actions, you can associate them with resources just as you would any Fathom action. When the resource generates an alert, the SNMP trap action is thrown.

> You can review the content of the trap (known as variable bindings) as they are defined in the MIB. You can query these variables any time the Fathom SNMP Adapter agent is running.

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