Changing the Link Protocol between the Post Office and the Domain

How messages are transferred between the POA and the MTA is determined by the link protocol in use between the post office and the domain. For a review of link protocols, see Link Protocols for Direct Links.

If you need to change from one link protocol to another, some reconfiguration of the POA and its link to the domain is necessary.


Using TCP/IP Links between the Post Office and the Domain

To change from a mapped or UNC link to a TCP/IP link between a post office and its domain, you must perform the following two tasks:


Configuring the Agents for TCP/IP

To configure the agents for TCP/IP:

  1. If the MTA in the domain is not yet set up for TCP/IP communication, follow the instructions in Configuring the MTA for TCP/IP.

  2. To make sure the POA is properly set up for TCP/IP communication, follow the instructions in Using Client/Server Access to the Post Office.

    Only one POA per post office needs to communicate with the MTA. If the post office has multiple POAs, have a POA that performs message file processing communicate with the MTA for best performance. For information about message file processing, see Role of the Post Office Agent.

  3. In ConsoleOne, browse to and right-click the POA object > click Properties to display the Identification page.


    POA Identification property page

  4. In the Network Address box, click the pencil icon to display the Edit Network Address dialog box.


    Edit Network Address dialog box

  5. In the Message Transfer Port field, specify the TCP port on which the POA will listen for incoming messages from the MTA.

    The default message transfer port for the POA to listen on is 7101.

  6. Click OK twice to save the TCP/IP information and return to the main ConsoleOne window.

Corresponding Startup Switches
You could also use the /mtpinipaddr and /mtpinport startup switches in the POA startup file to set the incoming IP address and port.


Changing the Link between the Post Office and the Domain to TCP/IP

To change the link between a post office and its domain to TCP/IP:

  1. In ConsoleOne, click Tools > GroupWise Utilities > Link Configuration.

  2. In the drop-down list, select the domain where the post office resides.

  3. Click Post Office Links, then  double-click the post office for which you want to change the link protocol.

  4. In the Protocol field, select TCP/IP.


    Edit Post Office Link dialog box

  5. Make sure the information displayed in the Edit Post Office Link dialog box matches the information in the Edit Network Address dialog box for the POA.

  6. Click OK.

  7. To exit the Link Configuration tool and save your changes, click File > Exit, then click Yes.

    ConsoleOne then notifies the POA and MTA to restart using the new link protocol.

For a sample message flow for this configuration, see TCP/IP Link Open: Transfer between Post Offices Successful in Message Delivery to a Different Post Office in Troubleshooting 3: Message Flow and Directory Structure.

Corresponding Startup Switches
You could also use the /mtpoutipaddr and /mtpoutport startup switches in the POA startup file to set the outgoing IP address and port.


Using Mapped or UNC Links between the Post Office and the Domain

To change from a TCP/IP link to a mapped or UNC link between a post office and its domain:

  1. In ConsoleOne, click Tools > GroupWise Utilities > Link Configuration.

  2. In the drop-down list, select the domain where the post office resides.

  3. Click Post Office Links, then double-click the post office for which you want to change the link protocol.

  4. In the Protocol field, select Mapped or UNC.

  5. Provide the location of the post office in the format appropriate to the selected protocol.

  6. Click OK.

  7. To exit the Link Configuration tool and save your changes, click File > Exit, then click Yes.

    ConsoleOne then notifies the POA and MTA to restart using the new link protocol.

For a sample message flow for this configuration, see Mapped/UNC Link Open: Transfer between Post Offices Successful in Message Delivery to a Different Post Office in Troubleshooting 3: Message Flow and Directory Structure.