Manage a subset of ITE applications with the Lookup Manager application

You can allow your Lookup Manager to control a subset of the ITE applications only, when you provide the list of ITE applications at submission-time. You might come to situations, in which you want to shrink the list of controlled ITE applications, for example:
  • You want to shutdown an ITE application for a longer time.
  • You want to test your Lookup Manager application without ITE applications.

Per default, the Lookup Manager job manages a list of all supported ITE applications in the LookupMgrCustomizing.xml file. It synchronizes the application control states by control files in the directory specified by global.applicationControlDirectory parameter.

The Lookup Manager job supports the lm.controlledApplications submission time parameter, which you use to specify the set of controlled ITE applications. You can define a subset of ITE applications by the parameter. The Lookup Manager job surveys the list of ITE jobs at submission time during the application's start-up phase.

Remember, you are not able to extend the list of ITE applications defined in the LookupMgrCustomizing.xml file at submission time.

You can specify an empty list of ITE applications. In this case, the Lookup Manager job does not check the status of any ITE job and it processes the setup of the lookup repositories immediately.

Procedure

  1. List ITE applications as specified by the Application Namespace attribute in the LookupMgrCustomizing.xml file.
    Example with grep command (from project path): 
    
grep "Application Namespace" LookupMgrCustomizing.xml

    <Application Namespace="ite.appl1"/>
    <Application Namespace="ite.appl2"/>
    <Application Namespace="ite.appl3"/>
    <Application Namespace="ite.appl4"/>

  2. Submit the Lookup Manager application with a subset of ITE applications. The list of specified ITE applications in the LookupMgrCustomizing.xml file, according to the example: ite.appl1, ite.appl2, ite.appl3, ite.appl4

    a. Selected applications: ite.appl1, ite.appl3 

    
streamtool submitjob -P lm.controlledApplications="ite.appl1,ite.appl3" <path-to-lookupmanager-sab-file>
    Example (from project path): 
    
streamtool submitjob -P lm.controlledApplications="ite.appl1,ite.appl3" output/LookupManagerMain/common.lookup.LookupManager.Main.sab

    b. Selected applications: none 

    
streamtool submitjob -P lm.controlledApplications="" <path-to-lookupmanager-sab-file>
    Example (from project path): 
    
streamtool submitjob -P lm.controlledApplications="" output/LookupManagerMain/common.lookup.LookupManager.Main.sab