VMS I/O User's Reference Manual: Part II

*HyperReader

  CONTENTS

  Title Page

  Copyright Page

  Preface

  1      DMC11/DMR11 Interface Driver

  1.1     Supported DMC11 Synchronous Line Interfaces
    1.1.1      DIGITAL Data Communications Message Protocol (DDCMP)

  1.2     Driver Features and Capabilities
    1.2.1      Mailbox Usage
    1.2.2      Quotas
    1.2.3      Power Failure

  1.3     Device Information

  1.4     DMC11 Function Codes
    1.4.1      Read
    1.4.2      Write
    1.4.3      Set Mode
      1.4.3.1      Set Mode and Set Characteristics
      1.4.3.2      Enable Attention AST
      1.4.3.3      Set Mode and Shut Down Unit
      1.4.3.4      Set Mode and Start Unit

  1.5     I/O Status Block

  1.6     Programming Example

  2      DMP11 and DMF32 Interface Drivers

  2.1     Supported Devices

  2.2     Driver Features and Capabilities
    2.2.1      Character-Oriented Protocols and HDLC Bit Stuff Mode
    2.2.2      Quotas
    2.2.3      Power Failure

  2.3     Device Information

  2.4     DMP11 and DMF32 Function Codes
    2.4.1      Read
    2.4.2      Write
    2.4.3      Set Mode and Set Characteristics
      2.4.3.1      Set Controller Mode
      2.4.3.2      Additional Features of the DMF32 Driver
      2.4.3.3      Framing Routine Interface for Character-Oriented Protocols
      2.4.3.4      Use of the DMF32 Driver Transmitter Interface in Character-Oriented Mode
      2.4.3.5      The IO$_CLEAN Function
      2.4.3.6      Set Tributary Mode
      2.4.3.7      Shutdown Controller
      2.4.3.8      Shutdown Tributary
      2.4.3.9      Enable Attention AST
    2.4.4      Sense Mode
      2.4.4.1      Read Internal Counters
    2.4.5      Diagnostic Support
      2.4.5.1      Set Line Unit Modem Status
      2.4.5.2      Read Line Unit Modem Status
      2.4.5.3      Read Device Status Slot

  2.5     I/O Status Block

  2.6     Programming Example

  3      DR11-W and DRV11-WA Interface Driver

  3.1     Supported Devices
    3.1.1      Device Differences
    3.1.2      DRV11-WA Installation
      3.1.2.1      Type of Addressing
      3.1.2.2      Device Address and Interrupt Vector Address Selection
    3.1.3      DR11-W and DRV11-WA Transfer Modes
    3.1.4      DR11-W and DRV11-WA Control and Status Register Functions
    3.1.5      Data Registers
    3.1.6      Error Reporting
    3.1.7      Link Mode of Operation

  3.2     Device Information

  3.3     DR11-W and DRV11-WA Function Codes
    3.3.1      Read
    3.3.2      Write
    3.3.3      Set Mode and Set Characteristics
      3.3.3.1      Set Mode Function Modifiers

  3.4     I/O Status Block

  3.5     Programming Example

  4      DR32 Interface Driver

  4.1     Supported Device
    4.1.1      DR32 Device Interconnect

  4.2     DR32 Features and Capabilities
    4.2.1      Command and Data Chaining
    4.2.2      Far-End DR Device-Initiated Transfers
    4.2.3      Power Failure
    4.2.4      Interrupts

  4.3     Device Information

  4.4     Programming Interface
    4.4.1      DR32-Application Program Interface
    4.4.2      Queue Processing
      4.4.2.1      Initiating Command Sequences
      4.4.2.2      Device-Initiated Command Sequences
    4.4.3      Command Packets
      4.4.3.1      Length of Device Message Field
      4.4.3.2      Length of Log Area Field
      4.4.3.3      Device Control Code Field
      4.4.3.4      Control Select Field
      4.4.3.5      Suppress Length Error Field
      4.4.3.6      Interrupt Control Field
      4.4.3.7      Byte Count Field
      4.4.3.8      Virtual Address of Buffer Field
      4.4.3.9      Residual Memory Byte Count Field
      4.4.3.10     Residual DDI Byte Count Field
      4.4.3.11     DR32 Status Longword (DSL)
      4.4.3.12     Device Message Field
      4.4.3.13     Log Area Field
    4.4.4      DR32 Microcode Loader
    4.4.5      DR32 Function Codes
      4.4.5.1      Load Microcode
      4.4.5.2      Start Data Transfer
    4.4.6      High-Level Language Interface
      4.4.6.1      XF$SETUP
      4.4.6.2      XF$STARTDEV
      4.4.6.3      XF$FREESET
      4.4.6.4      XF$PKTBLD
      4.4.6.5      XF$GETPKT
      4.4.6.6      XF$CLEANUP
    4.4.7      User Program-DR32 Synchronization
      4.4.7.1      Event Flags
      4.4.7.2      AST Routines
      4.4.7.3      Action Routines

  4.5     I/O Status Block

  4.6     Programming Hints
    4.6.1      Command Packet Prefetch
    4.6.2      Action Routines
    4.6.3      Error Checking
    4.6.4      Queue Retry Macro
    4.6.5      Diagnostic Functions
    4.6.6      The NOP Command Packet
    4.6.7      Interrupt Control Field

  4.7     Programming Examples
    4.7.1      DR32 High-Level Language Program
    4.7.2      DR32 Queue I/O Functions Program

  5      Asynchronous DDCMP Interface Driver

  5.1     Supported Devices

  5.2     Driver Features and Capabilities
    5.2.1      Quotas
    5.2.2      Power Failure

  5.3     Device Information

  5.4     Asynchronous DDCMP Function Codes
    5.4.1      Read
    5.4.2      Write
    5.4.3      Set Mode and Set Characteristics
      5.4.3.1      Set Controller Mode
      5.4.3.2      Set Tributary Mode
      5.4.3.3      Shutdown Controller
      5.4.3.4      Shutdown Tributary
      5.4.3.5      Enable Attention AST
    5.4.4      Sense Mode
      5.4.4.1      Read Internal Counters

  5.5     I/O Status Block

  6      Ethernet/802 Device Drivers

  6.1     Ethernet/802 Characteristics
    6.1.1      Driver Initialization and Operation
    6.1.2      Ethernet Addresses
      6.1.2.1      Format of Ethernet Addresses
      6.1.2.2      Ethernet Address Classifications
      6.1.2.3      Selecting an Ethernet Physical Address
      6.1.2.4      DIGITAL Ethernet Physical and Multicast Address Values
    6.1.3      IEEE 802 Support

  6.2     Packet Formats
    6.2.1      Ethernet Packet Format
      6.2.1.1      Ethernet Protocol Types
      6.2.1.2      Ethernet Packet Padding
      6.2.1.3      Protocol Type Sharing
    6.2.2      IEEE 802 Packet Format
      6.2.2.1      Class I Service Packet Format
      6.2.2.2      User-Supplied Service Packet Format
      6.2.2.3      Service Access Point (SAP) Use and Restrictions
    6.2.3      IEEE 802 Extended Packet Format

  6.3     Device Information

  6.4     Ethernet/802 Function Codes
    6.4.1      Read
    6.4.2      Write
    6.4.3      Set Mode and Set Characteristics
      6.4.3.1      Set Controller Mode
      6.4.3.2      Set Mode Parameters for Packet Formats
      6.4.3.3      Set Mode Parameter Validation
      6.4.3.4      Shutdown Controller
      6.4.3.5      Enable Attention AST
    6.4.4      Sense Mode and Sense Characteristics

  6.5     I/O Status Block

  6.6     Application Programming Notes
    6.6.1      Promiscuous Mode
    6.6.2      Ethernet Programming Example
    6.6.3      IEEE 802 Programming Example

  A   I/O Function Codes

  A.1     DMC11/DMR11 Interface Driver

  A.2     DMP11 and DMF32 Interface Drivers

  A.3     DR11-W/DRV11-WA Interface Driver

  A.4     DR32 Interface Driver

  A.5     Asynchronous DDCMP DUP11 Interface Driver

  A.6     Ethernet/802 Device Drivers

  EXAMPLES

  1-1        DMC11/DMR11 Program Example

  2-1        DMP11/DMF32 Program Example

  3-1        DR11-W/DRV11-WA Program Example (XAMESSAGE.MAR)

  4-1        DR32 High-Level Language Program Example

  4-2        DR32 Queue I/O Functions Program Example

  6-1        Ethernet Program Example

  6-2        IEEE 802 Programming Example

  FIGURES

  1-1        Mailbox Message Format

  1-2        DVI$_DEVDEPEND Returns

  1-3        P1 Characteristics Block

  1-4        IOSB Contents

  2-1        Typical DMP11/DMF32 Multipoint Configuration

  2-2        DVI$_DEVDEPEND Returns

  2-3        P1 Characteristics Buffer (Set Controller)

  2-4        P2 Extended Characteristics Buffer (Set Controller)

  2-5        P1 Characteristics Buffer (Set Tributary)

  2-6        P2 Extended Characteristics Buffer (Sense Mode)

  2-7        IOSB Contents

  3-1        Typical DR11-W/DRV11-WA Device Configurations

  3-2        P1 Characteristics Buffer

  3-3        IOSB Contents - Read and Write Functions

  4-1        Basic DR32 Configuration

  4-2        Command Block (Queue Headers)

  4-3        DR32 Command Packet Queue Flow

  4-4        DR32 Command Packet

  4-5        Data Transfer Command Table

  4-6        Action Routine Synchronization

  4-7        I/O Functions IOSB Contents

  5-1        DVI$_DEVDEPEND Returns

  5-2        P2 Characteristics Buffer (Set Controller)

  5-3        P2 Extended Characteristics Buffer (Sensemode)

  5-4        IOSB Contents

  6-1        Typical Ethernet Configuration

  6-2        Ethernet Packet Format

  6-3        Class I Service Packet Format

  6-4        User-Supplied Service Packet Format

  6-5        DSAP and SSAP Format

  6-6        IEEE 802 Extended Packet Format

  6-7        DVI$_DEVDEPEND Returns

  6-8        Read Function P5 Buffer

  6-9        Write Function P5 Buffer

  6-10       P2 Extended Characteristics Buffer

  6-11       Sense Mode P1 Characteristics Buffer

  6-12       Sense Mode P2 Extended Characteristics Buffer

  6-13       IOSB Contents

  TABLES

  1-1        Supported DMC11 Options

  1-2        DMC11/DMR11 Device Characteristics

  1-3        DMC11/DMR11 Unit Characteristics

  1-4        DMC11/DMR11 Unit and Line Status

  1-5        DMC11/DMR11 Error Summary Bits

  2-1        DMP11 and DMF32 Device Characteristics

  2-2        DMP11 and DMF32 Unit Characteristics

  2-3        DMP11 and DMF32 Unit and Line Status

  2-4        Error Summary Bits

  2-5        DMP11 and DMF32 Errors

  2-6        DMP11 and DMF32 I/O Functions

  2-7        DMP11 and DMF32 Characteristics

  2-8        P2 Extended Characteristics Values

  2-9        P2 Extended Characteristics Values (DMF32 Driver)

  2-10       P2 Extended Characteristics Values

  2-11       DDCMP Controller Counter Parameter IDs

  2-12       LAPB Controller Counter Parameter IDs

  2-13       Tributary Counter Parameter IDs

  3-1        Control and Status Register FNCT and STATUS Bits (Link Mode)

  3-2        DR11-W and DRV11-WA Device-Independent Characteristics

  3-3        DR11-W and DRV11-WA Device-Dependent Characteristics

  3-4        DR11-W Function Codes

  3-5        EIR and CSR Bit Assignments

  3-6        XAMESSAGE Program Flow

  4-1        DR32 Device Characteristics

  4-2        Device Control Code Descriptions

  4-3        DR32 Status Longword (DSL) Status Bits

  4-4        VMS Procedures for the DR32

  4-5        Device-Dependent IOSB Returns for I/O Functions

  5-1        Device Characteristics

  5-2        Asynchronous DDCMP Unit and Line Status

  5-3        Error Summary Bits

  5-4        Asynchronous DDCMP Errors

  5-5        Asynchronous DDCMP I/O Functions

  5-6        P2 Characteristics Values (Set Controller)

  5-7        P2 Characteristics Values (Set Tributary)

  5-8        Controller Counter Parameter IDs

  5-9        Tributary Counter Parameter IDs

  6-1        Supported Communication Devices

  6-2        Ethernet Controller Device Characteristics

  6-3        Ethernet Controller Unit and Line Status

  6-4        Error Summary Bits

  6-5        Ethernet/802 I/O Functions

  6-6        P2 Extended Characteristics Values

  6-7        Set Mode Parameters for Packet Formats

  6-8        Rules for Promiscuous Mode Operation