Sun Java System Messaging Server 6 2005Q4 MTA Developer's Reference

ProcedureTo Manually Run Your Test Programs

  1. If the program does not explicitly set the channel name, then you must define the PMDF_CHANNEL environment variable.

    The value of that variable must be the name of your channel. The following example shows how to set the PMDF_CHANNEL environment variable:

    # PMDF_CHANNEL=x_test
    # export PMDF_CHANNEL

    For further information, see Running Your Enqueue and Dequeue Programs.

  2. Ensure that any environment variables required to run a program linked against the MTA SDK are defined.

    See Compiling and Linking Programs for additional information.

  3. Under some circumstances, it might be useful to comment out the master_command= line in the file.

    If you do this, you can enqueue mail to your test channel but not have the Job Controller actually run your channel program.

  4. When repeatedly testing your channel program, it is often necessary to restart the Job Controller before each manual test run.

    Otherwise, the Job Controller will hand off messages to your program on the first manual run but not the second manual run. The Job Controller will think that retries of the messages need to be delayed by several hours. By restarting the Job Controller, you cause it to “forget” which queued messages are to be deferred. Thus, when you run your channel again, it will be presented with all of the queued messages.