Chapter 7: Send a Message to Another GroupWise Domain Across the Mainframe

Addressing is the syntax GroupWise users enter on the To: line of the GroupWise* Message View, as shown below, to send messages. The GroupWise user can type the recipient’s address or select the recipient from the Address Book.

Your GroupWise system’s configuration determines the complexity of the addressing syntax for the user. You will want to configure your system to make addressing as convenient as possible for users.

This chapter describes the steps you must follow to configure your GroupWise system so users can exchange messages with users of other GroupWise systems using the mainframe as the transport vehicle. Before you installed the GroupWise Gateway for OfficeVision/VM**, the mainframe system programmer included the gateway in RSCS as an NJE node. The mainframe can be used to facilitate passthrough addressing without using OfficeVision/VM.

• Addressing Without Configuring Your GroupWise System
  
  
• Configuring Addressing When Connecting Through an External Domain

GroupWise-to-GroupWise Addressing Basics
Users of separately administered GroupWise systems can exchange messages across the mainframe using GroupWise addressing syntax. This process, called passthrough addressing, differs from sending a message to an OfficeVision/VM user because messages do not need to be converted to another file format, and full GroupWise functionality is maintained. Passthrough addressing requires one GroupWise Gateway for OfficeVision/VM to be installed in at least one domain of each GroupWise system.

A passthrough message is encapsulated, or placed in an “envelope” by the gateway. The gateway stamps the envelope with the necessary header file, then routes it across the mainframe. When the message arrives at the GroupWise Gateway for OfficeVision/VM of the other GroupWise system, that gateway removes the envelope and passes the message to the Message Transfer Agent, which distributes it to the intended recipient. Throughout this process, the message retains its native GroupWise format.

The example used in this chapter demonstrates how to configure passthrough addressing between two single-domain systems. You can also use passthrough addressing to connect multiple-domain systems via an indirect link. For more information about how to do this, see Create an Indirect Link to an External Domain later in this chapter.

Addressing Without Configuring Your GroupWise System

Once the GroupWise Gateway for OfficeVision/VM is installed at each site, users of each GroupWise system can send messages to each other across the mainframe. However, if you choose not to further configure your GroupWise system, users may find addressing cumbersome. Without any further configuration, the addressing syntax for passthrough addressing is:

gateway:“linkID of remote site.passthru”:domain.po.user

For example, if Bob sends a message to Karl, a user of another GroupWise system, the syntax is:

ovvm:"ovvmnje2.passthru":main.marketing.karl

For information about how to simplify the address string, proceed to the next section.

Configuring Addressing When Connecting through an External Domain

A passthrough link connects the gateway of one GroupWise system with the gateway of another GroupWise system via the mainframe. The GroupWise Gateway for OfficeVision/VM uses an external domain structure to establish the passthrough link. Because both systems use GroupWise, there are a variety of addressing options, depending on how you configure your system. The following sections step you through the process of setting up an external domain. See Chapter 1: Connect Systems by Using External Domains in Book 1: Connect GroupWise 5.2 Systems of the Connectivity Guide

To enable passthrough addressing at both sites, each system administrator must create an external domain structure that duplicates the domain structure of the site to which he or she is connecting. In this example, the GroupWise administrator for the Headquarters domain creates an external domain called Main. At the same time, the GroupWise administrator for the Main domain creates an external domain called Headquarters. By duplicating the post office and users of the remote domain, each GroupWise administrator can reduce the required addressing syntax for users.

Users of both GroupWise systems can exchange messages using standard GroupWise addressing once each GroupWise system administrator has configured his or her external domain. The mainframe serves as the transport vehicle between the two systems.

The terms remote site and local site are essential to an understanding of passthrough addressing. In the examples used below, the Headquarters domain is the local site, and the Main domain is the remote site. All configuration options apply to both sites.

• Standard Addressing (domain.po.user) - Create and Link an External Domain
  
  
• Short Addressing (po.user) - Create a Post Office
  
  
• Simple Addressing (user) - Add Users to the External Post Office

Standard Addressing (domain.po.user) - Create and Link an External Domain
If you create and link an external domain to your GroupWise system, users can send messages to any user of the domain at the remote site using standard addressing.

For a user to send a message to a user of another GroupWise system via the mainframe, the syntax is:

domain.post office.user

In the sample system, Bob sends a message to Karl, a user of another GroupWise system, use the following syntax:

main.marketing.karl

The name of the external domain you create must be identical to that of the domain at the remote site.

To create an external domain,

1. From NetWare* Administrator, click Tools  GroupWise View.
   
   
2. Right-click the name of your GroupWise System where you want to add the external domain  click Create  double-click External Domain.
   
   
3. Fill in the fields:
   
   External Domain Name: Type the name of the domain at the remote site. Make sure this name is identical to that of the domain at the remote site. If they are not identical, users cannot exchange messages.
   
   Domain Type: Select External GroupWise.
   
   Version: Leave this as 4.x.
   
   Time Zone: Select the time zone where the external domain is physically located.
   
   Link To Domain: If you want to change the domain that your external domain is linked to, select the domain from the drop-down box.
   
   Domain Database Location (optional): This field is optional.
   
   
4. Select Define Additional Properties  click Create  fill in the Description field (optional)  click OK.

After you have created the external domain, you must link it to the domain where the gateway resides.

If you are connecting to a GroupWise system with multiple domains, you must create an external domain for each domain at the remote site.

Link the Domains
External domains must be linked to the domain where the gateway resides. You must create an indirect link for each domain in your GroupWise system that does not include the GroupWise Gateway for OfficeVision/VM.

• Create a Direct Link to an External Domain
  
  
• Create an Indirect Link to an External Domain

Create a Direct Link to an External Domain
After you have created the external domain, you must link it to the domain where the gateway resides. This link establishes the connection between the gateway and the mainframe.

To create a direct link,

1. From the NetWare Administrator browser window, click the domain where the gateway is located. This is the domain whose links you will edit.
   
   
2. Click Tools  GroupWise Utilities  Link Configuration.
   
   
3. Click View  Gateway to display the Direct, Indirect and Gateway links between the gateway's domain and the foreign domain. The link status graphics next to the link records indicate their status.
   
   

   Icon	Description
   	Unmodified
   	Modified - needs to be saved
   	Unsafe - change currently being replicated
   	Change made to link from another view
   	No rights to change link

   
   
   
4. Double-click the name of the external domain you want to link to. The Edit Domain Link dialog is displayed
   
   
5. Select Direct from the Link Type drop-down box.
   
   
6. Click OK to save the gateway link. If you are connecting to a GroupWise system with multiple domains, you must create indirect links to the external domains.

Create an Indirect Link to an External Domain
You must create an indirect link for each domain in your GroupWise system that does not include the GroupWise Gateway for OfficeVision/VM. If you want to further simplify the addressing syntax, you must add a post office to your external domain. For more information about how to create a post office to an external domain, see Short Addressing (po.user) - Create a Post Office later in this chapter.

If your GroupWise system or the GroupWise system you are configuring for passthrough addressing has multiple domains, you must create a link for each domain that does not include the GroupWise Gateway for OfficeVision/VM.

In this example, an indirect link will be created for an external domain. Follow the same steps to create an indirect link for secondary domains that do not include the gateway.

To create an indirect link,

1. From the GroupWise View in NetWare Administrator, click the domain where the gateway is located. This is the domain whose links you will edit.
   
   
2. Click Tools  GroupWise Utilities  Link Configuration.
   
   
3. Click View  Gateway to display the Direct, Indirect, and Gateway links between the gateway's domain and the external domain. The link status graphics next to the link records indicate their status.
   
   

   Icon	Description
   	Unmodified
   	Modified - needs to be saved
   	Unsafe - change currently being replicated
   	Change made to link from another view
   	No rights to change link

   
   
   
4. Double-click the name of the external domain you want to link to. The Edit Domain Link dialog is displayed.
   
   
5. Select Indirect from the Link Type drop-down box.
   
   
6. From the Indirect Link Domain field, select the name of the remote site's domain that includes the GroupWise Gateway for OfficeVision/VM.
   
   
7. Click OK to save the gateway link.

Short Addressing (po.user) - Create a Post Office
If you add a post office to an external domain, users do not have to use an external domain name in the addressing syntax. The name of the post office at the local site must be identical to the name of the post office of the domain at the remote site.

For a GroupWise user to send a message to a user of another GroupWise system across the mainframe, the syntax is:

post office.user

In the sample system, if Bob wants to send a message to Karl, a user of another GroupWise system, the syntax is:

marketing.karl

Short addressing does not restrict users from using standard or nonconfigured addressing to send messages to GroupWise users at the remote site.

Before you can add a post office to an external domain, do the following:

• Create an External Domain (see Standard Addressing above)
  
  
• Create a Gateway Link (see Link Domains above)

If you have not completed each of these tasks, refer to the appropriate sections before you proceed.

To create a post office,

1. From NetWare Administrator, click Tools  GroupWise View.
   
   
2. Right-click the name of your GroupWise System where you want to add the external domain  click Create  double-click External Post Office.
   
   
3. Fill in the fields:
   
   External Post Office Name: This name must be identical to the name of the post office at the remote site. If the names are not identical, messages cannot be transferred.
   
   External Domain: This name must be identical to the name of the domain at the remote site under which the remote post office is located. Click the browse box to change this if necessary.
   
   Time Zone: Verify the time zone for the physical location of the external post office is correct. The post office assumes the time zone of the domain where it resides.
   
   
4. Select Define Additional Properties  Click Create.
   
   
5. Fill in the Description field (Optional). For example, you could include the date, or any other information  Click OK.

The post office is displayed in the System window under the external domain. You can create as many post offices as you need to duplicate the remote site’s structure.

If you want to further reduce the addressing syntax, you can add user IDs from the remote site to the post office you just created. See Simple Addressing below.

Simple Addressing (user) - Add Users to the External Post Office
Adding user IDs from the remote site to your GroupWise address list makes addressing convenient. Users can then simply type the remote site user’s ID on the To: line of the GroupWise Message View, or they can select remote site users from the GroupWise address list.

There are two ways to add user IDs from the remote site to your GroupWise system: (1) add each user ID manually, or (2) use the Export/Import feature. Using the Export/Import option is recommended if you want to add a large number of user IDs. For more information on Import/Export, see Import Users into GroupWise in Chapter 1: Add Users to GroupWise in Book 2: Maintain GroupWise Users of the Maintenance Guide.

To send a message to a user at a remote site across the mainframe, a GroupWise user can use the address list or the following syntax:

user

In the sample system, Bob sends a message to Karl, a GroupWise user at a remote site, the syntax is:

karl

Simple addressing does not restrict users from sending messages to GroupWise users of the remote site who are not included on the address list. Users can still use long and standard addressing to communicate with users at the remote site who have not been added to the GroupWise address list.

For information about adding multiple users from the remote site to your GroupWise system, see Import Users into GroupWise in Chapter 1: Add Users to GroupWise in Book 2: Maintain GroupWise Users of the Maintenance Guide.

Before you can add user IDs from the remote site to the post office of the external domain, do the following.

• Create an External Domain (see Standard Addressing above)
  
  
• Create a Gateway Link (see Link Domains above)
  
  
• Add a Post Office in the External Domain (see Short Addressing above)

If you have not completed these tasks, refer to the appropriate sections before you proceed.

To add user IDs manually,

1. From NetWare Administrator, click Tools  GroupWise View.
   
   
2. Right-click the name of your GroupWise System where you want to add the external domain  click Create  double-click External User.
   
   
3. Fill in the fields:
   
   User Name: Enter the exact ID of the user at the remote site. If the two user IDs are not identical, messages cannot be sent.
   
   External Post Office: Ensure that the correct External GroupWise Post Office is shown.
   
   
4. Select Define Additional Properties to define additional information for the external user  Click Create.
   
   
5. Fill in the fields:
   
   First Name: Enter the first name of the user at the remote site. This name does not need to be identical to the name used at the remote site. The name you enter here appears in the Address Book
   
   Last Name: Enter the last name of the user at the remote site. This name does not need to be identical to the name used at the remote site. The name you enter here appears in the Address Book.
   
   All other fields are optional.
   
   
6. Click OK to save the information.

* Novell trademark. ** Third-party trademark. See Trademarks for more information.