BMC Impact Integration Web Services functions

This topic provides an overview of the essential components of the BMC Impact Integration Web Services and how they operate.

BMC Impact Integration Web Services configuration file

The BMC Impact Integration Web Services configuration file, ImWebServices.conf, is a text file stored in the $IIWS_HOME/Tomcat/webapps/imws/WEB-INF/etc directory. It is loaded at start-up by BMC Impact Integration Web Services.

 In most situations, the preconfigured values of ImWebServices.conf are sufficient.

 For more information about modifying the default ImWebServices.conf file, see Configuration file.

BMC Impact Integration Web Services selector file

The BMC Impact Integration Web Services uses the selector file to define groups of criteria (called selectors) that are used to identify and select events that are propagated from BMC Impact Manager cells. The default selector file, iiws.selector, is stored in the $IIWS_HOME/Tomcat/webapps/imws/WEB-INF/etc directory.

The selector file is required for the BMC Impact Integration Web Services clients that receive events from BMC Impact Manager cells. It is a case-insensitive text file.

The selector file is crucial in determining which events the subscribing clients receive.

Note

The selector file is not required for web service clients that only send events or data or that only launch queries.

The selector file name is provided in the ImWebServices.conf file, as shown in the following example:

SelectorFileName=iiws.selector 

The BMC Impact Integration Web Services loads this selector file at start.

The default selector file provides the selector name Always matches for the $ClassName "Event". By using the default selector, the client receives all events propagating from the BMC Impact Manager cells.

BMC Impact Integration Web Services cell configuration file

After you install the BMC Impact Integration Web Services server, a cell configuration file is generated with two default entries. The cell configuration file, mcell.dir, is stored in the $IIWS_HOME/Tomcat/webapps/imws/WEB-INF/etc directory. mcell.dir lists the connection information for all BMC Impact Manager product instances (cells) and event receiver (IIWSGatewayServer) to which your BMC Impact Integration Web Services implementation can connect and communicate. The following example shows the entries with their default port numbers.

cell             <cell Name>     mc   <Host>:1828
gateway.imcomm IIWSGatewayServer mc   127.0.0.1:1859
Was this page helpful? Yes No Submitting... Thank you

Comments