Setting Up a Host-Initiated Enterprise Server and Client Run

Enterprise Server supports a protocol that permits a program or job running on the Unisys MCP server to trigger a run of the DATABridge Client or Enterprise Server when audit files become available.

Important: This procedure uses the Notify option, which replaces the DBAuditWait program available in DATABridge Client 5.0 and earlier.

To set up host-initiated runs of Enterprise Server

  1. Open the Server Accessory parameter file, DATA/SERVER/CONTROL, and add the following NOTIFY option for each SOURCE declaration that you want to include. (A SOURCE can have multiple NOTIFY options and multiple SOURCEs can NOTIFY the same PORT.)

    NOTIFY [=] "host" PORT portnumber

    where host is the host name or IP address of the Enterprise Server and portnumber is the Enterprise Server port on which DATABridge Director is listening.

    Example:

    SOURCE BANKDB:

    NOTIFY "192.168.1.100" PORT 8099

    notify "myserver.mycompany.com" port 8007

  2. Save and close the Server Accessory parameter file.

  3. Using a text editor, open the notification command file installed with Enterprise Server (Notify.cmd). (The default location for Notify.cmd is \Program Files\Attachmate\DATABridge\[version]\Enterprise.)

  4. In the file, uncomment either the command to run Enterprise Server or the command to run dbutility, and then save the file with a new name.

  5. Right-click an Enterprise Server source, and select Properties.

  6. For the When more audit is available, run option, click Browse, and select the notification command file that you edited in step 4.

     

    Note: If you use an Enterprise Server configuration file to create your sources, add the path and filename of the batch file to each remote or local source in the configuration file. For example:

    on notify,

    run “C:\Program Files\Attachmate\DATABridge\6.1\Enterprise\MySourceNotify.cmd”

     

    When Director receives the connection request from the Server Accessory, it initiates Enterprise Server. Enterprise Server runs the specified batch file and passes the MCP server host name, SOURCE, and AFN to Director.

    You can use the batch file to do things other than run Enterprise Server or a DATABridge Client. For example, you could set it up to append a message to a text file or to run other programs.

  7. Use one of the following DATABridge host WFLs that will notify the Server Accessory:
    • WFL/DATABRIDGE/COPYAUDIT – Change the line near the top to read:

      WANTNOTIFY = TRUE

    • WFL/DATABRIDGE/NOTIFY – For the string parameter, type the database name.

      For example:

      START WFT/DATABRIDGE/NOTIFY ("BANKDB")

    When either WFL notifies the Server Accessory that an audit file is available for processing (by opening a port file with YOURNAME = "DBSERVERNOTIFY"), the Server Accessory opens the port file on the Enterprise Server indicated by the NOTIFY option and sends a brief message containing the SOURCE name and AFN.