Connect operation

The Connect operation allows the BMC Impact Integration Web Services to connect with specific instances in the BMC Impact Manager network. The Connect operation is required when you want to send events.

Note

The query operations use their own connection protocol, which is distinct from the Connect operation.

WSDL for Connect operation

<wsdl:operation name="Connect" parameterOrder="inargs">
           <wsdl:input message="tns:Connect_Request"/>
           <wsdl:output message="tns:Connect_Response"/>
           <wsdl:fault message="tns:Execution_Fault" name="Execution_Fault"/>
    </wsdl:operation>

WSDL message for Connect

<wsdl:message name="Connect_Request">
       <wsdl:part element="elems:Connect" name="inargs"/>
   </wsdl:message>
   <wsdl:message name="Connect_Response">
       <wsdl:part element="elems:Connect_output" name="outargs"/>
   </wsdl:message>

XSD schema for request and response for Connect

<xsd:element name="Connect">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="userName" nillable="true" type="xsd:string"/>
<xsd:element name="password" nillable="true" type="xsd:string"/>
<xsd:element name="imname" nillable="true" type="xsd:string"/>
<xsd:element name="bufferType" nillable="true" type="types:IMBufferType" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="Connect_output">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="connectionId" type="xsd:long" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>

Parameters for Connect

Name	Direction	Element name	Description
userName	In	tns:userName	String type that specifies the user name defined for the instance
password	In	tns:password	Not currently used
imname	In	tns:imname	String type that identifies the name of the BMC Impact Manager instance
bufferType	In	tns:bufferType	A string type that indicates one of four values: BMCII_BUFFER_MODE_DEFAULT BMCII_BUFFER_MODE_NONE BMCII_BUFFER_MODE_LOW BMCII_BUFFER_MODE_HIGH For a description of the buffer types, see IMBufferType .
connectionId	Out	tnc:connectionId	Long integer that specifies the connection handle