CONTENTS Title Page Copyright Page Preface Part I Introduction 1 Managing the Domain Gateway: An Overview 1.1 Management (Overview) 1.2 Monitoring the Domain Gateway (Overview) 1.3 Securing the Domain Gateway (Overview) 1.4 Managing the Domain Gateway's Performance (Overview) 1.5 Solving Domain Gateway Problems (Overview) Part II Management Activities 2 Monitoring the Domain Gateway 2.1 Using NCL 2.1.1 Invoking NCL (OpenVMS Systems) 2.1.2 Invoking NCL (DEC OSF/1 Systems) 2.1.3 Exiting NCL (OpenVMS Systems) 2.1.4 Exiting NCL (DEC OSF/1 Systems) 2.1.5 Creating Log Files 2.1.6 Managing the Domain Gateway EMA Entities 2.1.7 Specifying NCL Command Components 2.1.8 Specifying NCL Command Verbs 2.1.9 Specifying NCL Entity Names 2.1.10 Specifying NCL Attribute Specifiers 2.1.11 Specifying NCL Command Arguments 2.1.12 Specifying NCL Prepositional Phrases 2.1.13 Entering NCL Commands 2.1.14 Specifying a Gateway by Address 2.1.15 Using Other NCL Facilities 2.1.16 Using NCL Control Commands 2.1.17 Using Snapshot 2.1.18 NCL Command Output 2.1.19 Monitoring Events 2.1.20 Using NCL to Monitor the Domain Gateway 2.2 Using SNAP 2.2.1 Invoking SNAP (OpenVMS Systems) 2.2.2 Invoking SNAP (DEC OSF/1 Systems) 2.2.3 The Main SNAP Screen 2.2.4 Exiting SNAP 2.2.5 Using SNAP Commands 2.2.6 Using SNAP to Monitor the Domain Gateway 2.3 Shutting Down the Domain Gateway 3 Securing the Domain Gateway 3.1 Securing the Gateway Hardware 3.2 Securing the Gateway's Remote Console 3.2.1 Defining a Service Password 3.2.2 Clearing the Service Password 3.3 Securing the Domain Gateway Software on the Load Host 3.4 Securing the Domain Gateway's LUs 3.5 Securing the Domain Gateway Configuration 3.5.1 Securing the NCL and SNAP DECnet Session Control Applications 3.5.2 Securing the NCL and SNAP DECnet IP Services Applications 3.6 Securing the Data Flowing Through the Domain Gateway 3.6.1 Securing the CTF Session Control Applications 3.6.2 Securing the CTF IP Services Applications 4 Solving Domain Gateway Problems 4.1 Checking the System Before Problem Solving 4.2 Using the Problem Solving Procedures 4.3 Obtaining Information and Reporting Problems 4.3.1 Gathering Information 4.3.2 Getting an Up-Line Dump or Crash Dump File 4.4 Using the Common Trace Facility (CTF) on OpenVMS 4.4.1 Invoking CTF 4.4.2 Capturing Trace Data with CTF 4.4.3 Analyzing Trace Data with CTF 4.5 Using the Common Trace Facility (CTF) on DEC OSF/1 4.5.1 Invoking CTF 4.5.2 Capturing Trace Data with CTF 4.5.3 Analyzing Trace Data with CTF Part III Management Tasks 5 Managing the Domain Gateway's DECnet Node and IP Host 5.1 Examining the NCL Commands Generated for the DECnet Node and IP Host 5.2 Configuring the DECnet Node and IP Host with NCL 5.3 Monitoring the DECnet Node and IP Host with NCL 5.4 Monitoring the DECnet Node and IP Host with the SNAP Utility 5.5 Tracing DECnet Node Data and IP Host Data with CTF 6 Managing the Domain Gateway SNA Access Server 6.1 Examining the NCL Commands Generated for the SNA Access Server 6.2 Configuring the SNA Access Server with NCL 6.2.1 The SNA ACCESS SERVER Entity and Its Subentities 6.2.2 Displaying the Characteristics of the SNA ACCESS SERVER Entity and Its Subentities 6.2.3 Modifying the Characteristics of the SNA ACCESS SERVER Entity and Its Subentities 6.2.4 Disabling the SNA Access Server 6.2.5 Enabling the SNA Access Server 6.2.6 Creating New OBJECT Entities 6.2.7 Deleting Existing OBJECT Entities 6.3 Monitoring the SNA Access Server with NCL 6.3.1 Monitoring the SNA ACCESS SERVER Entity 6.3.2 Monitoring OBJECT Entities 6.3.3 Monitoring PORT Entities 6.3.4 Monitoring Events Generated by the SNA Access Server 6.4 Monitoring the SNA Access Server with the SNAP Utility 7 Managing the Domain Gateway-CT Channel Data Link 7.1 Examining the NCL Commands Generated for the Channel Data Link 7.2 Configuring the Channel Data Link with NCL 7.2.1 The CHANNEL Entity and Its Subentities 7.2.2 Displaying the Characteristics of the CHANNEL Entity and Its Subentities 7.2.3 Disabling the Channel Data Link 7.2.4 Modifying the Characteristics of the CHANNEL Entity and Its Subentities 7.2.5 Enabling the Channel Data Link 7.3 Monitoring the Channel Data Link with NCL 7.3.1 Monitoring the CHANNEL Entity 7.3.2 Monitoring the PATH Entity 7.3.3 Monitoring the STATION Entity 7.3.4 Monitoring Events Generated by the Channel Data Link 7.4 Monitoring the Channel Data Link with the SNAP Utility 8 Managing the Domain Gateway-ST SDLC Data Links 8.1 Examining the NCL Commands Generated for the SDLC Links 8.2 Configuring the SDLC Data Links with NCL 8.2.1 The SDLC Entity and Its Subentities 8.2.2 The Modem Connect Entity and Its Subentities 8.2.3 Displaying the Characteristics of the SDLC Entity and Its Subentities 8.2.4 Displaying the Characteristics of the MODEM CONNECT Entity and Its Subentities 8.2.5 Disabling the SDLC Subentities 8.2.6 Disabling a Modem Connect Line 8.2.7 Modifying the Characteristics of the SDLC Entity and Its Subentities 8.2.8 Modifying the Characteristics of the MODEM CONNECT Entity and Its Subentities 8.2.9 Enabling an SDLC Subentity 8.2.10 Enabling a Modem Connect Data Line 8.3 Monitoring the SDLC Data Links with NCL 8.3.1 Monitoring the SDLC Entity 8.3.2 Monitoring the LINK Entity 8.3.3 Monitoring the STATION Entity 8.3.4 Monitoring the PORT Entity 8.4 Monitoring the Modem Connect Data Lines with NCL 8.4.1 Monitoring the MODEM CONNECT Entity 8.4.2 Monitoring the LINE Entity 8.4.3 Monitoring the DATA PORT Entity 8.4.4 Monitoring Events Generated by the SDLC Data Links 8.4.5 Monitoring Events Generated by the Modem Connect Data Lines 8.5 Monitoring the SDLC Links with the SNAP Utility 8.6 Tracing SDLC Data Links with CTF 9 Managing the Domain Gateway Subarea Routing 9.1 Examining the NCL Commands Generated for Subarea Routing 9.2 Configuring Subarea Routing with NCL 9.2.1 Subarea Routing Entities 9.2.2 Displaying the Characteristics of the Route Entities 9.2.3 Disabling Existing Routes 9.2.4 Disabling Switched PUs 9.2.5 Modifying the Characteristics of Route Entities 9.2.6 Enabling Existing Routes 9.2.7 Enabling Switched PUs 9.2.8 Deleting Existing Route Entities 9.2.9 Creating New Route Entities 9.3 Monitoring Subarea Routing with NCL 9.3.1 Monitoring the SNA PU SERVICES Entity 9.3.2 Monitoring the SUBAREA PU Entity 9.3.3 Monitoring the TRANSMISSION GROUP Entity 9.3.4 Monitoring EXPLICIT ROUTE Entities 9.3.5 Monitoring VIRTUAL ROUTE Entities 9.3.6 Monitoring SWITCHED PU Entities 9.3.7 Monitoring Events Generated by the Routing Entities 9.4 Monitoring Subarea Routing with the SNAP Utility 9.5 Tracing Subarea Routing with CTF 9.5.1 Tracing a Transmission Group 9.5.2 Tracing a Virtual Route 10 Managing Domain Gateway SSCP Services 10.1 Examining the NCL Commands Generated for SSCP Services 10.2 Configuring SSCP Services with NCL 10.2.1 The SNA SSCP SERVICES Entity and Its Subentities 10.2.2 Displaying the Characteristics of the LOCAL SSCP Entity 10.2.3 Disabling the Local SSCP 10.2.4 Modifying the Characteristics of the LOCAL SSCP Entity 10.2.5 Enabling the Local SSCP 10.2.6 Deleting a LOCAL SSCP Entity 10.2.7 Creating a LOCAL SSCP Entity 10.2.8 Displaying the Characteristics of REMOTE SSCP Entities 10.2.9 Disabling SSCP-SSCP Sessions 10.2.10 Modifying the Characteristics of REMOTE SSCP Entities 10.2.11 Enabling SSCP-SSCP Sessions 10.2.12 Creating REMOTE SSCP Entities 10.2.13 Deleting REMOTE SSCP Entities 10.3 Monitoring SSCP Services with NCL 10.3.1 Monitoring the SNA SSCP SERVICES Entity 10.3.2 Monitoring the LOCAL SSCP Entity 10.3.3 Monitoring REMOTE SSCP Entities 10.3.4 Monitoring Events Generated by the SNA SSCP Services Entities 10.4 Monitoring the SSCP Services with the SNAP Utility 10.5 Tracing SSCP-SSCP Sessions with CTF 11 Managing Domain Gateway LU Sessions 11.1 Examining the NCL Commands Generated for LU Services 11.2 Configuring LU Services with NCL 11.2.1 LU Services Entities 11.2.2 Displaying the Characteristics of LU Entities 11.2.3 Disabling an LU 11.2.4 Terminating Sessions 11.2.5 Modifying the Characteristics of LU Entities 11.2.6 Enabling an LU 11.2.7 Creating an LU Entity 11.2.8 Deleting an LU Entity 11.2.9 Using Access Names for LU Sessions Initiated in the Non-SNA Network 11.2.10 Defining PU and Session Names for LU Sessions Initiated in the Non-SNA Network 11.2.11 Using REMOTE LU Entities 11.2.12 Defining Logon Modes for Secondary LUs 11.2.13 Securing an LU 11.3 Monitoring LU Services with NCL 11.3.1 Monitoring the SNA LU SERVICES Entity 11.3.2 Monitoring LU Entities 11.3.3 Monitoring SESSION Entities 11.3.4 Monitoring LOGON MODE Entities 11.3.5 Monitoring REMOTE LU Entities 11.3.6 Monitoring Events Generated by LU Services 11.4 Monitoring LU Services with the SNAP Utility 11.5 Tracing LU Services with CTF 11.5.1 Tracing LUs 11.5.2 Tracing Sessions Part IV Appendixes A Problem Solving Procedures A.1 Categorize the Problem A.2 Diagnosing LU-LU Session Activation Problems A.2.1 Problems with VTAM-Initiated Sessions Having a VTAM-Owned Primary LU A.2.2 Problems with VTAM-Initiated Sessions Having a Gateway-Owned Primary LU A.2.3 Problems with Gateway-Initiated Sessions Having a VTAM-Owned Primary LU A.2.4 Problems with Gateway-Initiated Sessions Having a Gateway-Owned Primary LU A.3 Diagnosing DECnet Connectivity Problems A.3.1 Verifying the Ability to Establish a DECnet Session with the Gateway A.3.2 Verifying the Local Operation of the Node Accessing the Gateway A.3.3 Verifying the Operation of the Communications Hardware A.4 Diagnosing the DEC MicroServer Synchronous Lines (Gateway-ST Only) A.4.1 Loopback Points A.4.2 General Test Procedure A.4.2.1 Connecting to the DEC MicroServer A.4.2.2 Stopping the Domain Gateway Software A.4.2.3 Using the TEST DATA_LOOPBACK Command A.4.2.4 Restarting the Domain Gateway Software A.4.3 Test Sequence A.4.3.1 Testing the DEC MicroServer I/O Port A.4.3.2 Testing the Adapter Cable and Modem Cable A.4.3.3 Testing the Local Modem A.4.3.4 Testing the Remote Modem A.4.4 Additional Procedures A.5 Diagnosing SNA Route Activation Problems A.5.1 Diagnosing Gateway-Controlled Route Activation Problems A.5.2 Diagnosing VTAM-Controlled Route Activation Problems A.5.3 Diagnosing Transmission Group Activation Problems A.6 Diagnosing SSCP-SSCP Session Activation Problems A.6.1 Diagnosing Gateway-Initiated SSCP-SSCP Session Activation Problems A.6.2 Diagnosing VTAM-Initiated SSCP-SSCP Session Activation Problems B Sense Codes C SNA Access Server Reason Codes D EBCDIC/DMCS Translation Tables D.1 Macros for Modifying the Translation Tables D.2 Building Translation Tables D.3 Examples E The DEC MicroServer Display Panel E.1 Power-Up Sequence E.1.1 Normal Power-Up Sequence Without Retry E.1.2 Power-Up Sequence Including Retry E.2 Dump Sequence E.2.1 Normal Dump Sequence Without Retry E.2.2 Dump Sequence with Retry E.3 Halt Codes E.4 Error Codes F The DEC MicroServer Remote Console F.1 Command Summary F.2 Connecting to the DEC MicroServer F.3 Disconnecting the Console F.4 Halting the Software F.5 Testing the DEC MicroServer F.5.1 Data Loopback Tests F.5.2 Modem Signal Tests F.5.3 Cable Type Tests F.5.4 Soak Testing the DEC MicroServer F.6 Monitoring the DEC MicroServer Status F.7 Reloading the System F.8 Dumping the Contents of Memory F.9 Console Password F.10 Getting Help G DEC MicroServer Adapter Cable Pin Signals H Logon Modes H.1 DECnet SNA VMS Application Programming Interface (API) H.2 DECnet SNA Data Transfer Facility (DTF) H.3 VAX Message Router/P (MR/P) Gateway H.4 DECnet SNA VMS Remote Job Entry (RJE) H.5 Printer Emulators H.6 Terminal Emulators and 3270 Data Stream Programming Interface H.7 Access Routines Using LU 6.2 Protocols I DEC ChannelServer Diagnostic Software I.1 The MDM Diagnostic Program I.1.1 Loading the MDM Diagnostic Program from an OpenVMS Load Host I.1.2 Loading the MDM Diagnostic Program from a DEC OSF/1 Load Host I.1.3 Using the MDM Diagnostic Program I.2 The DESNX Diagnostic Program I.2.1 Loading the DESNX Diagnostic Program from an OpenVMS Load Host I.2.2 Loading the DESNX Diagnostic Program from a DEC OSF/1 Load Host I.2.3 Using the DESNX Diagnostic Program J Managing the TN3270 Server J.1 Overview J.2 Using the TN3270 Server J.2.1 Starting the TN3270 Server J.2.2 Stopping the TN3270 Server J.3 Restrictions J.4 TN3270 Server Error Messages EXAMPLES 1-1 An NCL Command Example 1-2 An Event Example 5-1 NCL Commands Generated to Create the DECnet Node and IP Host 5-2 NCL Commands Generated to Create the DECnet Node and IP Host (Cont.) 5-3 NCL Commands Generated to Create the DECnet Node and IP Host 5-4 NCL Commands Generated to Enable the DECnet Node 6-1 NCL Commands Generated to Create the SNA Access Server 6-2 NCL Command Generated to Enable the SNA Access Server 7-1 NCL Commands Generated to Create the Channel Data Link 7-2 NCL Commands Generated to Enable the Channel Data Link 8-1 NCL Commands Generated to Create the SDLC Data Links 8-2 NCL Commands Generated to Enable the SDLC Data Links 8-3 CTF ANALYZE Command Output for SDLC Data Link 9-1 NCL Commands Generated to Create Subarea Routing 9-2 NCL Commands Generated to Enable Subarea Routing 9-3 CTF ANALYZE Command Output for Transmission Group 9-4 CTF ANALYZE Command Output for Virtual Route 10-1 NCL Commands Generated to Create SSCP Services 10-2 NCL Commands Generated to Enable SSCP Services 10-3 CTF ANALYZE Command Output for an SSCP 11-1 NCL Commands Generated to Create LU Services 11-2 NCL Command Generated to Enable LU Services 11-3 CTF ANALYZE Command Output for LU 11-4 CTF ANALYZE Command Output for LU Session D-1 A Sample Macro Code Segment D-2 Macros Used by the DECnet SNA 3270 TE for OpenVMS Product FIGURES 1-1 A Sample SNAP Screen 1-2 Securing the Domain Gateway 2-1 The DECnet and TCP/IP Entities of the Domain Gateway 2-2 The SNA Entities of the Domain Gateway-CT 2-3 The SNA Entities of the Domain Gateway-ST 2-4 Main SNAP Screen 2-5 SNAP Help Screen 6-1 The SNA ACCESS SERVER Entity and Its Subentities 6-2 SNAP Main Screen 6-3 SNAP Session Screen 7-1 Channel Data Link Management Entities 7-2 SNAP Main Screen 8-1 SDLC Link Management Entities 8-2 Modem Connect Management Entities 9-1 Subarea Routing Management Entities 9-2 SNAP Route Screen 10-1 SSCP Management Entities 10-2 SNAP CDRM Screen 11-1 LU Services Management Entities 11-2 SNAP LU Screen 11-3 SNAP Session Screen A-1 DECnet Connectivity Tests A-2 Components of a Synchronous Communications Link A-3 Test Procedure for a Synchronous Communications Link E-1 DEC MicroServer Display Panel F-1 Loopback Points for Data Loopback Tests F-2 Loopback Points for the Modem Signal Test J-1 The TN3270 Server TABLES 2-1 NCL Control Commands 2-2 NCL Characteristics 2-3 NCL Features 2-4 SNAP Display Change Commands 2-5 SNAP Screen Navigation Commands 3-1 Security for Domain Gateway Files on OpenVMS Load Hosts 3-2 Security for Domain Gateway Files on DEC OSF/1 Load Hosts 8-1 Modem Connect Line Interchange Circuits A-1 Faults Indicated by Loopback Testing C-1 SNA Access Server Reason Codes D-1 Modifications to Translation Tables E-1 Power-Up Display Values E-2 Dump Display Values E-3 Error Code Values F-1 Summary of Remote Console Commands G-1 V.35 34-Way Square Connector (Male) G-2 V.24/RS-232-D 25-Way D-Type Adapter Cable (Male) G-3 V.24/RS-232-C 25-Way D-Type Adapter (Male and Female) J-1 TN3270 Status Codes