CONTENTS

  Title Page

  Copyright Page

  Preface

  1      Overview of MailWorks

  1.1     MailWorks Components and Clients

  1.2     AXP Support in Version 1.3A

  1.3     MailWorks Server
    1.3.1      MUAS Server
    1.3.2      User Profile Database
    1.3.3      Connect Server
    1.3.4      Print Server
    1.3.5      Directory Service Server
    1.3.6      File Cabinet

  1.4     MailWorks Configurations

  1.5     MailWorks Configurations for Remote DDS Access

  1.6     Considerations for Configuring MailWorks for OpenVMS and Remote DDS

  1.7     MailWorks Networks
    1.7.1      MAILbus
      1.7.1.1      Message Router Transfer Service
      1.7.1.2      Message Router Directory Service
      1.7.1.3      Message Router Management Service
      1.7.1.4      Message Router Gateways
    1.7.2      MailWorks Mailbox

  1.8     TCP/IP Support

  1.9     Management Concepts

  2      Setting Up a MailWorks System

  2.1     Adding Users to a MailWorks System

  2.2     Setting Up the Message Router Directory Service
    2.2.1      Planning the Use of the Message Router Directory Service
    2.2.2      Populating the Message Router Directory Service with Subscribers
      2.2.2.1      Creating Entries in the Message Router Directory
      2.2.2.2      Updating Entries in the Directory Service Database
    2.2.3      Deleting Multiple Subscriber Entries
    2.2.4      Authorizing Users to Exchange Mail with Systems Other than MAILbus Mail Systems

  3      Managing MailWorks

  3.1     Performing Routine Maintenance Tasks
    3.1.1      Backing Up MUAS Server Directories
    3.1.2      Backing Up User's Area
    3.1.3      Backing Up MUAS Servers for Disk Maintenance
    3.1.4      Monitoring MUAS Servers
      3.1.4.1      Monitoring MUAS Server Configuration and Operational Status
      3.1.4.2      Monitoring Counters
      3.1.4.3      Monitoring Status Attributes
      3.1.4.4      Monitoring Log Files
    3.1.5      Monitoring PC Client-Related Servers
      3.1.5.1      Monitoring Connect Servers
      3.1.5.2      Checking the Status of the Connect Server
      3.1.5.3      Checking Status of A1M$DIREC_nnn Processes
    3.1.6      Automated Routine Maintenance
      3.1.6.1      Modifying the MUAS$TIDY Batch Job
      3.1.6.2      Disabling the MUAS$TIDY Batch Job

  3.2     Performing Occasional Maintenance Tasks
    3.2.1      Tuning the MailWorks Server
      3.2.1.1      OpenVMS SYSGEN Parameters and Performance
      3.2.1.2      Process Quotas
      3.2.1.3      Network Tuning
      3.2.1.4      Setting a Page File Quota
    3.2.2      Moving Users
    3.2.3      Deleting Users
    3.2.4      Adding Users
    3.2.5      Changing User's Name
    3.2.6      Restoring Profile Attributes
      3.2.6.1      Restoring the DEFAULT Profile Template
      3.2.6.2      Restoring the ALL-IN-1 IOS Profile Template
      3.2.6.3      Restoring the VMSMAIL Profile Template
    3.2.7      Reclaiming Deleted File Space in the User Profile Database
    3.2.8      Changing the Time Offset
    3.2.9      Adding Multiple Servers
      3.2.9.1      Configuring an Additional Server
    3.2.10     Modifying the Local Routing Address
    3.2.11     Tracing Messages Through the Mail System
      3.2.11.1     Transaction Event Logs
    3.2.12     Adding a Local Message Router to an Existing MailWorks System
    3.2.13     Changing the Timeout Value for the Asynchronous Connection Broker
    3.2.14     Starting the Print Server If It Is Not Running
    3.2.15     Using File Type Mode to Reconfigure ALL-IN-1 IOS
    3.2.16     Adding File Converters to MailWorks

  4      Problem Solving

  4.1     Gathering Information About a Problem
    4.1.1      Collecting Process Dumps
      4.1.1.1      Collecting Process Dumps When the MUAS or Connect Server Access Violates
      4.1.1.2      Collecting Process Dumps When the MUAS or Connect Server Hangs
      4.1.1.3      Collecting Process Dumps for a Specific Event in the MUAS or Connect Server
    4.1.2      Collecting Data on the System
    4.1.3      Monitoring Remote Servers
      4.1.3.1      Monitoring DS Server Log Files
      4.1.3.2      Monitoring Print Server Log Files

  4.2     Information Sources for Problem Solving

  4.3     Solving Problems
    4.3.1      DS Server Will Not Start
    4.3.2      MUAS Server Will Not Start
    4.3.3      Troubleshooting the Remote Message Router
    4.3.4      Handling Bad Messages
      4.3.4.1      Handling Undeliverable Messages
      4.3.4.2      Messages That Cause the MUAS Server to Fail
    4.3.5      Messages Backing Up in the Message Router Mailbox
      4.3.5.1      Messages Not Being Fetched
      4.3.5.2      Messages Being Fetched too Slowly
    4.3.6      Several Messages on the Retry Queue
    4.3.7      Messages Below the Urgent Priority Not Being Delivered
    4.3.8      Several Nondelivery Notifications Are Returned
    4.3.9      Mail File Is Locked
    4.3.10     Users Are Unable to Connect to a MUAS Server
    4.3.11     Users Are Unable to Submit Messages to the Mail Server
    4.3.12     Users Have Problems Generating Read Receipts
    4.3.13     Macintosh and MS-Windows Users See Drawer Does Not Exist Error
    4.3.14     Users Are Unable to Access DDS from a Workstation
    4.3.15     New Mail Notification Is Lost Due to PATHWORKS Shutdown
    4.3.16     Poor Performance Caused by Large Messages
    4.3.17     Poor Performance Caused by Large Distribution Lists
    4.3.18     Local Language Problems
    4.3.19     Problems Connecting Through TCP/IP Services
    4.3.20     Problems Associated with WordPerfect File Conversions

  5      Using the X4MANAGER Utility

  5.1     Invoking X4MANAGER

  5.2     X4MANAGER Commands

  5.3     Managing Mail Servers
    5.3.1      Entering the Mail Server Mode
    5.3.2      Selecting MUAS Servers
    5.3.3      Selecting Temporary Servers
    5.3.4      Monitoring Servers
      5.3.4.1      Monitoring Overall MUAS Server Configuration and Operational Status
      5.3.4.2      Monitoring the Status of the Current Server
    5.3.5      Stopping Servers on the Current Node
    5.3.6      Shutting Down Servers
    5.3.7      Restarting Servers
    5.3.8      Starting the Current Server
    5.3.9      Purging the Current Server
    5.3.10     Modifying the Current MUAS Server's Configuration
      5.3.10.1     Changing the Current MUAS Server's Node
      5.3.10.2     Changing the Current Server's Device
    5.3.11     Server Configuration Attributes
      5.3.11.1     Modifying the Common Server Startup File
      5.3.11.2     Creating and Modifying Individual MUAS Server Startup Files
    5.3.12     Resetting MUAS Server Counters and Attributes
    5.3.13     Resetting the Batch Restart Procedure
    5.3.14     Creating a Server
    5.3.15     Deleting a Server
    5.3.16     Viewing MUAS Server Log Files

  5.4     Managing Users and Their Profiles
    5.4.1      Entering the User Mode and Selecting a User
    5.4.2      Registering New Users
    5.4.3      Unregistering Users
    5.4.4      Displaying a List of Registered Users
    5.4.5      Moving a User with SAVE and RESTORE
    5.4.6      Modifying User Profiles
      5.4.6.1      Displaying the Contents of the Current User Profile
      5.4.6.2      Customizing the Current User Profile
      5.4.6.3      Customizing All User Profiles
      5.4.6.4      Copying Profile Attributes from Profile Templates
      5.4.6.5      Saving Changes to the Current User's Profile
      5.4.6.6      Modifying User Profiles for DOS Users

  5.5     Managing Remote Servers
    5.5.1      Entering the Remote Server Mode
    5.5.2      Displaying Server Information
    5.5.3      Starting and Stopping Servers
    5.5.4      Displaying Server Status
    5.5.5      Displaying MailWorks System Configuration Information
      5.5.5.1      Displaying MailWorks System Configuration Attributes
      5.5.5.2      Displaying the Number of Connect Servers Configured
      5.5.5.3      Displaying the Current DS Server Node
      5.5.5.4      Displaying the Number of DS Servers Configured
      5.5.5.5      Displaying the DS Server Time Out Value
      5.5.5.6      Displaying the Exceed Quota Attribute Value
      5.5.5.7      Displaying the Number of Print Servers Configured
      5.5.5.8      Displaying the Registered Nodes
      5.5.5.9      Setting the DS Server Node for DDS Concentrator
      5.5.5.10     Setting the Number of DS Server Connections to Configure
      5.5.5.11     Setting the DS Server Time Out Value
      5.5.5.12     Setting the DS Server Password on the MailWorks Target Node
      5.5.5.13     Enabling or Disabling Exceed Quota
      5.5.5.14     Enabling or Disabling Print Server Logging
      5.5.5.15     Registering a Node Access for DDS Concentrator
      5.5.5.16     Modifying a Registered Node
      5.5.5.17     Unregistering a Node Access to DDS Concentrator
      5.5.5.18     Disabling a Requested Server
      5.5.5.19     Enabling a Requested Server
      5.5.5.20     Viewing Server Log Files

  5.6     Managing Address Templates
    5.6.1      Description of Address Template File
    5.6.2      Entering the Address Template Mode
    5.6.3      Determining Which Language Address Template Files Are Available
    5.6.4      Modifying an Address Template File
      5.6.4.1      Adding Templates to the Template File
      5.6.4.2      Removing Templates from the Template File
    5.6.5      Closing the Address Template File
    5.6.6      Verifying the Address Template File

  5.7     Managing the Registered Editor File
    5.7.1      Entering the Registered Editor Mode
    5.7.2      Opening the Registered Editor File
    5.7.3      Registering Editors and Viewers
      5.7.3.1      Registering DECwindows Editors and Viewers
      5.7.3.2      Registering Character Cell Terminal Editors and Viewers
      5.7.3.3      Registering an Editor or Viewer That Is Commented Out
    5.7.4      Unregistering an Editor
    5.7.5      Closing the Registered Editor File
    5.7.6      Verifying the Registered Editor File

  5.8     Managing Header Templates
    5.8.1      Entering the Header Template Mode
    5.8.2      Determining Which Header Template Files Are Available
    5.8.3      Modifying Header Template Files
      5.8.3.1      Static Text
      5.8.3.2      Replaceable Text
    5.8.4      Closing the Header Template File

  5.9     Managing Profile Templates
    5.9.1      Entering the Profile Template Mode and Selecting a Template
    5.9.2      Displaying the Attribute Values of the Current Template
    5.9.3      Creating Profile Templates
    5.9.4      Modifying Profile Templates
      5.9.4.1      Copying Profile Attributes from Other Templates
      5.9.4.2      Saving Changes to the Current Profile Template
    5.9.5      Deleting Profile Templates
    5.9.6      Displaying a List of Templates

  5.10    Managing the File Types File
    5.10.1     File Types File-Translator Lookup Table
    5.10.2     Conversion Table
    5.10.3     Entering the File Type Mode
    5.10.4     Determining Which File Types Are Available
    5.10.5     Modifying the File Types File
    5.10.6     Updating the File Types File
    5.10.7     Updating the File Types File Template File

  A   MUAS Server Status Attributes and Counters

  A.1     Status Attributes

  A.2     Event Counters

  A.3     Other Counters

  B   Modifiable MUAS Server Attributes

  C   Default Profile Template Attribute Values

  D   Profile Attributes

  D.1     User Attributes

  D.2     Send Attributes

  D.3     Receive Attributes

  D.4     Print Attributes

  D.5     Status Attributes

  E   Contents of Event Log Files

  E.1     Multiline Events

  E.2     Information Common to all Logged Events

  E.3     Terminology

  E.4     Information Codes

  E.5     Submitting Problem Reports

  E.6     Transaction Event Log File
    E.6.1      Example Transaction Event Log File
    E.6.2      Transaction Event Log File Entries

  E.7     Security Event Log File
    E.7.1      Failed Connection
    E.7.2      Profile Created
    E.7.3      Submit File Access Error

  E.8     Error Event Log File
    E.8.1      Server State Transition Events
      E.8.1.1      Example
      E.8.1.2      SSI Activated
      E.8.1.3      MR Connection
    E.8.2      Threshold Events
    E.8.3      Error Events
      E.8.3.1      Message Router Protocol Error
      E.8.3.2      Submission Protocol Error
      E.8.3.3      SSI Protocol Error
      E.8.3.4      File and System Operation Error
      E.8.3.5      Conversion Error
      E.8.3.6      Communications Protocol Error
      E.8.3.7      Internal Error
      E.8.3.8      Configuration Error
      E.8.3.9      Registration Error
      E.8.3.10     SSI Error

  F   X4MANAGER Error Messages

  G   GENI Error Messages

  FIGURES

  1-1        MailWorks Configured on a Single Node with Two Components

  1-2 DEC MAILworks for DOS Configuration

  1-3        MailWorks VAXcluster Configuration with Two Nodes

  1-4        Local DDS Configuration

  1-5        DDS Concentrator Configuration

  1-6        DDS Distributor Configuration

  1-7        Components of MailWorks

  1-8        A System with More than One Mailbox

  TABLES

  5-1        X4MANAGER Mode Commands

  5-2        X4MANAGER Task Commands

  5-3        Mode Prompts

  5-4        Mail Server Mode Commands

  5-5        User Mode Commands

  5-6        Remote Server Mode Commands

  5-7        Addressing Keywords on Mail System Other than a Digital System

  5-8        Address Template Mode Commands

  5-9        Registered Editor Mode Commands

  5-10       Registered Editor File Attributes

  5-11       Header Template Mode Commands

  5-12       Profile Template Mode Commands

  5-13       Translator Lookup Table Items

  5-14       Conversion Table

  5-15       File Type Mode Commands

  C-1        Default Profile Template Values

  E-1        Transaction Event Codes

  E-2        Message Type Codes

  E-3        Generate Event Reason Codes

  E-4        Discard Event Reason Codes

  E-5        Summary of Security Events

  E-6        Failed Connect Reason Codes

  E-7        Summary of State Transition Events

  E-8        Summary of Threshold Events

  E-9        Summary of Error Events

  E-10       Server State Transition Events

  E-11       Message Router Protocol Error Codes

  E-12       Submission Protocol Error Reason Codes

  E-13       Submission Protocol Error - Submission Type Codes

  E-14       SSI Protocol Error Reason Codes

  E-15       File and System Operation Classified Error Codes

  E-16       Conversion Error Codes

  E-17       Communications Error Codes

  E-18       Configuration Error Codes

  E-19       Registration Error Codes

  E-20       SSI Error Codes

  G-1        GENI Error Codes