Digital Equipment pdp11 RSX-11M User manual

RSX-11M
1/0 Drivers Reference Manual
Order No. DEC-11-0MDRA-B-D

RSX-11M
1/0 Drivers Reference Manual
Order No. DEC-11-0MDRA-B-D
RSX=llM Version 2
digital equipment corporation · maynard. massachusetts

First Printing, November 1974
Revised, September 1975
The information in this document is subject to change without notice
and should not be construed as a commitment by Digital Equipment
Corporation. Digital Equipment Corporation assumes no responsibility
for any errors that may appear in this document.
The software described in this document is furnished under a license
and may only be used or copied in accordance to the terms of such
license.
Digital Equipment Corporation assumes no responsibility for the use
or reliability of its software on equipment that is not supplied by
Digital.
Copyright @ 1974, 1975 by Digital Equipment Corporation
The postage prepaid READER'S COMMENTS form on the last page of this
document requests the user's critical evaluation to assist us in
preparing future documentation.
The following are trademarks of Digital Equipment Corporation:
DIGITAL
DEC
PDP
DECUS
UNIBUS
COMPUTER LABS
COM TEX
DDT
DECCOMM
Contract No.
DECsystem-lo
DECtape
DIBOL
EDU SYSTEM
FLIP CHIP
FOCAL
IND AC
LAB-8
LIMITED RIGHTS LEGEND
MASS BUS
OMNIBUS
OS/8
PHA
RSTS
RSX
TYPESET-8
TYPESET-11
Contractor or Subcontractor: Digital Equipment Corporation
All the material contained herein is considered limited rights data
under such contract.
1/76-15

PREFACE
CHAPTER
CHAPTER
0.1
0.2
0.3
1
1.1
1. 2
1. 3
1. 4
1. 4 .1
1. 4. 2
1. 4. 3
1. 5
1. 5.1
1. 5. 2
1. 5. 3
1.6
1. 7
1. 7 .1
1. 7. 2
1. 7. 3
1. 7. 4
1. 7. 5
L 7e6
1. 7. 7
1. 8
1. 8 .1
1. 8. 2
1. 8. 3
1. 8. 4
1. 8. 5
1. 8. 6
i. 0. 1
1. 9
1.10
1.10 .1
1.10.2
2
2.1
2 .1.1
CONTENTS
MANUAL OBJECTIVES AND READER ASSUMPTIONS
STRUCTURE OF THE DOCUMENT
CONVENTIONS USED IN THIS MANUAL
RSX-llM INPUT/OUTPUT
OVERVIEW OF RSX-llM I/0
PHYSICAL, LOGICAL, AND VIRTUAL I/O
RSX-llM DEVICES
LOGICAL UNITS
Logical Unit Number
Logical Unit Table
Changing LUN Assignments
ISSUING AN I/O REQUEST
QIO Macro Format
Significant Events
System Traps
DIRECTIVE PARAMETER BLOCKS
I/0-RELATED MACROS
The QIO$ Macro: Issuing an I/O Request
The DIR$ Macro: Executing a Directive
The .MCALL Directive: Retrievinq System Macros
The ALUN$ Macro: Assigning a LUN -
The GLUN$ Macro: Retrieving LUN Information
The ASTX$S Macro: Terminating AST Service
The WTSE$ Macro: Waiting for an Event Flag
STANDARD
IO.ATT:
IO.DET:
IO.KIL:
IO.RLB:
IO.RVB:
IO.WLB:
IO.WVB:
I/O FUNCTIONS
Attaching to an I/O Device
Detaching from an I/O Device
Canceling I/O Requests
Reading a Logical Block
Reading a Virtual Block
Writing a Logical Block
Writing a Virtual Block
I/O COMPLETION
RETURN CODES
Directive Conditions
I/O Status Conditions
TERMINAL DRIVER
INTRODUCTION
ASR-33/35 Teletypes
iii
Page
xvii
xvii
xix
1-1
1-1
1-2
1-2
1-4
1-4
1-4
1-5
1-6
1-7
1-10
1-10
1-11
1-12
1-13
1-14
1-14
1-15
1-17
1-19
1-19
1-20
1-21
1-22
1-22
1-22
1-23
1-23
1-23
1-24
1-25
1-26
1-27
2-1
2-1
2-2

CHAPTER
CHAPTER
2 .1. 2
2 .1. 3
2 .1. 4
2 .1. 5
2.1. 6
2.1. 7
2.2
2.3
2.4
2.5
2.5.1
2.5.2
2.6
2.7
2.7.1
2.7.2
2.7.3
2.8
2.8.1
2.8.2
2.8.3
3
3.1
3 .1.1
3.1. 2
3 .1. 3
3 .1. 4
3.1. 5
3.1. 6
3 .1. 7
3.2
3.3
3.3.1
3.3.2
3.4
4
4.1
4.2
4.3
4.3.1
4.3.2
4.4
4.4.1
CONTENTS (Cont.)
KSR-33/35 Teletypes
LA30 DECwriters
LA36 DECwr iter
RT02 Alphanumeric Display Terminal and RT02-C
Badge Reader/Alphanumeric Display Terminal
VT05B Alphanumeric Display Terminal
VT50 Alphanumeric Display Terminal
GET LON INFORMATION MACRO
QIO MACRO
STATUS RETURNS
CONTROL CHARACTERS AND SPECIAL KEYS
Control Characters
Special Keys
VERTICAL FORMAT CONTROL
TERMINAL INTERFACES
DHll Asynchronous Serial Line Multiplexer
DJll Asynchronous Serial Line Multiplexer
DLll Asynchronous Serial Line Interface
PROGRAMMING HINTS
Terminal Line Truncation
ESCape Code Conversion
RT02-C Control Function
DISK DRIVERS
INTRODUCTION
RFll/RSll Fixed-Head Disk
RP04 Pack Disk
RS03 Fixed-Head Disk
RS04 Fixed-Head Disk
RK11/RK05 Cartridge Disk
RP11/RP03 or RP02 Pack Disk
RXll/RXOl Flexible Disk
GET LON INFORMATION MACRO
QIO MACRO
Standard QIO Functions
Device-Specific QIO Functions
STATUS RETURNS
DECTAPE DRIVER
INTRODUCTION
GET LON INFORMATION MACRO
QIO MACRO
Standard QIO Functions
Device-Specific QIO Functions
STATUS RETURNS
DECtape Recovery Procedures
iv
Page
2-2
2-2
2-2
2-2
2-3
2-3
2-3
2-3
2-4
2-7
2-7
2-8
2-9
2-10
2-10
2-10
2-10
2-11
2-11
2-11
2-11
3-1
3-1
3-1
3-2
3-2
3-2
3-2
3-2
3-2
3-3
3-3
3-3
3-4
3-5
4-1
4-1
4-1
4-2
4-2
4-2
4-3
4-5

CHAPTER
CHAPTER
CHAPTER
4.4.2
4.5
4.5.i
4.5.2
4.5.3
4.5.4
5
5.1
5 .1.1
5 .1. 2
5.2
5.3
5.3.l
5.3.2
5.3.2.1
5.3.2.2
5.3.2.3
5.4
5.4.1
5.4.2
5.5
5.5.1
5.5.2
5.5.3
5.5.4
6
6.1
6.2
6.3
6.3.l
6.3.2
6.4
6.4.1
6.5
6.6
6.6.l
6.6.2
6.6.3
6.6.4
6.6.5
6.6.6
7
7.1
7 .1.1
7 .1. 2
CONTENTS (Cont. )
Page
Select Recovery 4-6
PROGRAMMING HINTS 4-6
DECtape Transfers 4-6
Reverse Reading and Writing 4-6
Speed Considerations When Reversing Direction 4-6
Aborting a Task 4-7
MAGNETIC TAPE DRIVERS
INTRODUCTION
TU10/TS03 Magnetic Tape
TU16 Magnetic Tape
GET LON INFORMATION MACRO
QIO MACRO
Standard QIO Functions
Device-Specific QIO Functions
IO.RWD
IO.RWU
IO.SEC
STATUS RETURNS
Select Recovery
Retry Procedures for Reads and Writes
PROGRAMMING HINTS
Block Size
Importance of Resetting Tape Characteristics
Aborting a Task
Writing an Even-Parity Zero
CASSETTE DRIVER
INTRODUCTION
GET LON INFORMATION MACRO
QIO MACRO
Standard QIO Functions
Device-Specific QIO Functions
STATUS RETURNS
Cassette Recovery Procedures
STRUCTURE OF CASSETTE TAPE
PROGRAMMING HINTS
Importance of Rewinding
End-of-File and IO.SPF
The Space Functions, IO.SPB and IO.SPF
Verification of Write Operations
Block Length
Logical End-of-tape
LINE PRINTER DRIVER
INTRODUCTION
LPll Line Printer
LSll Line Printer
v
5-1
5-1
5-1
5-2
5-2
5-2
5-3
5-3
5-4
5-4
5-4
5-8
5-10
5-11
5-11
5-11
5-11
5-11
5-11
6-1
6-1
6-1
6-2
6-2
6-2
6-3
6-5
6-5
6-6
6-7
6-7
6-7
6-7
6-7
6-7
7-1
7-1
7-1
7-2

CHAPTER
CHAPTER
7 .1. 3
7.2
7.3
7.4
7.4.1
7.5
7.6
7.6.l
7.6.2
7.6.3
8
8.1
8.2
8.3
8.3.1
8.3.2
8.4
8.4.1
8.4.2
8.4.3
8.5
8.5.1
8.6
8.6.1
8.6.2
8.7
8.7.1
8.7.2
9
9.1
9 .1.1
9 .1. 2
9 .1. 3
9 .1. 4
9 .1. 5
9.2
9.3
9.3.1
9.3.2
9.3.2.1
9.3.2.2
9.3.2.3
9.3.2.4
9.3.2.5
CONTENTS (Cont.)
LVll Line Printer
GET LUN INFORMATION MACRO
QIO MACRO
STATUS RETURNS
Ready Recovery
VERTICAL FORMAT CONTROL
PROGRAMMING HINTS
RUBOUT Character
Print Line Truncation
Aborting a Task
CARD READER DRIVER
INTRODUCTION
GET LUN INFORMATION MACRO
QIO MACRO
Standard QIO Functions
Device-Specific QIO Function
STATUS RETURNS
Card Input Errors and Recovery
Ready and Card Reader Check Recovery
I/O Status Conditions
FUNCTIONAL CAPABILITIES
Control Characters
CARD READER DATA FORMATS
Alphanumeric Format (026 and 029)
Binary Format
PROGRAMMING HINTS
Input Card Limitation
Aborting a Task
MESSAGE-ORIENTED COMMUNICATION DRIVERS
INTRODUCTION
DAll-B Parallel Interprocessor Link
DLll-E Asynchronous Line Interface
DPll Synchronous Line Interface
DQll Synchronous Line Interface
DUll Synchronous Line Interface
GET LUN INFORMATION MACRO
QIO MACRO
Standard QIO Functions
Device-Specific QIO Functions
IO.FDX
IO.HDX
IO.INL and IO.TRM
IO.RNS
IO.RWD
vi
Page
7-2
7-2
7-2
7-3
7-4
7-5
7-5
7-6
7-6
7-6
8-1
8-1
8-1
8-2
8-2
8-2
8-3
8-3
8-6
8-7
8-8
8-8
8-9
8-9
8-10
8-10
8-10
8-11
9-1
9-1
9-2
9-2
9-2
9-3
9-3
9-3
9-4
9-4
9-5
9-5
9-5
9-5
9-6
9-6

CHAPTER
CHAPTER
9 3.2.6
9.3.2.7
9.4
9.5
9.5.1
9.5.2
9.5.3
9.5.4
9.5.5
9.5.6
9.6
10
10.1
10.1.1
10.1.2
10.2
10.3
10.3.1
10.3.2
10.4
10.4.1
10.4.2
10.4.3
10.4.4
10.4.5
10.4.6
10.4.7
10.5
10.5.l
10.6
10.6.l
10.7
10.7.1
10.7.2
10.7.3
10.7.4
11
11.1
11.1.1
11.1. 2
11.1.2.1
11.1. 2. 2
11. 2
11. 3
CONTENTS (Cont.)
IO. SYN
IO.WNS
STATUS RETURNS
PROGRAMMING HINTS
Transmission Validation
Redundancy Checking
Half-Duplex and Full-Duplex Considerations
Low-Traffic Sync Character Considerations
Vertical Parity Support
Importance of IO.INL
PROGRAMMING EXAMPLE
ANALOG-TO-DIGITAL CONVERTER DRIVERS
INTRODUCTION
AFCll Analog-to-Digital Converter
ADOl-D Analog-to-Digital Converter
GET LUN INFORMATION MACRO
QIO MACRO
Standard QIO Function
Device-Specific QIO Function
Page
9-6
9-6
9-7
9-8
9-9
9-9
9-9
9-9
9-10
9-10
9-10
10-1
10-1
10-1
10-1
10-2
10-2
10-2
10-2
FORTRAN INTERFACE
Synchronous and Asynchronous
The isb Status Array
FORTRAN Subroutine Summary
10-3
Process Control I/O 10-3
10-3
10-4
AIRD/AIRDW: Performing Input of Analog Data
in Random Sequence
AISQ/AISQW: Reading Sequential Analog Input
Channels
ASADLN: Assigning a LUN to the ADOl-D
ASAFLN: Assigning a LUN to the AFCll
STATUS RETURNS
FORTRAN Interface Values
FUNCTIONAL CAPABILITIES
Control and Data Buffers
PROGRAMMING HINTS
Use of A/D Gain Ranges
Identical Channel Numbers on the AFCll
AFCll Sampling Rate
Restricting the Number of ADOl-D Conversions
UNIVERSAL DIGITAL CONTROLLER DRIVER
INTRODUCTION
Creating the UDCll Driver
Accessing UDCll Modules
Driver Services
Direct Access
GET LUN INFORMATION MACRO
QIO MACRO
vii
10-5
10-6
10-6
10-7
10-8
10-9
10-9
10-9
10-9
10-9
10-9
10-10
11-1
11-1
11-1
11-2
11-2
11-3
11-3
11-3

11.3.1
11. 3. 2
11.3.2.1
11.3.2.2
11.3.2.3
11.3.2.4
11.3.2.5
11. 4
11.4.1
11.4.1.1
11.4.1.2
11. 4. 2
11. 4. 3
11.4.3.l
11.4.3.2
11.4.3.3
11. 5
11. 5 .1
11. 5. 2
11. 5. 3
11. 5. 4
11. 5. 5
11.5.6
11. 5. 7
11. 5. 8
11. 5. 9
11.5.10
11. 5 .11
11.5.12
11.5.13
11.5.14
11.5.15
11.5.16
11.5.17
11.5.18
11.5.19
11.5.20
11.5.21
11. 6
11. 6. 1
11. 7
11. 7 .1
11. 7. 2
11. 7. 3
CONTENT s (Cont . )
Standard QIO Function
Device-Specific QIO Functions
Contact Interrupt Digital Input
(W733 Modules)
Timer (W734 I/O Counter Modules)
Latching Digital Output (M685, M803,
and M805 Modules)
Analog-to-Digital Converter (ADUOl Module)
ICSll Analog-to-Digital Converter
(!AD-IA Module)
DIRECT ACCESS
Defining the UDCll Configuration
Assembly Procedure for UDCOM.MAC
Symbols Defined by UDCOM.MAC
Including UDCll Symbolic Definitions in
the System Object Module Library
Referencing the UDCll through a Common Block
Creating a Global Common Block
Making the Common Block Resident
Linking a Task to the UDCll Common Block
Page
11-3
11-3
11-5
11-7
11-7
11-7
11-8
11-8
11-9
11-9
11-10
11-11
11-11
11-12
11-13
11-13
FORTRAN INTERFACE
Synchronous and Asynchronous
The isb Status Array
FORTRAN Subroutine Summary
11-14
Process Control I/O 11-14
11-14
11-15
AIRD/AIRDW: Performing Input of Analog
Data in Random Sequence
AISQ/AISQW: Reading Sequential Analog
Input Channels
AO/AOW: Performing Analog Output
ASUDLN: Assigning a LUN to UDO:
CTDI: Connecting to Contact Interrupts
CTTI: Connecting to Timer Interrupts
DFDI: Disconnecting from Contact Interrupts
DFTI: Disconnecting from Timer Interrupts
DI/DIW: Reading Several Contact Sense
Fields
DOL/DOLW: Latching or Unlatching Several
Fields
DOM/DOMW: Pulsing Several Fields
RCIPT: Reading a Contact Interrupt Point
RDCS: Reading Contact Interrupt
Change-of-State Data from a Circular Buffer
RODI: Reading Contact Interrupt Data
From a Circular Buffer
RDTI: Reading Timer Interrupt Data From
a Circular Buffer
RDWD: Reading a Full Word of Contact
Interrupt Data from the Circular Buffer
RSTI: Reading a Timer Module
SCTI: Initializing a Timer Module
STATUS RETURNS
FORTRAN Interface Values
PROGRAMMING HINTS
Checkpointable Tasks
Numbering Conventions
Processing Circular Buffer Entries
viii
11-17
11-17
11-18
11-18
11-19
11-19
11-20
11-21
11-21
11-21
11-22
11-22
11-23
11-24
11-25
11-26
11-26
11-26
11-27
11-29
11-29
11-29
11-30
11-30

CHAPTER
12
12.1
12.l.l
12.1.2
12.2
12.3
12.3.l
12.3.2
12.3.2.l
12.3.2.2
12.3.2.3
12.3.2.4
12.3.3
12.3.3.2
12.3.3.3
12.3.3.4
12.3.3.5
12.3.4
12.3.4.l
12.4
12.4.l
12.4.2
12.4.3
12.4.4
12.4.5
12.4.6
12.4.7
12.4.8
12.4.9
12.4.10
12.4.11
12.4.12
12.4.13
12.4.14
12.4.15
12.4.16
12.4.17
12.4.18
12.4.19
12.4.20
12.5
12.5.l
12.5.2
12.5.3
12.5.4
12.6
12.6.1
12.6.2
12.6.3
12.6.4
CONTENTS (Cont. )
LABORATORY PERIPHERAL SYSTEMS DRIVERS
INTRODUCTION
ARll Laboratory Peripheral System
LPSll Laboratory Peripheral System
GET LUN INFORMATION MACRO
QIO MACRO
Standard QIO Function
Device-Specific QIO Functions (Immediate)
IO.LED
IO.REL
IO.SDI
IO. SDO
Device-Specific QIO Functions (Synchronous)
IO.ADS
IO. HIS
IO.MDA
IO.MDI
IO.MOO
Device-Specific QIO Function (IO.STP)
IO.STP
FORTRAN INTERFACE
The isb Status Array
Synchronous Subroutines
FORTRAN Subroutine Summary
ADC: Reading a Single A/D Channel
ADJLPS: Adjusting Buffer Pointers
ASLSLN: Assigning a LUN to LSO:
ASARLN: Assigning a LUN to ARO:
CVSWG: Converting a Switch Gain A/D Value to
Floating-Point
DRS: Initiating Synchronous Digital Input
Sampling
HIST: Initiating Histogram Sampling
IDIR: Reading Digital Input
IDOR: Writing Digital Output
IRDB: Reading Data from an Input Buffer
L~D: Displaying in LED Lights
LPSTP: Stopping an In-Progress Synchronous
Fune tion
PUTD: Putting a Data Item into an Output Buffer
RELAY: Latching an Output Relay
RTS: Initiating Synchronous A/D Sampling
SDAC: Initiating Synchronous D/A Output
SDO: Initiating Synchronous Digital Output
STATUS RETURNS
IE.RSU: Resource in Use
Second I/O Status Word
IO.ADS and ADC Errors
FORTRAN Interface Values
PROGRAMMING HINTS
The LPSll Clock and Sampling Rates
Importance of the I/O Status Block
Buffer Management
Use of ADJLPS for Input and Output
ix
Page
12-1
12-1
12-2
12-2
12-2
12-2
12-2
12-3
12-3
12-4
12-4
12-4
12-4
12-5
12-6
12-7
12-7
12-7
12-8
12-8
12-8
12-8
12-9
12-lC
12-lJ
12-1~
12-1~
12-13
12-13
12-14
12-lE
12-18
12-18
12-19
12-19
12-20
12-20
12-20
12-21
12-23
12-24
12-26
12-28
12-29
12-30
12-30
12-31
12-31
12-32
12-32
12-33