Configuring the GroupWise API Gateway

In order to complete the configuration of the GroupWise® API Gateway, you must configure Broker rights and modify the API's startup file. These procedures are discussed here.


Configuring Broker Rights

One of the functions of the Broker object is to relay messages from the printer to the GroupWise API Gateway. The API Gateway then translates these messages into GroupWise mail messages that can be sent to the appropriate user or administrator.

The transfer of these messages takes place in the API input and output directories located in the gateway directory (see Defining Required Gateway Properties).

You must grant file rights to the Novell® Distributed Print ServicesTM (NDPSTM) Broker object for the API Gateway directory to allow the broker to write to the API gateway directory. To do this, complete the following steps.

  1. In the NetWare® Administrator utility, browse to the gateway directory.

  2. Right-click the gateway directory object and select Details from the pop-up menu.

  3. From the list of pages on the right-hand side of the Broker Details dialog box, select Trustees of this Directory.

  4. Click the Add Trustee button.

  5. In the window at the left of the Add Trustee dialog box, browse to the Broker object and double-click it.

  6. Enable all file rights by clicking the Supervisor check box.

  7. Click OK.


Modifying the GroupWise API Gateway Startup File

A startup file is an ASCII text file that stores the startup switches that the GroupWise API Gateway uses. Startup switches configure the NetWare Loadable ModuleTM (NLMTM) program to work in your specific network environment.

When you installed the gateway, a sample NGWAPI.PRM file was copied to the gateway directory. This sample file shows some of the startup switches that you can use.

You can use a text editor to make adjustments to the startup file. You can use a semicolon (;) at the beginning of a line to add comments or to disable a switch.

The GroupWise 4.1 API NLM gateway requires the use of the /Home switch to point it to the gateway home directory. Make sure that this switch is properly configured in the NGWAPI.PRM file. The proper syntax is /Home-server\volume:\gateway directory. Example: /Home-myserver\sys:\api41\wpgate\api41.