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

CHAPTER
CHAPTER
13
13 .1
13.2
13. 3
13. 4
13.4.1
13.4.2
13. 5
13.5.1
13.5.2
14
14.1
14.1.1
14.1.1.1
14.1.1.2
14 .1. 2
14.1.3
14. 1. 4
14.2
14.3
14.3.1
14.3.2
14.3.3
14.3.4
14.3.5
14.3.6
14.3.6.1
14.3.6.2
14.3.6.3
14.3.6.4
14.3.6.5
14.3.6.6
14.3.6.7
14.3.7
14.3.7.1
14.3.7.2
14.3.7.3
14.3.7.4
14.3.7.5
14.3.7.6
14.3.8
14.3.9
14.3.9.l
14.3.9.2
14.3.10
14.3.10.1
14.3.10.2
14.4
14.4.1
14.4.2
14. 4. 3
CONTENTS (Cont.)
PAPER TAPE READER/PUNCH DRIVERS
INTRODUCTION
GET LON INFORMATION MACRO
QIO MACRO
STATUS RETURNS
Error Conditions
Ready Recovery
PROGRAMMING HINTS
Special Action Resulting from Attach and Detach
Reading Past End-of-Tape
INDUSTRIAL CONTROL LOCAL AND REMOTE SUBSYSTEMS
INTRODUCTION
Hardware Configuration
Address Assignments
Supported I/O Modules
Alternate ICSll Support
Software Support
UDCll Software Compatibility
LON INFORMATION
ASSEMBLY LANGUAGE INTERFACE
General Error Status Returns
A/D Input - Read Multiple A/D Channels
Analog Output
Single-Shot Digital Output - Multi-Point
Bistable Digital Output - Multi-Point
Unsolicited Interrupt Processing
Connect to Digital Interrupts
Disconnect from Digital Interrupts
Connect to Counter Module Interrupts
Set Counter Initial Value
Disconnect from Counter Interrupts
Connect to Terminal Interrupts
Disconnect from Terminal Input
Activating a Task by Unsolicited Interrupts
Link a Task to Digital Interrupts
Link a Task to Counter Interrupts
Link a Task to Terminal Interrupts
Link a Task to Error Interrupts
Read Activating Data
Unlink a Task from Interrupts
Terminal Output
Maintenance Functions
Disable Hardware Error Reporting
Enable Hardware Error Reporting
Special Functions
I/O Rundown
Kill I/O
Page
13-1
13-1
13-1
13-2
13-2
13-4
13-4
13-4
13-4
13-4
14-1
14-1
14-1
14-1
14-2
14-3
14-4
14-6
14-6
14-6
14-10
14-10
14-12
14-13
14-13
14-14
14-16
14-17
14-17
14-18
14-19
14-19
14-20
14-20
14-21
14-22
14-22
14-23
14-24
14-25
14-27
14-28
14-28
14-29
14-29
14-29
14-29
FORTRAN INTERFACE 14-29
Synchronous and Asynchronous Process Control I/O 14-31
Return Status Reporting 14-31
Optional Arguments 14-33
x

14.4.4
14.4.5
14.4.5.l
14.4.5.2
14.4.6
14.4.7
14.4.8
14.4.8.l
14.4.8.2
14.4.9
14.4.10
14.4.11
14.4.11.1
14.4.11.2
14.4.11.3
14.4.11.4
14.4.11.5
14.4.11.6
14.4.11.7
14.4.11.8
14.4.11.9
14.4.11.10
14.4.11.11
14.4.12
14.4.12.l
14.4.12.2
14.4.12.3
14.4.13
14.4.13.1
14.4.13.2
14.5
14.5.1
14.5.2
14.5.3
14.5.4
14.5.5
14.6
14.6.l
14.6.2
14.6.2.1
14.6.2.2
14.6.2.3
14.7
14.7.1
14.7.2
14.7.2.1
14.7.2.2
14.7.2.3
14.7.2.4
14.7.2.5
14.7.2.6
14.7.2.7
APPENDIX A
A.l
CONTENTS (Cont.)
Page
Assigning Default Logical and Physical
Units for ICS/ICR Input and Output 14-34
Analog Input 14-35
Random Channel Sequence 14-36
Sequential Channel Sequence 14-38
Analog Output - Multi-channel 14-40
Digital Output - Bistable Multiple Fields 14-42
Digital Input 14-43
Digital Sense Multiple Fields 14-43
Digital Interrupt Single-Point 14-44
Digital Output Momentary - Multiple Fields 14-45
Remote Terminal Output 14-46
Unsolicited Interrupt Data - Continual Monitoring14-47
Connect a Buffer for Receiving Digital Data 14-48
Reading Digital Interrupt Data 14-49
Disconnect a Buffer from Digital Interrupts 14-52
Connect a Buffer for Receiving Counter Data 14-52
Read Counter Data from the Circular Buffer 14-53
Miscellaneous Counter Routines 14-54
Disconnect a Buffer from Counter Interrupts 14-55
Connect a Circular Buffer to Terminal Interrupts 14-56
Read a Character from the Terminal Buffer 14-57
Disconnect a Circular Buffer from Terminal Input 14-57
Programming Example 14-58
Unsolicited Interrupt Processing - Task
Activation
Link a Task to Interrupts
Read Activation Data
Remove Interrupt Linkage to a Task
Maintenance Functions
Place Selected Unit in Offline Status
Return a Device to Online Status
ERROR DETECTION AND RECOVERY
Serial Line Errors
Power-fail at a Remote Site
Power Recovery at the Processor
Unit in Offline Status
Error Data - ICSR and !CAR Registers
DIRECT ACCESS
Linking a Task to the ICS/ICR Common Block
Accessing the I/O Page
Mapping Table Format
I/O Page Global Definitions
Sample Subroutine
CONVERSION OF EXISTING SOFTWARE
Features
Module Support
!AD-IA A/D Converter and IMX-IA Multiplexer
16-Bit Binary Counter
Bistable Digital Output
Momentary Digital Output
Noninterrupting Digital Input
Analog Output
Interrupting Digital Input
SUMMARY OF IO FUNCTIONS
ANALOG-TO-DIGITAL CONVERTER DRIVERS
xi
14-60
14-60
14-61
14-63
14-64
14-65
14-65
14-65
14-66
14-66
14-67
14-67
14-67
14-69
14-70
14-71
14-71
14-73
14-73
14-74
14-75
14-75
14-75
14-75
14-75
14-76
14-76
14-76
14-76
A-1
A-1

CONTENTS (Cont.)
Page
A.2
CARD READER DRIVER A-1
A.3
CASSETTE DRIVER A-1
A.4
COMMUNICATION DRIVERS {MESSAGE-ORIENTED) A-2
A.5 DECTAPE DRIVER A-2
A.6 DISK DRIVERS A-2
A.7 INDUSTRIAL CONTROL LOCAL AND REMOTE SUBSYSTEMS A-3
A.8 LABORATORY PERIPHERAL SYSTEMS DRIVERS A-4
A.9 LINE PRINTER DRIVER A-4
A.10
MAGNETIC TAPE DRIVERS A-5
A.11
PAPER TAPE READER/PUNCH DRIVERS A-5
A.12
TERMINAL DRIVER A-5
A.13 UNIVERSAL DIGITAL CONTROLLER DRIVER A-6
APPENDIX B
I/O FUNCTION AND STATUS CODES B-1
B.l
I/O STATUS CODES B-1
B.1.1
I/O Status Error Codes B-1
B. l. 2
I/O Status Success Codes B-3
B.2
DIRECTIVE CODES B-3
B.2.1
Directive Error Codes B-3
B.2.2
Directive Success Codes B-3
B.3
I/0 FUNCTION CODES B-3
B.3.1
Standard I/O Function Codes B-4
B.3.2
Specific A/D Converter I/O Function Codes B-4
B.3.3
Specific Card Reader I/O Function Codes B-4
B.3.4
Specific Cassette I/O Function Codes B-4
B.3.5
Specific Communications (Message-Oriented) I/O
Function Codes B-5
B.3.6
Specific DECtape I/O Function Codes B-5
B.3.7
Specific Disk I/O Function Codes {RXOl) B-5
B.3.8
Specific ICS/ICR I/O Function Codes B-5
B.3.9
Specific LPS I/O Function Codes B-7
B.3.10
Specific Magtape I/O Function Codes B-7
B.3.11
Specific Terminal I/O Function Codes B-7
B.3.12
Specific UDC I/O Function Codes B-8
APPENDIX c RSX-llM PROGRAMMING EXAMPLE C-1
APPENDIX D GLOSSARY OF RSX-llM TERMS
D-1
xii

Number
1-1
1-2
5-1
5-2
6-1
14-lA
14-lB
Number
1-1
1-2
2-1
2-2
2-3
2-4
2-5
2-6
2-7
3-1
3-2
3-3
3-4
4-1
4-2
4-3
CONTENTS (Cont.)
FIGURES
Logical Unit Table
1-5
QIO Directive Parameter Block
1-12
Determination of Tape Characteristics for the
TUlO 5-6
Determination of Tape Characteristics for the
TU16 5-6
Structure of Cassette Tape
Mapping Table Format
Mapping Table Entry Format
TABLES
Directive Returns
I/O Status Returns
Standard Terminal Devices
Standard Communication Line Interfaces
Standard and Device-Specific QIO
Functions for Terminals
Terminal Status Returns
Terminal Control Characters
Special Terminal Keys
Vertical Format Control Characters
Standard Disk Devices
Standard QIO Functions for Disks
Device-Specific QIO Functions for
the RXOl Disk Driver
Disk Status Returns
Standard QIO Functions for DECtape
Device-Specific Functions for DECtape
DECtape Status Returns
xiii
6-6
14-72
14-72
Page
1-27
1-28
2-1
2-2
2-4
2-5
2-7
2-8
2-9
3-1
3-4
3-5
3-5
4-2
4-3
4-3

5-1
5-2
5-3
5-4
6-1
6-2
6-3
7-1
7-2
7-3
7-4
8-1
8-2
8-3
8-4
8-5
8-6
9-1
9-2
9-3
9-4
10-1
10-2
10-3
10-4
10-5
10-6
10-7
10-8
CONTENTS (Cont.)
Page
Standard Magtape Devices
Standard QIO Functions for Magtape
5-3
Device-Specific QIO Functions for Magtape
5-4
Magtape Status Returns
5-8
Standard QIO Functions for Cassette
6-2
Device-Specific QIO Functions for Cassette
Cassette Status Returns
6-3
Standard Line Printer Devices
7-1
Standard QIO Functions for Line Printers
7-3
Line Printer Status Returns
7-3
Vertical Format Control Characters
7-5
Standard QIO Functions for the Card Reader
8-2
Device-Specific QIO Function for the Card Reader 8-2
Card Reader Switches and Indicators 8-4
Card Reader Status Returns 8-7
Card Reader Control Characters 8-9
Translation from DEC026 or DEC029 to ASCII 8-9
Message-Oriented Communication Interfaces 9-1
Standard QIO Functions for Communication
Interfaces 9-4
Device-Specific QIO Functions for Communication
Interfaces 9-5
Communication Status Returns 9-7
Standard Analog-to-Digital Converters 10-1
Standard QIO Function for the A/D Converters 10-2
Device-Specific QIO Function for the A/D
Converters 10-2
A/D Conversion Control Word 10-3
Contents of First Word of isb 10-4
FORTRAN Interface Subroutines for the AFCll and
ADOl-D 10-4
A/D Converter Status Returns 10~1
FORTRAN Interface Values 10=8
xiv

il-i
11-2
11-3
11-4
11-5
11-6
11-7
12-1
12-3
12-4
12-5
12-6
12-7
12-8
12-9
12-10
13-1
13-2
14-1
14-2
14-3
14-4
14-5
14-6
14-7
14-8
CONTENTS (Cont.)
Standard QIO Function for the UDCll
Device-Specific QIO Functions for the UDCll
A/D Conversion Control Word
Contents of First Word of isb
FORTRAN Interface Subroutines for the UDCll
UDCll Status Returns
FORTRAN Interface Values
Laboratory Peripheral Systems
Standard QIO Function for the Laboratory
Peripheral Systems
Device-Specific QIO Functions for the
Laborarory Peripheral Systems (Immediate)
Device-Specific QIO Functions for the
Laboratory Peripheral Systems (Synchronous)
Device-Specific QIO Function for the
Laboratory Peripheral Systems (IO.STP}
Contents of First Word of isb
FORTRAN Interface Subroutines for the
Laboratory Peripheral Systems
Laboratory Peripheral Systems Status Returns
Returns to Second Word of I/O Status Block
FORTRAN Interface Values
Standard QIO Functions for the Paper
Tape Reader/Punch
Paper Tape Reader/Punch Status
Returns
ICS/ICR Address Assignments
Summary of ICS/ICR-11 QIO Functions
Sample ICS/ICR Configuration
FORTRAN Interface
Return Status Summary
A/D Conversion Control Word
ICSR Contents
ICAR Contents
xv
Page
11-3
11-4
11-5
11-15
11-15
11-27
11-29
12-1
12-2
12-3
12-4
12=8
12-9
12-10
12-26
12-29
12-31
13-2
13-2
14-1
14-6
14-10
14-30
14-32
14-36
14-67
14-68

PREFACE
0.1 MANUAL OBJECTIVES AND READER ASSUMPTIONS
This manual is designed to provide all information necessary to
interface directly with the I/O device drivers supplied as part of the
RSX-llM system. It is intended for use by experienced RSX-llM
programmers who want to take advantage of the time and/or space
savings which result from direct use of the I/O drivers.
The orientation of this manual is tutorial, but it does not attempt to
introduce the reader to all areas of RSX-llM input/output operations.
Readers are expected to be familiar with the RSX-llM Executive
Reference Manual (DEC-11-0MERA-A-D) and to have some experience with
the Task Buiider and either FORTRAN IV or MACR0-11 assembly language.
Readers should also be familiar with the PDP-11 terminology presented
in the PDP-11 Processor Handbook and the PDP-11 Peripherals Handbook.
Users of RSX-llM who do not require such detailed knowledge of the I/O
drivers can use the device independent services provided by File
Control Services (FCS) as documented in the RSX-11 I/O Operations
Reference Manual {DEC~ll~OMFSA-A-D) .
Other manuals closely allied to the purposes of this document are
described briefly in the RSX-llM/RSX-llS Documentation Directory,
Order No. DEC-11-0MUGA-B-D. The Documentation Directory defines the
intended readership of each manual in the RSX-llM/RSX-llS set and
provides a brief synopsis of each manual's contents.
0.2 STRUCTURE OF THE DOCUMENT
This manual has three basic components:
1. Chapter 1 provides an overview of RSX-llM input/output
operations. It introduces the reader to the use of logical
unit numbers, directive parameter blocks, and macro calls.
It describes all of the I/O functions common to a variety of
devices, and summarizes standard error and status conditions
relating to completion of I/O requests.
2. Chapters 2 through 14 describe the use of all device drivers
supported by RSX-llM. These include the following:
xvii

Chapter
2
3
4
5
6
7
8
9
10
11
12
13
14
Device
Terminals and terminal
communications line interfaces
Disks
DECtape
Magnetic tape
Cassette
Line printer
Card reader
Message-oriented communications
line interfaces
Analog-to-digital converters
Universal digital controller
Laboratory peripheral systems
Paper tape reader/punch
Industrial control local and remote
subsystems
Each of these chapters is structured in similar fashion and focuses on
the following basic elements:
. Description of the device, including information on physical
characteristics such as speed, capacity, access, and usage
. Summary of standard functions supported by the devices and
descriptions of device-specific functions
. Discussion of special characters, carriage control codes, and
functional characteristics, if relevant
. Summary of error and status conditions returned on acceptance
or rejection of I/O requests
. Description of programming hints for users of the device
under RSX-llM
3. Appendixes A through D provide quick reference material on
I/O functions and status codes, a glossary of RSX-llM terms,
and an example of RSX-llM I/O operations. These include the
following:
Appendix
Contents
A Summary
of
I/O
functions
by dev i'ce
B
I/O function and
status
codes
c Programming example
D Glossary of
RSX-llM
terms
xviii

0.3 CONVENTIONS USED IN THIS MANUAL
There are a number of conventions and assumptions used in this manual
to present syntax and program coding examples. These are described in
the following list.
1. Br ac ke ts ( [] }
parameters.
in syntactic models enclose
optional
The following example illustrates this format:
ASTX$S [err]
2. Braces ( { } } in syntactic models indicate that one of the
items must be selected, as in the following:
~DOM ~
CALL) «inm,icont,idata, [idx], [isb], [lun]>
{DOMWJ
3. An ellipsis ( .•. } in a syntactic model or coding example
indicates that parameters have been omitted. As used in this
manual, an ellipsis in a QIO macro call indicates omission of
standard QIO parameters described in section 1.4. This is
illustrated below:
4.
QIO$C IO.RLV, ..• ,<stadd,size>
Consecutive
arguments.
commas in a coding example indicate
The following illustrates this usage:
QIO$C IO.ATT,6,,,,ASTOl
null
5. Commas indicating null trailing optional arguments may be
omitted, as in the following:
QIO$C IO.KIL,9.
6. Certain parameters are required but ignored by RSX-llM; this
is necessary to maintain compatibility with RSX-llD. For
example, in the following, the priority specification (fourth
parameter) is ignored:
QIO$C IO.WLB,8.,EV,,IOSB,ASTX,<IOBUF,NBUF>
7. With the exception of MACR0-11 coding examples, all numbers
in the text of this manual are assumed to be decimal; octal
radix is explicitly declared as in the following:
An illegal logical block number has been specified for
DECtape. The number exceeds 577 (1101 octal}.
In MACR0-11 coding examples, all numbers are assumed to be
octal; decimal radix is explicitly designated by following
the number with a decimal point, as in the following example:
QIO$C IO.RDB,14.,,,IOSB,,<IOBUF,80.>
xix