seepubsub Configuration File

When seepubsub is invoked as a command line executable, it will default to configuration in the configuration file unless command line parameters are used to override it.

When seepubsub is invoked as a service, the service will read its configuration from the configuration file.

The configuration file is an XML file called seepubsub.exe.config, and must exist in the same directory as the executable.

The config file includes a section called <MicroFocus.SEE.SeePubSub> which contains the relevant subscription information:

 <MicroFocus.SEE.SeePubSub>
  <subscriptions>
    
      <subscription
        url="mfbinp://localhost:9022"
        program="mfbsiemx"
        filter="*:*"
        description="MFBSI Scheduler interface"
        subscriberid="normally-only-used-for-durable-subscribers"
        durable="false"
        nounsubscribe="false"
       />
       <environment>
          <set name="REGION" value="JCLDEMO" />
          <set name="ES_SERVER" value="$REGION" />
          <set name="MFBSI_DIR" value="c:/tmp/mfbsi/$REGION" />
        </environment>
      </Subscriptions>
    
  </MicroFocus.SEE.SeePubSub>

where :

• the URL parameter is a URL in the form "mfbinp://host:port", pointing to an MFBINP channel for an Enterprise Server for .NET region.
• program is the user exit that seepubsub will call when an event needs to be consumed.
  • The exit program needs to be found by the seepubsub process, either via a path search by setting the exits directory on system path, or by fully qualifying it in this parameter.

    This is especially important in the case where seepubsub is run as a Windows service because Windows services do not inherit the environment that they were installed from.

• filter is a string containing a filter used to select the event types that are to be subscribed.

  It has the following syntax :

  type:subtype-classification[,subtype-classification…][&type:subtype-classification…]
  

  where:

  type is a number or * to indicate all types

  subtype-classification is a comma-delimited number or range, * indicates all subtypes

  Example:

   1:*&2:1,2,3&3:1-10,15    
  
  All subtypes for type 1
  Subtypes 1,2 & 3 for type 2
  Subtypes 1,2,3,4,5,6,7,8,9, & 15 for type 3
  

• description is a description of the subscription
• subscriberid is a unique identifier that identifies the subscription. This is used to reconnect in the case of a durable subscription.
• durable is set to "true" if a durable subscription is required. Events will be archived if connection is lost, and retrieved on subsequent re-connection.
• nounsubscribe is set to true if the subscription is not to be unsubscribed when a process exits. Used in conjunction with the durable and subscriptionid parameters.

Each subscription can have a set of environment variables set to it.

The environment section contains a list of name value pairs.