DEC Token Ring Network Device Driver for VMS Use and Programming

*HyperReader

  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