CONTENTS Title Page Copyright Page Preface 1 Introduction to Configuring 1.1 The Components in the DEC/EDI Configuration 1.2 What You Must Do 1.2.1 Preparing to Configure DEC/EDI 1.2.2 Specifying the Services 1.2.3 Setting Up the Translation Service 1.2.4 Setting Up the Mapping Service 1.2.5 Setting Up the Communication Service 1.2.6 Testing the Configuration 1.3 General Principles of the DEC/EDI Management Commands 1.3.1 Options Menus 1.3.2 Moving Between and Within Screens 1.4 Commands Used in This Book 2 Preparing to Configure DEC/EDI 2.1 Starting and Stopping DEC/EDI 2.2 Giving Users Access to DEC/EDI 2.2.1 Administrator Access Rights 2.2.2 Supervisor Access Rights 2.2.3 Assigning Access Rights 3 Registering the DEC/EDI Services 3.1 What You Must Do 3.2 Registering the DEC/EDI Services 3.2.1 Specifying Connection-ids 3.2.2 Connection-ids for VAN Connections 3.3 Registering the Applications 3.4 Registering the Client Nodes 3.5 Defining Logicals in DECEDI$SYLOGICALS.COM 4 Configuring the DEC/EDI V1.3 Support Services 4.1 Introduction 4.2 Configuring V1.3 Applications 4.3 Status Flows and Archiving 4.4 V1.3 Support Services Work File 5 Configuring for Site-to-Site 5.1 Setting Up a Site-to-Site System 5.1.1 Configuring the DEC/EDI V1.3 application sites 5.1.2 Configuring the DEC/EDI V2 clients 5.1.3 Example of a Site-to-Site System 6 Configuring the Translation Service 6.1 What the Translation Service Does 6.2 Summary of What You Must Do 6.3 Defining Trading Partner Profiles 6.4 Defining Document Dictionaries 6.4.1 Digital-supplied Definitions 6.4.2 Modified Definitions 6.4.3 Trading Partner-specific Definitions 6.4.4 Local Definitions 6.5 Multiple Translation Services 6.6 Bypassing the Mapping and Translation Services 6.7 Configuring for Outbound Batching (X12 and EDIFACT only) 6.7.1 The Behaviour of Outbound Batching 6.7.2 Configuration 6.7.2.1 Maximum Mapped Batches 6.7.2.2 Abort Batch Timeout 7 Setting up the EDIFACT/ODETTE Tables 7.1 What You Must Do 7.2 Identifying the Document to Exchange 7.3 Caching Profile and Document Definitions 7.4 Creating a Trading Partner Profile 7.5 Defining Data Labels 7.5.1 Segment Qualifiers 7.5.2 Qualified Pairs 7.5.3 Repeating Elements 7.6 Specifying Validation for Data Labels 7.7 Scheduling the Transmission File Builder 7.8 Changing a Document for All Trading Partners 7.8.1 Changing the Requirement for a Segment 7.8.2 Changing a Subelement Definition 7.9 Changing a Document for a Specific Trading Partner 7.9.1 Deleting a Segment for a Specific Trading Partner 7.9.2 Changing the Trading Partner Code Translation Table 7.9.3 Defining Data Labels for a Specific Trading Partner 7.10 Mapping Screen Fields to External Document Fields 8 Setting up the X12/TDCC Tables 8.1 What You Must Do 8.2 Identifying the Document to Exchange 8.3 Caching Profile and Document Definitions 8.4 Creating a Trading Partner Profile 8.5 Defining the Envelope for an X12 or TDCC Document 8.5.1 Envelopes For TDCC Documents Using GS/GE Segments 8.6 Identifying the Functional Acknowledgement to Send 8.6.1 Functional Acknowledgement Document, 997 8.6.2 Acceptance/Rejection Advice Document, 999 8.7 Defining Data Labels 8.7.1 Segment Qualifiers 8.7.2 Qualified Pairs 8.7.3 Repeating Elements 8.8 Specifying Validation for Data Labels 8.9 Scheduling the Transmission File Builder 8.10 Changing a Document for All Trading Partners 8.10.1 Changing the Requirement for a Segment 8.10.2 Changing an Element 8.11 Changing a Document for a Specific Trading Partner 8.11.1 Deleting a Segment for a Specific Trading Partner 8.11.2 Changing the Trading Partner Code Translation Table 8.11.3 Defining Data Labels for a Specific Trading Partner 8.12 Mapping Screen Fields to External Document Fields 9 Setting up the TRADACOMS Tables 9.1 What You Must Do 9.2 Identifying the Document to Exchange 9.3 Caching Profile and Document Definitions 9.4 Creating a Trading Partner Profile 9.5 Defining Data Labels 9.5.1 Segment Qualifiers 9.5.2 Qualified Pairs 9.5.3 Repeating Elements 9.6 Specifying Validation for Data Labels 9.7 Changing a Document for All Trading Partners 9.7.1 Changing the Requirement for a Segment 9.7.2 Changing a Subelement 9.8 Changing a Document for a Specific Trading Partner 9.8.1 Deleting a Segment for a Specific Trading Partner 9.8.2 Changing the Trading Partner Code Translation Table 9.8.3 Defining Data Labels for a Specific Trading Partner 9.9 Mapping Screen Fields to External Document Fields 10 Configuring the Mapping Service 10.1 What the Mapping Service Does 10.2 Summary of What You Must Do 10.3 Further Features of the Mapping Service 11 Configuring the Communication Service 11.1 What the Communication Service Does 11.2 Summary of What You Must Do 11.3 Defining Gateway Parameters 11.4 Defining a Connection 11.5 Setting Up a Window Schedule 11.6 Shutting Down and Restarting a Gateway 11.7 Enabling and Disabling a Gateway 11.8 Enabling and Disabling a Connection 11.9 Setting Up Special Gateway Functionality 11.9.1 Auto Submit for Non-Job-Oriented Gateways 12 Setting Up the Bisync Gateway 12.1 What You Must Do 12.1.1 Prerequisite Tasks 12.1.2 Adjusting The Bisync Protocol Emulator 12.2 Defining Gateway Parameters 12.3 Defining the Connection 12.4 Defining Window Schedules 12.5 Defining and Scheduling Jobs 12.6 Starting the Bisync Gateway 12.7 Enabling and Disabling the Bisync Gateway 12.8 Enabling a Bisync Connection 12.9 Starting a Connection Manually 12.10 Setting Up a Modem for the Bisync Gateway 12.10.1 Setting Up a DF296 Modem 12.10.1.1 Setting Up the Special RS232 Cable 12.10.2 Setting Up a UDS208B Modem 12.10.3 Setting Up a DF126 Modem 12.11 Setting Up For Specific VANs 12.11.1 Setting Up for EDI * EXPRESS 12.11.2 Setting Up for EDI * NET 12.11.3 Setting Up for ISTEL-EDICT 12.12 Reports and Errors 13 Setting Up the 3780Plus Gateway 13.1 What You Must Do 13.1.1 Prerequisite Tasks 13.2 Editing the 3780Plus Control Files 13.3 Defining Gateway Parameters 13.4 Defining the Connection 13.5 Defining Window Schedules 13.6 Defining and Scheduling Jobs 13.7 Starting the 3780Plus Gateway 13.8 Enabling and Disabling the 3780Plus Gateway 13.9 Enabling a 3780Plus Connection 13.10 Starting a Connection Manually 13.11 Setting Up For Specific VANs 13.11.1 Setting Up for EDI * EXPRESS 13.11.2 Setting Up for EDI * NET 13.12 Log Files and Errors 13.12.1 Example of the Job Log File 13.12.2 Example of the 3780Plus Log File 13.12.3 Example of the Monitor Log File (Extract) 14 Setting Up the X.25 (TRADANET) Gateway 14.1 What You Must Do 14.1.1 Prerequisite Tasks 14.1.2 Summary Checklist for TRADANET 14.2 Defining Gateway Parameters 14.3 Defining the Connection 14.4 Defining Window Schedules 14.5 Defining and Scheduling Jobs 14.6 Defining VAN-specific Options 14.6.1 Establishing and Viewing Relationships 14.6.2 Viewing Mailbox and Postbox Reports 14.6.3 Identifying Documents 14.6.4 Refetching Documents from TRADANET 14.7 Logicals affecting the X.25 Gateway 14.8 Starting the X.25 Gateway 14.9 Enabling and Disabling the X.25 Gateway 14.10 Enabling an X.25 Connection 14.11 Starting a Connection Manually 15 Setting Up the Import/Export Gateway 15.1 What You Must Do 15.2 Defining Gateway Parameters 15.3 Defining the Connection 15.4 Defining Window Schedules 15.5 Defining and Scheduling Jobs 15.6 Creating the Directories Used by the Import/Export Gateway 15.6.1 Setting Directory Protections 15.6.2 Limiting the Versions of Import Files 15.6.3 File Naming Convention 15.7 Starting the Import/Export Gateway 15.8 Enabling and Disabling the Import/Export Gateway 15.9 Enabling an Import/Export Connection 15.10 Starting a Connection Manually 16 Setting Up the OFTP Gateway 16.1 What You Must Do 16.1.1 Prerequisite Tasks 16.2 Defining Gateway Parameters 16.3 Defining the Connection 16.4 Defining Trading Partner-Specific Parameters 16.5 Defining Connection Specific Logical Names 16.5.1 Call User Data 16.5.2 Special Logic Modulo 16.5.3 EERP Sending Priority 16.6 Defining Window Schedules 16.7 Starting the OFTP Gateway 16.8 Enabling and Disabling the OFTP Gateway 16.9 Enabling an OFTP Connection 16.10 Starting a Connection Manually 17 Setting Up the X.400 Gateway 17.1 Prerequisites 17.2 Setting Up Mailboxes 17.3 Setting Up DEC/EDI as an X.400 Subscriber 17.4 Setting Up the Message Router Local Mailbox 17.5 What You Must Do In DEC/EDI 17.5.1 Defining Gateway Parameters 17.5.2 Defining the Connection 17.5.3 Defining Window Schedules 17.5.4 Starting the DEC/EDI X.400 Gateway 17.5.5 Enabling and Disabling the DEC/EDI X.400 Gateway 17.5.6 Enabling and Disabling an X.400 Connection 17.5.7 Starting a Connection Manually 18 Setting Up the Pedi Gateway 18.1 Prerequisites 18.2 Setting Up The Mailbus MTA to Support The DEC/EDI User Agent 18.2.1 Defining the Pedi Gateway as a User Agent 18.2.2 Defining the O/R Address Served by the DEC/EDI User Agent 18.2.3 Defining O/R Addresses for Trading Partners and VANs 18.2.4 Supported Elements of Service 18.3 What You Must Do In DEC/EDI 18.3.1 Defining Gateway Parameters 18.3.2 Defining the Connection 18.3.3 Defining Window Schedules 18.3.4 Starting the DEC/EDI Pedi Gateway 18.3.5 Enabling the DEC/EDI Pedi Gateway 18.3.6 Enabling a Pedi Connection 18.3.7 Starting a Connection Manually 18.4 EDI Notification 18.5 Tips for Testing 18.5.1 Turn on the MTA Message History Logging 18.5.2 Use the Pedi User Agent Debug Logical Names 18.5.3 Decode the ASN.1 Message Content 19 Exchanging Files Outside Normal Schedule 19.1 What You Must Do 19.2 Scheduling a One-time Window 19.3 Starting a Connection Manually on Demand 19.4 Scheduling a Job Exception 19.5 Example of Using One-time Windows and Job Exceptions 20 Testing the Configuration (CVP) 20.1 What the CVP Does 20.2 How the CVP Routes Documents 20.3 Prerequisites for Running the CVP 20.4 How to Run the CVP 20.4.1 Setting Up Definitions for the CVP 20.4.2 Shutting Down and Restarting DEC/EDI 20.4.3 Starting the CVP 20.4.4 Responding to Questions from the CVP 20.4.5 Exporting and Importing the Transmission File 20.4.6 The CVP Report 20.4.7 Tidying Up After Running the CVP 20.5 Examples of Running the CVP 20.5.1 CVP Log 20.5.2 CVP Report 21 Testing the Translation Service 21.1 What You Must Do 21.2 Developing the Applications 21.3 Registering the Gateway and Connection-id 21.4 Registering the Applications 21.5 Creating a Trading Partner Profile and Agreements 21.6 Defining the Connection Characteristics 21.7 Setting Up the Default Import/Export Directories 21.8 Running the Test 21.9 Comparing the Sent and Received Documents 21.10 Modifying DEC/EDI to Exchange Live Documents A Correspondence Between Internal and External Documents A.1 Mapping A.1.1 Direct Mapping A.1.2 Qualifier/Value Pair Mapping A.1.3 Repeated Direct Mapping A.1.4 Repeating Qualifier/Value Pair Mapping A.1.5 Segment Qualifier Mapping A.1.6 Default Values A.2 Group Mapping B Customizing Dictionaries and Messages B.1 Customizing a Template B.2 Customizing Data Labels B.3 Customization Example B.3.1 Changes to Data Element 673 B.3.2 Changes to Data Element 689 B.3.3 Changes to Segment IDs FIGURES 1-1 Client/Server Configuration 2-1 List User Screen 3-1 Maintain Services Screen 3-2 Application Site Details Screen 3-3 Register Node Screen 3-4 Register Client Applications Screen 5-1 Example of a Site-to-Site System 7-1 Trading Partner Details Screen 7-2 Trading Partner Connection Details Screen 7-3 Trading Partner Agreement Details Screen 7-4 Document Details Screen 7-5 Data Labels Screen 7-6 Qualified Subelement Data Label Screen 7-7 Data Validation Screen 7-8 Trading Document Screen 7-9 Document Segments Screen 7-10 Document Segment Screen 7-11 Subelement Dictionary Screen 7-12 Trading Document Screen 7-13 Document Segments Screen 7-14 Code Translation Screen 7-15 Edit Code Translation Screen 8-1 Trading Partner Details Screen 8-2 Trading Partner Connection Details Screen 8-3 Trading Partner Agreement Details Screen 8-4 Document Details Screen 8-5 Envelope Screen 8-6 External Standard Details Screen 8-7 Data Labels Screen 8-8 Qualified Element Data Label Screen 8-9 Data Validation Screen 8-10 Trading Document Screen 8-11 Document Segments Screen 8-12 Document Segment Screen 8-13 Element Dictionary Screen 8-14 Trading Document Screen 8-15 Document Segments Screen 8-16 Code Translation Screen 8-17 Edit Code Translation Screen 9-1 Trading Partner Details Screen 9-2 Trading Partner Connection Details Screen 9-3 Trading Partner Agreement Details Screen 9-4 Document Details Screen 9-5 Data Labels Screen 9-6 Qualified Subelement Data Label Screen 9-7 Data Validation Screen 9-8 Trading Document Screen 9-9 Document Segments Screen 9-10 Document Segment Screen 9-11 Subelement Dictionary Screen 9-12 Trading Document Screen 9-13 Document Segments Screen 9-14 Code Translation Screen 9-15 Edit Code Translation Screen 11-1 X.400 Parameter Details Screen 12-1 Bisync Parameter Details Screen 12-2 Bisync Connection Details Screen 12-3 Window Schedule Details Screen 12-4 Bisync Connection Job Details Screen 12-5 Bisync Gateway Job Schedule Details Screen 12-6 Hardware Configuration for a DF296 Modem 12-7 Wiring Diagram for Special RS232 Cable (DSH32 Port) 12-8 Wiring Diagram for Special RS232 Cable (Non-DSH32 Port) 12-9 Hardware Configuration for a UDS208B Modem 12-10 Hardware Configuration for a DF126 Modem 12-11 Connection Defaults for EDI * EXPRESS 12-12 Connection Defaults for EDI * NET 12-13 Connection Defaults for ISTEL-EDICT 13-1 Single-line 3780Plus Configuration 13-2 Multi-line 3780Plus Configuration 13-3 3780Plus Parameter Details Screen 13-4 3780Plus Connection Details Screen 13-5 Window Schedule Details Screen 13-6 3780Plus Connection Job Details Screen 13-7 3780Plus Gateway Job Schedule Details Screen 13-8 Connection Defaults for EDI * EXPRESS 13-9 Connection Defaults for EDI * NET 14-1 X.25 Parameter Details Screen 14-2 X.25 Connection Details Screen 1 14-3 X.25 Connection Details Screen 2 14-4 Window Scheduling Details Screen 14-5 Connection Job Details Screen 14-6 X.25 Gateway Job Schedule Details Screen 15-1 Import/Export Parameter Details Screen 15-2 Import/Export Connection Details Screen 15-3 DEC/EDI Window Scheduling Details Screen 15-4 Import/Export Gateway Job Schedule Details Screen 16-1 OFTP Parameter Details Screen 16-2 OFTP Connection Details Screen 16-3 Window Scheduling Details Screen 17-1 DEC/EDI and Mailbox Usage 17-2 X.400 Parameter Details Screen 17-3 X.400 Connection Details Screen 17-4 Window Schedule Details Screen 18-1 Summary of Setting Up Pedi Gateway 18-2 Pedi Parameter Details Screens 18-3 Pedi Connection Details Screens 18-4 Window Schedule Details Screen 19-1 Job Exception Details Screen TABLES 2-1 Commands to Control Access to DEC/EDI 3-1 Control Keys for Defining Services 7-1 Fields on the Trading Partner Details Screen 7-2 Fields on the Trading Partner Connection Details Screen 7-3 Fields on the Trading Partner Agreement Details Screens 7-4 Fields on the Document Details Screen 7-5 Fields on the Qualified Subelement Data Label Screen 7-6 Fields on the Data Validation Screen 8-1 Fields on the Trading Partner Details Screen 8-2 Fields on the Trading Partner Connection Details Screen 8-3 Fields on the Trading Partner Agreement Details Screens 8-4 Fields on the Document Details Screen 8-5 Fields on the EDIT ENVELOPE Screen 8-6 Fields on the Qualified Element Data Label Screen 8-7 Fields on the Data Validation Screen 9-1 Fields on the Trading Partner Details Screen 9-2 Fields on the Trading Partner Connection Details Screen 9-3 Fields on the Trading Partner Agreement Details Screens 9-4 Fields on the Document Details Screen 9-5 Fields on the Qualified Subelement Data Label Screen 9-6 Fields on the Data Validation Screen 12-1 Fields on the Bisync Parameter Details Screen 12-2 Fields on the Bisync Connection Details Screen 12-3 Bisync Connection Symbols For The EDI * EXPRESS VAN 12-4 Bisync Connection Symbols For The EDI * NET VAN 12-5 Bisync Connection Symbols For The ISTEL-EDICT VAN 12-6 Scripts for Use With EDI * EXPRESS 12-7 Scripts for Use With EDI * NET 12-8 Scripts for Use With ISTEL-EDICT 13-1 Fields on the 3780Plus Parameter Details Screen 13-2 Fields on the 3780Plus Connection Details Screen 13-3 3780Plus Connection Symbols For The EDI * EXPRESS VAN 13-4 3780Plus Connection Symbols For The EDI * NET VAN 13-5 Scripts for Use With EDI * EXPRESS 13-6 Scripts for Use With EDI * NET 14-1 Fields on the X.25 Parameter Details Screen 14-2 Fields on the X.25 Connection Details Screens 14-3 Fields on the X.25 Job Details Screens 15-1 Fields on the Import/Export Parameter Details Screen 15-2 Fields on the Import/Export Connection Details Screens 16-1 Fields on the OFTP Parameter Details Screen 16-2 Fields on the OFTP Connection Details Screen 16-3 Using The Connection Specific Data Field for OFTP 17-1 MRXMAN Qualifiers and Their Equivalent DEC/EDI Fields 17-2 Gateway Parameters (Mandatory) 17-3 Gateway Parameters (Optional) 17-4 Connection Details - Mandatory Fields 17-5 Connection Details - Optional Fields 18-1 NCL O/R Address Qualifiers and Their Equivalent DEC/EDI Gateway Parameters 18-2 NCL O/R Address Qualifiers and Their Equivalent DEC/EDI Connection Details 18-3 Gateway Parameters 18-4 Connection Details - Mandatory Fields 18-5 Connection Details - Optional Fields 20-1 CVP Connection IDs Based on EDI Standards 20-2 CVP Application IDs Based on EDI Standards