PERFTEST: Monitoring Performance

The PERFTEST sample application demonstrates how to monitor the performance of gateways using the Windows NT Performance Monitor. The PERFTEST application also demonstrates MONITOR.LIB functions. For more information about the performance monitor, see Using the Performance Monitor and Installing Performance Monitoring.

The PERFTEST sample application performs some gateway functions in that it receives and sends messages. But as a testing application, PERFTEST cannot receive messages from foreign systems. When a user sends a message, PERFTEST adds its own header to the subject line of the message and then returns it to the sender. This behavior lets you control the test closely by sending messages to PERFTEST. The performance monitor process is described in Performance Monitoring.

Note When GWSETUP installs the sample gateway, it automatically creates a class key for the gateway in the Windows NT Registry. PERFTEST looks for a specific class key named PerfTestType in the registry, so it won't run on the sample gateway as installed by GWSETUP. If you create a new PerfTestType key for the sample gateway, you will have two keys pointing at the same object, and you will see two identical objects when you view the performance data in the Windows NT Performance Monitor.

If the sample gateway was installed using GWSETUP, you must completely remove it and reinstall it using the installation programs GWINST.EXE, SERVINST.EXE, and PERFINST.EXE. This procedure installs a new service, gateway object, and performance monitoring information (using the PerfTestType class key) for PERFTEST to use.

    To build PERFTEST
  1. Change to the directory containing the PERFTEST source files:

    \BKOFFICE\SAMPLES\EXCHANGE\PERFTEST

  2. Type NMAKE.

PERFTEST is usually run as a nonservice application, but it can also be run as a service.