Share via

How to Start and Test the API Gateway

  • Article

 

This topic describes how to start and test the API Gateway.

Before You Begin

To successfully complete the procedure in this topic, ensure that the connector server meets the following requirements:

  • Is running Microsoft Windows Server 2003

  • Has network connectivity to the server running Novell GroupWise

  • Can resolve the name of the server running Novell NetWare

Also, ensure that the server running Novell NetWare and Novell GroupWise has the following software installed:

  • Novell NetWare 3.x or later

  • Novell NetWare Administrator

  • Novell GroupWise 4.1 or later

Procedure

To start and test the API Gateway

  1. At the System Console of your NetWare server, type API, and press ENTER to start the API Gateway's NLM.

    Note

    The API.ncf file is written during the installation of Patch 2 for API NLM. Without the patch, you cannot use the API command to start the gateway. If you do not have the patch, start the API's Gateway NLM using the following command: load <Volume:\Path>\NGWAPI.NLM (for example, load SYS:\API41\NGWAPI.NLM).

  2. On your workstation, start the Novell GroupWise client and log on to your Novell GroupWise mailbox. Compose a new message, address it to Exchange.First Administrative Group.Administrator, and then send it.

    Note

    You cannot perform this step directly on the Exchange server because the MAPI subsystem has not been prepared yet. The Novell GroupWise client requires MAPI, and the MAPI subsystem is installed during the installation of Exchange Server 2003. If you are performing these steps in a test environment without a separate workstation, perform the API Gateway test after you install Exchange 2003.

  3. The API Gateway should place the message body in form of a .bdy file in the \ATT_OUT directory, and the message header should be in an .api file in the \API_OUT directory.

  4. Copy the .bdy file into the \ATT_IN directory. (It is important to copy the message body before you copy the header.)

  5. Open the .api file in Notepad and change the mail header information, as shown in the following sample listing (your sender and recipient information might be different):

    WPC-API= 1.2; 
Header-Char= T50; 
Msg-Type= MAIL; 

From= 

    LN= admin; 
    S= admin; ; 
To= 

    WPPONUM= 1; 
    WPUNUM= 1; 
    CDBA= 0001:0001; ; 
All-To= 

    WPPONUM= 1; 
    WPUNUM= 1; ; 
Msg-Id= 39B424B2.CFE6.0001.000; 

Subject= API Gateway Test;
< further text >

  6. Save the .api file in \API_IN. It is convenient to use the original file name, although the file name and extension actually do not need to be retained.

  7. On the Novell GroupWise client, verify that you have received the test message. For subsequent tests, you must copy the .bdy file into the \ATT_IN directory again before you save the .api file in \API_IN.

  8. After you have finished your tests, delete the .bdy and .api files from the API Gateway directory.

    Testing the Novell GroupWise API Gateway

    f16d1b42-24ee-4da3-925d-a3aacc9b117d

For More Information