1.6 AppManager Connector Elements

The following table lists the elements that the connector sends to Netcool MTTRAPD probe in the form of SNMP trap:

Connector Element

Varbindint

Description

$ConnectorName

$1

The name of the connector.

$ConnectorVersion

$2

The version number of the connector.

$AMStoreDetail

$3

The alert details in the Netcool Event List.

$QDBName

$4

The name of the AppManager repository.

$QDBHost

$5

The Microsoft SQL Server hosting the repository.

$ConnectorHost

$6

The name of the host for the connector.

$AMSeverity

$7

The original severity of an event in AppManager (1-40).

$AMJobID

$8

The AppManager job ID that originated the event.

$AMEventID

$9

The AppManager event ID for the event.

$AMKSName

$10

The name of the AppManager Knowledge Script (KS) that originated the event.

$AMCategoryName

$11

The name of the AppManager Category the event belongs to.

$AMKSGName

$12

The name of the AppManager Knowledge Script Group (KSG) that originated the event.

$AMKSGID

$13

The ID of the AppManager Knowledge Script Group (KSG) that originated the event. This field is not included in the default mttrapd.rules file.

$AMEventCount

$14

The AppManager Event count of the event.

$AMLastOccurTimeUTC

$15

The UTC time of the last occurrence of an AppManager event.

$AMFirstOccurTimeUTC

$16

The UTC time of the first occurrence of an AppManager event.

$AMEventMsg

$17

The short message text for the event.

$NumAMAgentMsgs

$18

Indicates how many AgentMsg<X> elements (The value of X ranges from 1 to 8) are populated with data.

$AMEventHostIPAddress

$19

The IP address of the computer that originated the event.

$AMEventHostDomainName

$20

The Domain name (NT if Windows, DNS if UNIX). This field is not included in the default mttrapd.rules file.

$AMURL

$21

The Web URL to access the AppManager Web Console interface for the event.

$ConnectorID

$22

The unique identifier for the connector that forwarded the event.

$AMEventHost

$23

The agent computer from which the event originated.

$NCSeverity

$24

The level of severity for the event in Netcool.

$AMAcknowledge

$25

Whether the event is acknowledged in AppManager.

$NCFirstOccurTime

$26

The time of the first occurrence of an AppManager event, converted to Netcool time.

$NCLastOccurTime

$27

The time of the last occurrence of an AppManager event, converted to Netcool time.

$AMParentEventID

$28

The AppManager parent event ID for the event.

$AMAgentMsg

$29

The detailed message text for the event that is populated based on one of the following:

  • The AppManager repository contains an AgentMsgShort field: The message contained in the AgentMsgShort field is populated

  • The AppManager repository contains an AgentMsgLong field that has a message whose length is less than 255 bytes: The message contained in the AgentMsgLong field is populated

  • The AppManager repository contains an AgentMsgLong field that has a message whose length is greater than 255 bytes: The string N/A is populated and the message is divided into a maximum of 8 message chunks with each chunk not exceeding 255 bytes. These message chunks are populated into AMAgentMsg<X> (The value of X ranges from 1-8)

$AMAgentMsg<X>

$30 - $37

Up to eight detailed messages.

If the AgentMsgLong field has a message whose length is greater than 255 bytes, then the string N/A is populated in $AMAgentMsg. The message is divided into a maximum of 8 message chunks with each chunk not exceeding 255 bytes. These message chunks are populated into AMAgentMsg<X> (The value of X ranges from 1-8). Any of the AMAgentMsg<X> elements that is not populated with message remains blank.