Create operation for the MOM adapter
This section illustrates the adapter request and response for the Create operation.
Use the <items> element when you call the adapter from an out-of-the-box process in TrueSight Orchestration Development Studio. Use the adapter request XML when you create a custom process by using the Call Adapter activity in TrueSight Orchestration Development Studio.
Create Alert operation
The Create Alerts operation enables you to insert an alert on the Microsoft Operations Manager 2005 server.
You can specify any valid resolution state while creating an alert. The next call that the particular connector makes returns the new alert. After sending the alert to the connector, MOM Connector Framework sets the alert resolution state back to New.
The following table describes the elements for the <items> XML element and adapter request for the Create Alerts operation:
Elements for the <items> XML element and adapter request for the Create Alerts operation
The following figure shows the <items> XML element for the Create Alerts operation:
<items> XML element for the Create Alerts operation
<!--1 or more-->
<operation-parameter>
<related-id></related-id>
<name></name>
<computer-name></computer-name>
<computer-domain></computer-domain>
<description></description>
<severity></severity>
<owner-name></owner-name>
<custom-field-1></custom-field-1>
<custom-field-2></custom-field-2>
<custom-field-3></custom-field-3>
<custom-field-4></custom-field-4>
<custom-field-5></custom-field-5>
<source></source>
<resolution-state></resolution-state>
<problem-state></problem-state>
<component></component>
<component-instance></component-instance>
<server-role></server-role>
<server-role-instance></server-role-instance>
</operation-parameter>
</items>
The following figure shows a sample adapter request for the Create Alerts operation:
Sample adapter request for the Create Alerts operation
<operation-name>insert_alerts</operation-name>
<!—1 or more/>
<operation-parameter>
<name>MOM Alert</name>
<computer-name>S-17124</computer-name>
<computer-domain>S-17124</computer-domain>
<description>MOM Alert</description>
<severity>Success</severity>
<owner-name>MOM Adapter</owner-name>
<custom-field-1>CustomField1</custom-field-1>
<custom-field-2>CustomField2</custom-field-2>
<custom-field-3>CustomField3</custom-field-3>
<custom-field-4>CustomField4</custom-field-4>
<custom-field-5>CustomField5</custom-field-5>
<source>BMC</source>
<time-raised/>
<resolution-state>0</resolution-state>
<problem-state>Investigate</problem-state>
<component>Connector</component>
<component-instance>Connector</component-instance>
<server-role>MOM Server</server-role>
<server-role-instance>S-17124</server-role-instance>
</operation-parameter>
</mom-request>
The following table describes the adapter response elements for the Create Alerts operation:
Adapter response elements for the Create Alerts operation
The following figure illustrates the adapter response for the sample Create Alerts operation:
Sample adapter response for the Create Alerts operation
<metadata>
<status>success</status>
</metadata>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<InsertAlertsResponse xmlns="http://www.microsoft.com/EnterpriseManagement
/Mom/Connector/V2">
<InsertAlertsResult>
<InsertedAlerts>
<SuccessfulAlertInsert>
<NewAlertId>guid</NewAlertId>
<RelatedAlertId>guid</RelatedAlertId>
</SuccessfulAlertInsert>
<SuccessfulAlertInsert>
<NewAlertId>guid</NewAlertId>
<RelatedAlertId>guid</RelatedAlertId>
</SuccessfulAlertInsert>
</InsertedAlerts>
<FailedAlerts>
<FailedAlertInsert>
<FailedAlertId>guid</FailedAlertId>
<Error>InvalidRuleId or InvalidServerRole or InvalidComponent</Error>
</FailedAlertInsert>
<FailedAlertInsert>
<FailedAlertId>guid</FailedAlertId>
<Error>InvalidRuleId or InvalidServerRole or InvalidComponent</Error>
</FailedAlertInsert>
</FailedAlerts>
</InsertAlertsResult>
</InsertAlertsResponse>
</soap:Body>
</soap:Envelope>
</mom-response>