SNADS for NetWare Global MHS v1.0 revB Release Note The name of this product was changed from NetWare Global Messaging SNADS Protocol Module to SNADS for NetWare Global MHS after the product documentation was printed. The product name has not yet been changed in the documentation. This release note lists enchanced features and provides documentation corrections, trouble-shooting hints and other information of which you need to be aware. Features ======== The SNADS protocol module provides the following features: * Transfers messages between NetWare Global MHS and SNADS endpoints using an existing SNA network. * Provides support for the SNA communications protocols. * Supports connections via direct token ring or SDLC to an SNA wide area network. * Supports one or more LU6.2 sessions and up to two PU2.0 or 2.1 connections. * Supports automatic directory synchronization between DISOSS and NetWare Global MHS. * Supports SMF extended addresses. Extended Address Support ======================== A new feature in SNADS for NetWare Global MHS allows SNADS users to include SMF extended addresses in messages sent to NetWare Global MHS. Because SNADS users can now include address extensions in their messages, the Global MHS server administrator no longer needs to define users with extended addresses in the SNADS Auto-Registration Table. Some environments, such as fax and X.400, require special address information. To support these environments, the SMF protocol contains an extended address field. For example, to send a message to Sharon Carstairs through a fax gateway, a NetWare Global MHS user would address the message to Sharon Carstairs@FaxGate {Fax:1-555-1234/Sharon Carstairs}. However, SNADS does not support extended addresses. To enable SNADS users to send to these environments, the SNADS protocol module allows SNADS users to include extended addresses in their messages. SNADS users can enter extended addresses in one (and only one) of the following three locations: at the beginning of the message; in the subject; or at the beginning of the document. The SNADS protocol module scans these three locations in the order in which they are listed. If it finds an extended address in one of these locations, it will ignore any extended addresses in the others. An extended address definition begins with two open angle brackets (<<) and ends with two closed angle brackets (>>). Between the beginning and ending markers are one or more address extensions, separated by one or more spaces. Thus, the syntax of the extended address definition is as follows: <> Each extension definition has one of the following formats: dgn.den={extended address} dgn.den=(extended address) dgn.den="extended address" where dgn.den is a recipient specified in the message address. The extended address can be enclosed in braces, parentheses, or double quotation marks. If a message has only one recipient, the dgn.den= can be omitted from the extended address definition. For example, Pam Pratt is a SNADS user who wants to send a message to Sharon Carstairs. Messages for Sharon are routed through NetWare Global MHS to a fax gateway. Pam creates a message and addresses it to FAXGATE.SCARSTAI. At the beginning of the subject field, she enters: <<{Fax:1-555-1234/Sharon Carstairs}>> Because the message is addressed to only one user, Pam does not include the dgn.den=. Consider a second example. Pam Pratt wants to send a message to Sharon Carstairs and Donna White, an X.400 user. Messages for Donna are routed through NetWare Global MHS to an X.400 Gateway. Pam creates a message and addresses it to FAXGATE.SCARSTAI and X400GATE.DWHITE. At the beginning of the message, she enters: << FAXGATE.SCARSTAI={Fax:1-555-1234/Sharon Carstairs} X400GATE.DWHITE={X400:C=US;A=Publicmail;P=ABC;O=ABC; G=Donna;S=White} >> Because the message is addressed to more than one user, Pam must include the dgn.den=. SNADS Protocol Module Training ============================== Self-paced study course #1760, titled Administering SNADS for NetWare Global MHS, is available. NetWare Global MHS training course #750 provides comprehensive instruction in installation, configuration, and administration of the NetWare Global MHS software. For more information about either of these training courses, call (800) 233-3382 or (801) 429-5508, or contact your local Novell authorized education center. Contacting Novell Messaging Technical Support Should you need technical support for NetWare Global MHS, contact your Novell reseller, or Novell at (800) NETWARE or (801) 429-5588. Documentation Corrections ========================= The table below lists corrections for the NetWare Global Messaging SNADS Protocol Module Administrator's Guide. p. 6-2, Step 3b If a user's address includes an extended address (for example, if the user is an X.400 user), you must: * Include the extended address when you enter the user's NGM name. * Define the user in the Auto-Registration table (see Chapter 5 for detailed instructions). The NGM name in the Auto-Registration table must also include the extended address. p. 7-8, no. 4 Add the following after no. 4: 4a. Define your server's directory synchronization user (NME-CMP-) in the SNADS Auto-Registration table. This step is necessary because, in NetWare Global MHS, the address of an NME-CMP- user does not contain a workgroup element. (Messages for NME-CMP- users are addressed to NME-CMP-@server.) However, DISOSS requires that every user address contain a workgroup element. p. 7-8, no. 5 After configuring DISOSS and NetWare Global MHS for directory synchronization, you MUST force a full directory reconciliation to initiate the directory synchronization feature. p. 7-12, Step 7 Change the Directory Sync Address for the DISOSS node to NME-CMP-@, where is the workgroup name for the DGN to which the DISOSS NME-CMP- user belongs. Ensure that this workgroup's SNADS alias is its DGN. p. 7-13 Before forcing a full directory reconciliation, add your server's NME-CMP- user to the SNADS auto-registration table. Refer to page 5-2 for detailed instructions. The user's NGM name must be NME-CMP-@ (where is the name of your server). The user's SNADS DUN must be .NME-CMP- (where the is the same as the SNADS REN assigned to your server). p. 7-13 You MUST force a full directory reconciliation to initiate the directory synchronization feature. p. 7-29 The DDN for a remote directory synchronization user must be the same as the user's REN. In the example entry, the DDN and REN should both be "LA." p. 7-34 Note: If a new update is generated when the Directory Parcels Status list contains 40 unsent updates, the oldest update in the list is deleted. p. 8-4, Step 1f, p. 8-9, Step 1f, p. C-4 SNADS.NEW is located in /SNADS. p. 8-5, Step 2d, p 8-10, Step 2d, p. C-2 The NGMSNADS log is located in /LOG. p. B-4 Add the following to the list of [NGMSNADS] parameters: Maximum-Recipients= (Optional) If the maximum number of recipients for which your SNADS node is configured is less than 256 (the default), use this parameter. The SNADS protocol module will split a message addressed to more than recipients into multiple messages. Troubleshooting Hints ===================== For detailed troubleshooting instructions, refer to Chapter 8 of the NetWare Global Messaging SNADS Protocol Module Administrator's Guide. Following are suggestions for troubleshooting common problems. Problem: The SNADS protocol module is rejecting messages being sent to SNADS endpoints. Action: This error occurs if you are using a limited-user version of the SNADS protocol module. The sender is not defined as an authorized user. Add the user to the list of authorized users, following the instructions in Chapter 6 of the guide. Problem: Messages from SNADS are remaining in the NGM queue, with the following workgroup name: -unauthorized-.workgroup Action: This error occurs if you are using a limited-user version of the SNADS protocol module. The NetWare Global MHS recipient is not defined as an authorized user. Add the user to the list of authorized users, following the instructions in Chapter 6 of the guide. Problem: The SNADS node is rejecting messages received from the SNADS protocol module. Action: Check the maximum number of recipients for which your SNADS node is configured. If it is less than 256, add the following parameter to the [NGMSNADS] section of your server's NGM.CFG file: Maximum-Recipients= where is the maximum number of recipients your SNADS node will accept. For more information about NGM.CFG, refer to Appendix B of the guide. Problem: Directory information received from DISOSS is not being integrated into the Global MHS database. Action: Ensure that your Global MHS server subscribes to the DISOSS workgroups. For more information, refer to Chapter 7 of the guide. General Information =================== This section provides additional information about the SNADS protocol module. * If a session terminates while the SNADS protocol module is delivering a message to SNADS, the SNADS protocol module will resend the message during the next session. If the message was delivered successfully before the termination occurred, two copies of the message might be delivered to the SNADS recipient. * When a DISOSS user sends a message to a NetWare Global MHS distribution list, DISOSS receives a DIA status (delivery report) from each of the list members. Since the list member names do not match the original recipient name (the distribution list), the message status is not updated. For example, a DISOSS user sends a message to a NetWare Global MHS list called "Managers." NetWare Global MHS distributes the message to John Smith and Mary Adams, the list members. DISOSS receives DIA statuses from John and Mary, but it does not receive one from "Managers," the original recipient. Therefore, it does not update the message status. * SMF short names can only include letters, numbers, and the following special characters: #, $, and -. To ensure compatibility between SNADS and NetWare Global MHS, do not use unsupported characters (such as spaces) in SNADS names. * If you are using DISOSS Directory Synchronization, workgroups in your organization must not include both DISOSS and NetWare Global MHS users. Copyright 1993 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher. Novell, Inc. 2180 Fortune Drive San Jose, CA 95131 U.S.A. Disclaimer ========== Novell, Inc. makes no representations or warranties with respect to the contents or use of this manual, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes. Further, Novell, Inc. makes no representations or warranties with respect to any NetWare software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of NetWare software, at any time, without any obligation to notify any person or entity of such changes. Trademarks ========== NetWare and Novell are registered trademarks and NetWare MHS, NetWare Global MHS, NGM, and SNADS for NetWare Global MHS are trademarks of Novell, Inc. NetWire is a service mark of Novell, Inc. SNADS for NetWare Global MHS v1.0 Release Note January 1993 Novell Part Number 123-000244-002