CONTENTS Title Page Copyright Page Preface 1 Introduction 1.1 Processing Options 1.1.1 2780 and 3780 Processing Options 1.1.2 Protocol Emulator Processing Options 1.2 User Interfaces 1.2.1 User Command Language Interface 1.2.2 Record-Oriented Interface 1.2.3 QIO (Device Driver) Interface 1.3 Online Help 2 User Command Language Interface 2.1 Invoking the Command Language Processor 2.2 Command Language Functions 2.3 Interactive and Shared Operating Modes 2.3.1 Characteristics of Interactive Processing 2.3.2 Characteristics of Shared Processing 2.3.2.1 Command Language Restrictions Under Shared Processing 2.3.2.2 Setting Up a Shared Line 2.3.2.3 Example of Setting Up a Shared Line 2.3.2.4 Processes and Files Created When a Line Is Set to Shared 2.3.2.5 Abnormal Exit Processing for a Shared Line 2.4 Using the Command Language 2.4.1 Error Handling in a Batch Job 2.4.2 Transmitting OpenVMS Standard .OBJ and .EXE Files 3 Command Descriptions 3.1 Rules for Entering Commands 3.2 SEND Command 3.2.1 Handling Bid Contentions 3.3 RECEIVE Command 3.3.1 PRINT and PUNCH Qualifiers 3.3.2 SPOOL Qualifier 3.3.3 Default Receives 3.3.4 RENAME Qualifier 3.4 WAIT Command 3.5 SHOW STATE Command 3.6 SET Command 3.6.1 Format of the Set Command 3.6.2 LINE Modifier 3.6.3 ON and OFF Modifiers 3.6.4 SHARED and INTERACTIVE Modifiers 3.6.4.1 SHARED Qualifiers 3.6.4.2 Entering Commands Interactively Against a Shared Line 3.6.5 HALF_DUPLEX and FULL_DUPLEX Modifiers 3.6.6 2780 and 3780 Modifiers 3.6.6.1 Modifier Combinations 3.6.7 CARDIMAGE and NOCARDIMAGE Modifiers 3.6.8 TRANSLATION and NOTRANSLATION Modifiers 3.6.8.1 Modifier Combinations 3.6.9 TABS and NOTABS Modifiers 3.6.10 NL and NONL Modifiers 3.6.11 COMPRESSION and NOCOMPRESSION Modifiers 3.6.11.1 Modifier Combinations 3.6.12 TRANSPARENCY and NOTRANSPARENCY Modifiers 3.6.12.1 Modifier Combinations 3.6.13 FORMS and NOFORMS Modifiers 3.6.13.1 FORMS descriptors 3.6.13.2 NOFORMS descriptors 3.6.13.3 Modifier Combinations 3.6.14 RECORDSIZE Modifier 3.6.15 END_OF_FILE Modifier 4 Diagnostic Information 4.1 Troubleshooting the Communications Link 4.1.1 Invoking the XJTEST Program 4.1.2 Internal Loop Test 4.1.3 Cable Loop Test 4.1.4 Modem Loop Test 4.1.5 Remote Slave Test 4.1.6 Remote Loop Test 4.1.7 SHOW_ERRORS Command 4.1.8 Test Examples 4.2 Status and Error Counter Descriptions A Record-Oriented Interface A.1 Design Rationale of Record-Oriented Interface A.2 Command Summary A.3 Record-Oriented Interface Operation A.4 Procedure Call Syntax A.4.1 RJE$OPEN A.4.2 RJE$GET_BID A.4.3 RJE$PUT_BID A.4.4 RJE$GET A.4.5 RJE$PUT A.4.6 RJE$CAN A.4.7 RJE$SET_EXP_HAN A.4.8 RJE$CLOSE and RJE$CLOSE2 A.5 RJE Status Codes A.6 Examples of Programs Using the Record-Oriented Interface B DPV11 Driver Interface B.1 DPV11 Device Characteristics B.2 Device Driver Operating Modes B.2.1 BSC Mode B.2.1.1 Example Showing 3780 Processing B.2.1.2 Example Showing 2780 Processing in Nontransparent Mode B.2.1.3 Example Showing 2780 Processing in Transparent Mode B.2.2 Binary Mode B.3 User Interface to the Device Driver B.3.1 Device Driver Function Codes for QIO Requests B.3.1.1 READ Function B.3.1.2 WRITE Function B.3.1.3 SET MODE Function B.3.1.4 SENSE MODE Function B.3.1.5 QIO Status Codes Returned by the Device Driver C 2780/3780 Binary Synchronous Communications Protocol C.1 Control Characters in the 2780/3780 BSC Protocol C.2 Message Block Formats C.3 Interprocessor Communications D Component Description D.1 The Command String Interpreter D.2 The Detached Process D.3 Shared Data Base D.4 Record-blocking Facility D.5 BSC DPV11 Driver D.6 DMB32, DMF32, DSF32, DSH32, DSV11, and DSW21/41/42 Line Interface E Error Messages and Informational Messages F Sample Protocol Emulator Session G Summary of Protocol Emulator Command Language H ASCII/EBCDIC Translation H.1 Character Codes H.2 VAX 2780/3780 Translation Tables H.2.1 Standard Translation Tables H.2.2 Alternative Translation Tables H.2.3 Nonequivalent Translation H.3 Changing Individual Characters H.3.1 Running the Command Procedure EXAMPLES 2-1 Sample Log File for Shared Line 2-2 Sending an Object File 2-3 Receiving an Object File 2-4 Sending an Executable File 2-5 Receiving an Executable File 3-1 Information Returned by the SHOW Command 3-2 SHARED with queue-name 3-3 SHARED without queue-name 4-1 XJTEST "Help" Information 4-2 Example of SHOW_ERRORS Command 4-3 Test with Normal Completion 4-4 Test with Error Completion FIGURES 1-1 Sample VAX 2780/3780 Protocol Emulator Configuration 1-2 Flow of Control Between Protocol Emulator Components 1-3 Data Flow and I/O Processing 4-1 Tests Performed by XJTEST Program B-1 3780 Format B-2 Modified 3780 Format B-3 Nontransparent 2780 Format B-4 Modified Nontransparent 2780 Format B-5 Transparent 2780 Mode B-6 Modified Transparent 2780 Format B-7 SET MODE P1 Quadword B-8 SENSE MODE IOSB Quadword B-9 QIO-IO Status Block D-1 Protocol Emulator Components (DPV11) D-2 Protocol Emulator Components (Port Device Drivers) H-1 Standard ASCII to EBCDIC Translation Table H-2 Standard EBCDIC to ASCII Translation Table H-3 Alternative ASCII to EBCDIC Translation Table H-4 Alternative EBCDIC to ASCII Translation Table TABLES 1-1 Major Features of the Protocol Emulator 2-1 User Command Language Interface 2-2 Device Driver Identifiers 3-1 Changes in Defaults When Using SET command 3-2 Differences Between 2780 and 3780 Message Block Processing 3-3 Types of Files Created by the Protocol Emulator 4-1 Command Qualifiers A-1 Record-Oriented Interface Procedure Calls A-2 RJE$OPEN Flags A-3 RJE$GET Error Flags A-4 RJE$GET Informational Flags A-5 RJE$CAN Informational Flags A-6 RJE$CAN Error Flags A-7 RJE Error Codes A-8 RJE Informational Status Codes A-9 RJE Fatal Status Codes C-1 BSC Control Characters C-2 EBCDIC Codes for BSC Control Characters C-3 Sample Dialog Using BSC Protocol G-1 Protocol Emulator Commands H-1 Nonequivalent ASCII/EBCDIC Translation (Standard Tables) H-2 Nonequivalent ASCII/EBCDIC Translation (Alternative Tables)