GetEvents operation

The GetEvents operation is a polling call that the client initiates to receive a specified number of a certain event type from the BMC Impact Manager network. You do not have to be connected (Connect) to an instance to get events, but you do have to invoke a subscription request (Subscribe).

WSDL for GetEvents operation

<wsdl:operation name="GetEvents" parameterOrder="inargs">
<wsdl:input message="tns:GetEvents_Request"/>
<wsdl:output message="tns:GetEvents_Response"/>
<wsdl:fault message="tns:Execution_Fault" name="Execution_Fault"/>
</wsdl:operation>

WSDL messages for GetEvents

<wsdl:message name="GetEvents_Request">
<wsdl:part element="elems:GetEvents" name="inargs"/>
</wsdl:message>
</wsdl:message>
<wsdl:message name="GetEvents_Response">
<wsdl:part element="elems:GetEvents_output" name="outargs"/>
</wsdl:message>

XSD schema for request and response for GetEvents

<xsd:element name="GetEvents">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="filterName" nillable="true" type="xsd:string" />
<xsd:element name="context_nio" nillable="true" type="xsd:string" />
<xsd:element name="num_of_events" type="xsd:int" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="GetEvents_output">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="getEventsResponse" nillable="true" type="types:GetEventsResponse" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:complexType name="GetEventsResponse">
   <xsd:sequence>
    <xsd:element name="response" type="event:ArrayOf_Event"/>
    <xsd:element name="num_of_events" type="xsd:int"/>
   </xsd:sequence>
  </xsd:complexType>

Parameters for GetEvents

Name	Direction	Element nme	Description
filterName	In	tns:filterName	String type that identifies the name of the event selector that the client has chosen. The client is requesting and gets the events that match the criteria specified by the filterName. The value of the filterName must match the filterName value specified in the preceding Subscribe operation.
context_nio	In	tns:context_nio	String type that identifies the name of the Web Service client that is making the request.
num_of_events	In/Out	tns:num_of_events	As the input argument, this is the integer that specifies the number of events the client seeks to receive per polling call. As the output argument, it indicates the number of events that the server is able to return.
response	Out	event:EventArray_ element	Complex type that specifies the name of one or more events that are being returned in response to the Web Service client's polling call.