CONTENTS Title Page Copyright Page Preface 1 The Message Router X.400 Gateway 1.1 Introduction 1.2 The 1984 X.400 Recommendations 1.2.1 X.400 Networks 1.2.2 Naming Subscribers in an X.400 Network 1.2.2.1 Legal O/R Name Forms 1.2.3 X.400 Network Components 1.2.4 X.400 Protocols 1.3 Functional Standards and Conformance 1.4 MRX and MAILbus 1.5 Message Router Mailboxes 1.6 Probe Messages 1.7 MRX Services 2 Managing MRX 2.1 Management Tasks 2.1.1 Planning MRX 2.1.2 Installing MRX 2.1.3 Configuring MRX 2.1.4 Maintaining MRX 2.1.5 Starting and Stopping MRX 2.1.5.1 Starting MRX Automatically 2.1.5.2 Starting MRX Manually 2.1.5.3 Stopping MRX 2.1.6 Monitoring MRX 2.1.7 Tuning MRX 2.1.8 Troubleshooting MRX 2.1.9 Informing Subscribers about MRX 2.2 Management Tools 2.2.1 MRXMAN and Its Commands 2.2.1.1 Running MRXMAN 2.2.1.2 Getting HELP 2.2.1.3 Exiting MRXMAN 2.2.2 MB$CONTROL 2.2.3 Exception Reporting 2.2.3.1 Running the Exception Reporting Routines Interactively 2.2.4 Log File 2.2.5 Trace Facilities 2.2.6 Examining Messages 3 Planning Your MRX Network 3.1 Introduction 3.2 MRX Software Structure 3.3 Installing MRX on Single Nodes 3.4 Installing MRX on a VAXcluster 3.5 MRX and MAILbus 3.5.1 Populating the Directory Service with X.400 Information 3.6 MRX and the X.400 Network 3.6.1 Planning MRX in a Private Domain 3.6.2 Planning MRX in an Administration Domain 3.6.3 Planning MRX in a Multi-vendor Domain 3.7 Relaying Between X.400 and Non-X.400 Mail Systems 3.7.1 Relaying Between X.400 and IBM SNADS 3.7.1.1 The X.400 to IBM SNADS Service 3.7.1.2 The IBM SNADS to X.400 Service 3.7.2 Relaying Between X.400 and IBM PROFS 3.7.2.1 The X.400 to IBM PROFS Service 3.7.2.2 The IBM PROFS to X.400 Service 3.8 Routing Messages Around Networks 3.8.1 Public Networks 3.8.2 Private Networks 3.8.3 MRX Routing Principles 3.8.4 Principles of the MRX Search and Match Algorithm 3.9 Planning Orgunit Routing 3.9.1 Defining a Naming Scheme 3.9.2 MRX Routing Domains 3.9.2.1 Routing Domain Topology 3.9.3 MRX Routing Principles for Orgunit Routing 3.9.4 Setting Up Orgunit Routing 3.9.5 Example 3.10 Message Conversion 3.10.1 Inbound Message Conversion 3.10.2 Outbound Message Conversion 3.10.3 ODA to CDA Conversion 3.10.4 Relay Message Flow 4 Configuring MRX 4.1 Configuration tasks 4.2 Preparing for Configuration 4.3 Running the Configuration Procedure 4.4 Specifying a Console for Operator Messages 4.5 Configuring Control Parameters 4.6 Completing the Configuration 4.6.1 Editing the Start-up File 4.6.2 Running the Configuration Verification Procedure 4.7 Creating an ALL-IN-1 TO: Form for MRX 4.7.1 Defining System-wide Default Values for the ALL-IN-1 TO: Form 4.7.2 Defining Process Default Values for the ALL-IN-1 TO: Form 4.8 Updating the Message Router Directory Service 4.8.1 Subscriber Entries 4.8.1.1 Subscribers Using ALL-IN-1 4.8.1.2 Subscribers Using ALL-IN-1 MAIL 4.8.1.3 Subscribers Using VMSmail Where MRGATE Is Installed 4.8.1.4 Subscribers Using VMSmail Where MRGATE Is Not Installed 4.8.1.5 Subscribers Using IBM PROFS 4.8.1.6 Subscribers Using Mail Systems Based On IBM SNADS 4.8.1.7 Subscribers Using Any Other Mail System 4.8.2 Domain Entries 4.9 Setting up the Local MRX Database 4.10 Setting up the Generic Mailbox 4.11 Example Configurations 4.11.1 Simple X.400 Link Between Two Organizations 4.11.2 Complex Links to Remote Domains 4.11.3 Configuring a Multi-vendor Domain 4.11.4 Configuring X.400 to IBM SNADS Relay 4.11.5 Configuring X.400 to IBM PROFS Relay 5 Maintaining Databases for MRX 5.1 Maintaining the Directory Service 5.1.1 Defining a Domain 5.1.1.1 Example 5.1.2 Defining a Subscriber 5.1.2.1 Examples 5.1.3 Modifying a Domain 5.1.3.1 Selecting the Domain 5.1.3.2 Modifying the Domain Entry 5.1.4 Modifying a Subscriber 5.1.4.1 Selecting the Subscriber 5.1.4.2 Modifying the Subscriber Entry 5.1.5 Deleting a Domain 5.1.5.1 Example 5.1.6 Deleting a Subscriber 5.1.6.1 Example 5.2 Maintaining the MTA Dictionary 5.2.1 Defining an MTA 5.2.1.1 Example 5.2.2 Modifying an MTA 5.2.2.1 Selecting the MTA 5.2.2.2 Modifying the MTA Entry 5.2.3 Deleting an MTA 5.2.3.1 Example 5.3 Maintaining Message Router Mailboxes 5.4 Maintaining the MRX Message Queue 5.5 Using Wild Cards When Deleting Objects 5.6 Character Sets 6 Tuning MRX 6.1 The MRX Control Parameters 6.1.1 SET PARAMETERS and MODIFY PARAMETERS Qualifiers 6.1.2 SET SESSIONS Qualifiers 6.2 Defining O/R Names With Multiple Organizational Units 6.2.1 Example 6.2.2 Recipients' O/R Names 6.2.3 Originators' O/R Names 6.3 Customizing MRX 6.3.1 Process Quotas 6.3.2 Defining Logicals Specific to MRX 7 Monitoring MRX 7.1 Interpreting MRX System Messages 7.2 The MRX Log File 7.2.1 Viewing the Log file 7.2.2 Log File Entry Format 7.2.3 Examples 7.3 Accounting 7.4 Other MRXMAN Commands for Gathering Information 7.4.1 TEST 7.4.2 SHOW DOMAIN 7.4.2.1 Example 7.4.3 SHOW SUBSCRIBER 7.4.3.1 Example 7.4.4 SHOW MTA 7.4.4.1 Example 7.4.5 SHOW MR_MAILBOX 7.4.5.1 Example 7.4.6 SHOW QUEUE 7.4.6.1 Example 7.4.7 SHOW PARAMETERS 7.4.7.1 Example 7.4.8 SHOW SESSIONS 7.4.8.1 Examples 7.4.9 SHOW BUILT_OBJECT 7.4.10 SHOW MODIFIED_OBJECT 8 Managing MRX on a VAXcluster 8.1 Running MRX 8.2 Adding a Subscriber with a Multi-valued MHS Address 8.3 SHOW MRX 9 Exception Reporting and MAPs 9.1 Management Action Procedures 9.1.1 Example Exception Report 9.2 How to Use the MAPs 9.3 MRX MAPs 9.3.1 MAP MRX 1 9.3.2 MAP MRX 2 9.3.3 MAP MRX 3 9.3.4 MAP MRX 4 9.3.5 MAP MRX 5 9.3.6 MAP MRX 6 9.3.7 MAP MRX 7 9.3.8 MAP MRX 8 9.3.9 MAP MRX 9 9.3.10 MAP MRX 10 9.3.11 MAP MRX 11 9.3.12 MAP MRX 12 9.3.13 MAP MRX 13 9.3.14 MAP MRX 14 9.3.15 MAP MRX 15 9.3.16 MAP MRX 16 10 Troubleshooting 10.1 Problems and Tools 10.2 Troubleshooting Technique 10.2.1 Troubleshooting Outbound Message Flow 10.2.2 Troubleshooting Inbound Message Flow 10.3 Tracing a Message 10.4 MRX Troubleshooting 10.4.1 MRX RTS Connection Troubleshooting 10.4.2 OSAK Session Troubleshooting 10.4.3 MRX to Message Router Connection 10.5 MRX Error Messages 10.5.1 Contacting DIGITAL A The MRXMAN Commands A.1 ADD Commands A.1.1 ADD BUILT_OBJECT Command Syntax A.1.2 ADD MODIFIED_OBJECT Command Syntax A.2 BUILD Commands A.2.1 BUILD DOMAIN Command Syntax A.2.2 BUILD MTA Command Syntax A.2.3 BUILD SUBSCRIBER Command Syntax A.3 DELETE Commands A.3.1 DELETE DOMAIN Command Syntax A.3.2 DELETE MR_MAILBOX Command Syntax A.3.3 DELETE MTA Command Syntax A.3.4 DELETE QUEUE Command Syntax A.3.5 DELETE SUBSCRIBER Command Syntax A.4 EXIT Command A.5 HELP Command A.6 MODIFY Commands A.6.1 MODIFY DOMAIN Command Syntax A.6.2 MODIFY MTA Command Syntax A.6.3 MODIFY PARAMETERS Command Syntax A.6.4 MODIFY SUBSCRIBER Command Syntax A.7 RESET Commands A.7.1 RESET BUILT_OBJECT Command Syntax A.7.2 RESET MODIFIED_OBJECT Command Syntax A.8 SELECT Commands A.8.1 SELECT DOMAIN Command Syntax A.8.2 SELECT MTA Command Syntax A.8.3 SELECT SUBSCRIBER Command Syntax A.9 SET Commands A.9.1 SET PARAMETERS Command Syntax A.9.2 SET SESSIONS Command Syntax A.10 SHOW Commands A.10.1 SHOW BUILT_OBJECT Command Syntax A.10.2 SHOW DOMAIN Command Syntax A.10.3 SHOW LOG_MESSAGES Command Syntax A.10.4 SHOW MODIFIED_OBJECT Command Syntax A.10.5 SHOW MRX Command Syntax A.10.6 SHOW MR_MAILBOX Command Syntax A.10.7 SHOW MTA Command Syntax A.10.8 SHOW PARAMETERS Command Syntax A.10.9 SHOW QUEUE Command Syntax A.10.10 SHOW SESSIONS Command Syntax A.10.11 SHOW SUBSCRIBER Command Syntax A.11 SPAWN Command A.12 STOP Command A.13 TEST Command B MRX Messages B.1 Fatal Error Messages B.1.1 RTS Fatal Error Messages B.1.2 PDU Fatal Error Messages B.1.3 Control Fatal Error Messages B.1.4 MRXMAN Fatal Error Messages B.2 Error Messages B.2.1 RTS Error Messages B.2.1.1 RTS Error Action List B.2.2 PDU Error messages B.2.3 Parser Error Messages B.2.3.1 Parser Error Action List B.2.4 Control Error Messages B.2.5 Non-delivery Notification Error Messages B.2.6 Directory Service Error Messages B.2.7 MRXMAN Error Messages B.2.8 MRXMAN Interface Error Messages B.3 Warning Messages B.3.1 RTS Warning Messages B.3.2 PDU Warning Messages B.3.3 MRXMAN Warning Messages B.3.4 MRXMAN Interface Warning Messages B.4 Information Messages B.4.1 RTS Information Messages B.4.2 PDU Information Messages B.4.3 MRXMAN Information Messages C The MRX Implementation of X.400 1984 Recommendations C.1 The X.400 Series of Recommendations C.2 P1 Protocol Support C.2.1 P1 Support and Message Transfer Service Elements C.2.2 Protocol Classifications C.2.3 P1 Envelope Protocol Elements C.2.4 O/R Name Protocol Elements C.3 P3 Protocol Support C.4 RTS Protocol Limitations D The MRX OSI Session Control Program D.1 Running OSAK$TRACE D.2 Displaying Session Counters D.2.1 Example Display E MRX Testbed Utility E.1 Overview E.1.1 Preparing to Use MRXTBED E.1.2 Running MRXTBED E.1.3 Getting HELP E.1.4 Exiting MRXTBED E.1.5 Using a Command Procedure in MRXTBED E.1.6 How MRXTBED Represents Messages E.1.6.1 The X.409 Form of a Message E.1.6.2 The NBS Form of a Message E.2 Displaying Messages E.2.1 Displaying NBS Messages E.2.2 Displaying P1 X.409 Messages E.2.3 Displaying P2 X.409 Messages E.3 Moving Around Message Trees E.4 Displaying the Message Tree Structure E.5 Translating Messages E.5.1 Prerequisites for Translating From X.409 to NBS E.5.2 Prerequisites for Translating From NBS to X.409 E.5.3 Example of Translating a Message E.6 MRXTBED Commands F Country Codes Glossary ACP . . . CENELEC CEPT . . . DOTS DTE . . . Inbound message Interpersonal Messaging Protocol (P2) . . . Message Router Transfer Service Message Router Reverse Lookup . . . MRX local Database MRX session . . . P1 P2 . . . SFD SIG . . . User Agent (CCITT definition) VBN . . . X.121 Address EXAMPLES E-1 X.409 Form of a Message E-2 NBS Form of a Message E-3 Example of Displaying an NBS Message E-4 Example of Displaying a P1 X.409 Message E-5 Example of Displaying a P2 X.409 Message E-6 Example of Moving Around a Message FIGURES 1-1 The Structure of a Message Handling Environment 3-1 The 1984 X.400 Stack 3-2 X.25 over a PSDN 3-3 Internet over a LAN 3-4 Null Internet over a LAN 3-5 Internet over a PSDN 3-6 Single Node MRX Configuration 3-7 MRX and MAILbus 3-8 MAILbus Gateways and the Message Router Directory Service 3-9 Using MRX in a Private Domain to Connect to Other Domains 3-10 A Typical DIGITAL-based Private Domain 3-11 Using MRX in a Private X.400 Network, with No Administration Domains 3-12 Using MRX Within an Administration Domain 3-13 Using MRX in a Multi-vendor Domain 3-14 Relaying Between Gateways in a DIGITAL-based Domain 3-15 Planning Message Interchange Between X.400 and IBM SNADS 3-16 Planning Message Interchange Between X.400 and IBM PROFS 3-17 Multi-national Public Message Handling System 3-18 Multi-national Private Message Handling System 3-19 Example Functional Hierarchy for ACME Shoe Corporation 3-20 Example Geographical Hierarchy for ACME Shoe Corporation 3-21 Recommended Naming Scheme for ACME Shoe Corporation 3-22 Example of Routing Domains for ACME Shoe Corporation 4-1 Simple X.400 Network 4-2 Example Remote Domain Configuration 4-3 Example Multi-vendor Domain Configuration 4-4 X.400 to IBM SNADS Configuration 4-5 X.400 to IBM PROFS Configuration 10-1 The VMS X.400 Message System 10-2 X.400 Problem Areas 10-3 Inbound and Outbound Message Flow TABLES 3-1 Transport Classes 4-1 Types of Operator Terminals 9-1 C-1 Basic Message Transfer Service Elements C-2 Submission and Delivery Service Elements C-3 Conversion Service Elements C-4 Query Service Elements C-5 Status and Inform Service Elements C-6 P1 Protocol Elements C-7 O/R Name Protocol Elements C-8 RTS Protocol Limitations E-1 MRXTBED Keywords E-2 MRXTBED Application Tag Synonyms E-3 MRXTBED Universal Tag Synonyms E-4 The START Command F-1 Country Codes