Installing and configuring the event mechanism for a Windows environment

Infranet has an event mechanism that permits it to keep track of the actions that occur in the application. You must configure the event notification mechanism in Infranet before the connector can process event delivery. Follow these steps:

  1. Copy the following WebSphere Business Integration Adapter event module files:
  2. In %INFRANET%\sys\cm, edit the Connection Manager pin.conf configuration file so that the Connection Manager can execute the connector event facilities DLL, FmCw.dll. Add the following line to this file:

    - cm fm_module ..\..\lib\FmCw.dll fm_cw_pol_config_func - pin -- ops_fields_extension_file ..\..\lib\custom_opcode_mem_map

  3. Place the pin_notify_cw file in the %INFRANET%\sys\test directory. This file specifies which opcodes Infranet will call when specific events are raised. If any opcodes need to be added or deleted, follow the standard format of the file. Note that /event encapsulates all subclasses, such as /event/customer, /event/status.
  4. Update the pin.conf file in %INFRANET%\sys\test to be something like the following:
    - nap cm ptr ip <Infranet_cm_machine> <port>
    

    For example:

    - nap cm ptr ip cwengtest 11960 
    

    where cwengtest is <Infranet_cm_machine> and <port> is 11960.

    In addition to the above statement, the pin.conf file should include:

    - nap login_type 1 
    - nap login_name root.0.0.0.1
    - nap login_pw password 
    

    This identifies the login information for a connection to Infranet. If there is no pin.conf file in the directory, copy one into the directory.

  5. Copy the crossworlds.cnf environment configuration file to %INFRANET%\sys\cm. This file allows the event facilities module FmCw.dll to obtain information about the environment.

    If necessary, edit this file for your system. An example of the content for this file is:

    db name = oracle1
    db string = NYNON
    db user = pin 
    db password = pin 
    crossworlds id = 0.0.0.1 \service\admin_client 14088 
    log level = 3 
    log file = D:\pinlog.log
    

    where:

    db name For DB2, db_name is the server-name or a host-variable which contains the server name. For Oracle, db_nameis the host variable.
    db string Name of database. (It is only reguired if you are uisng Oracle as your database.
    db user Name of the user connecting to the Portal Infranet database.
    db password Password.
    crossworlds id POID representing the WebSphere Business Integration Adapter user in Portal Infranet.
    log level Number representing the log level:

    0 : No trace

    1 : Only Error

    2 : Error and Warning

    3 : Error, Warning, and Debug (all traces)

    log file Name of the log file.

    This file is interpreted as a hash table. The keywords are strings on the left of the equal sign, and the values are the strings on the right.

    Note:
    Provide values for db name and db string if your database is Oracle. For DB2, only the value of db name is required. If you have a default database on your local machine there is no need to provide values.
  6. Create an environment variable named CW_PORTAL_PATH that specifies the path to the crossworlds.cnf file.
  7. Restart Infranet services in this order:
  8. Load the pin_notify_cw file into the Infranet application using the following syntax:
    load_pin_notify .\pin_notify_cw 
    

    If errors occur, make sure that \bin directory is in the PATH so that the executable can be located. For error messages, check the pinlog.log in the execution directory.

Copyright IBM Corp. 1997, 2004