CONTENTS Title Page Copyright Page Preface 1 Introduction 1.1 Controller Board Capabilities 1.2 TRDRIVER Capabilities 1.3 DECnet-VAX Support Limitations 2 Configuring the DEQRA and TRDRIVER as a DECnet Data Link Device 2.1 Preparing for Configuration 2.2 Accessing the DEQRA with NCP 2.3 DEQRA Line Counters 3 Programming the TRDRIVER 3.1 How the TRDRIVER Operates 3.2 Operating Modes 3.2.1 Resetting the DEQRA 3.2.2 Operating in Normal Mode 3.3 Handling Multiple Input/Output Requests 3.4 Logging Errors 3.5 Obtaining Device Information 4 Accessing the TRDRIVER Function Codes 4.1 Read Function Codes and Extensions 4.2 Write Function Codes and Extensions 4.3 Reset Function Code 4.4 Set Mode and Set Characteristics Function Codes 4.5 Sense Mode and Sense Characteristics Function Codes 4.6 I/O Status Block 4.6.1 Status Field 4.6.2 P1 Buffer Count Field and Device-dependent Characteristics Field 5 Transmitting and Receiving Requests with the Alternate I/O Start Interface 5.1 Buffer Format for Transmitting and Receiving Requests 5.2 Set Mode and Set Characteristics Functions 5.3 Specifying the Protocol Type 5.3.1 Acknowledged Write and Flow Control I/O Functions 5.3.2 Transferring Data with Dual Buffers 5.4 Posting Write Operations with the TRANSMIT Function 5.5 Posting Read Operations with the RECEIVE Function 5.6 I/O Status Block Status Fields 6 Problem Solving 6.1 Running the DEQRA Diagnostics 6.1.1 DEQRA$DIAGS Command Options 6.1.2 Lobe Loopback Test 6.1.3 Ring Loopback Test 6.1.4 Error Conditions 6.2 Troubleshooting and Error Recovery 6.2.1 ``No Such Device'' Messages from NCP 6.2.2 ``Invalid Mode'' Messages from NCP 6.2.3 ``Operation failure'' Messages from NCP 6.2.4 Lines Do Not Start Under DECnet A Example Program A.1 Example Test Program Glossary access control field . . . Asynchronous System Trap (AST) auto vector peripheral . . . control/status register (CSR) COST parameter . . . diagnostic tests Digital Command Language (DCL) foreign command . . . extended interface faceplate . . . host computer IEEE . . . I/O status block (IOSB) IP . . . lobe lobe cable . . . Mbytes/s medium access control (MAC) . . . network device driver NMI switch . . . Personal Computing System Architecture (PCSA ~ ) programmable array logic (PAL) devices . . . ring ring segment . . . source routing speed switch (SPSW) . . . substate SYSGEN utility . . . Token Ring RAM test Transmission Control Protocol (TCP) . . . ZMSTR EXAMPLES 6-1 Lobe Loopback Test 6-2 Ring Loopback Test TABLES 2-1 VMS and NCP Device Names 2-2 DEQRA Line Counters 3-1 Contents of Error Log Entry for TRDRIVER 3-2 $GETDVI Item Codes 4-1 QIO Function Codes 4-2 Arguments for Read Function Codes 4-3 Arguments for Write Function Codes 4-4 Arguments for Set Mode and Set Characteristics Function Codes 4-5 Set Mode and Set Characteristics Parameter IDs 4-6 Successful Status Completion Codes 4-7 $QIO Programming Error Codes 4-8 DEQRA Microcode Status Fields 5-1 Protocol Types 5-2 ALTSTART Write Parameters 5-3 COM$POST Fields (WRITE) 5-4 ALTSTART Read Parameters 5-5 COM$POST Fields (READ) 5-6 I/O Completion Status Fields 5-7 DEQRA Microcode Status Fields