CONTENTS Title Page Copyright Page Preface 1 VAXELN Routine Description Conventions 1.1 Routine Description Format and Conventions 1.1.1 Sample Routine Description DO REALTIME 1 1.1.2 Sample Routine Description Explanation 1.2 Language Conventions 1.2.1 Ada Conventions 1.2.1.1 Using the VAXELN_SERVICES Package 1.2.1.2 Using the Dollar Sign Character ( $ ) 1.2.2 C Conventions 1.2.3 Pascal Conventions 1.3 Return Values 1.3.1 Condition Values Returned 1.3.2 Condition Values Signaled 1.4 Routine Argument Data 1.4.1 VAXELN Usage 1.4.2 VAX Data Types 1.4.3 Access Types 1.4.4 Passing Mechanisms 1.5 Notes on the VAX Procedure Calling and Condition Handling Standard 1.5.1 Vector Support 1.5.2 Condition Handling 1.5.3 Debugging 1.5.4 Language Support 1.5.5 Default Output 2 VAXELN Device Driver Routine Summary 3 VAXELN Device Driver Routine Descriptions ADQ INITIALIZE ADQ QUEUE READ ADQ START ADQ TRANSFER DONE ADV INITIALIZE ADV QUEUE READ ADV TRANSFER DONE AXV INITIALIZE AXV READ AXV WRITE DISK READ DISK WRITE DLV INITIALIZE DLV READ BLOCK DLV READ STRING DLV WRITE STRING DRB FINISHED TRANSFER DRB INITIALIZE DRB QUEUE READ DRB QUEUE WRITE DRB READ CTRL DRB WRITE CTRL DRQ3BX INITIALIZE DRQ3BX MAP READ BUFFERS DRQ3BX MAP WRITE BUFFERS DRQ3BX QUEUE READ DRQ3BX QUEUE WRITE DRQ3BX READ FUNCTION DRQ3BX TRANSFER DONE READ DRQ3BX TRANSFER DONE WRITE DRQ3BX UNMAP READ BUFFERS DRQ3BX UNMAP WRITE BUFFERS DRQ3BX WRITE FUNCTION DRV DMA INITIALIZE DRV DMA QUEUE READ DRV DMA QUEUE WRITE DRV DMA READ STATUS DRV DMA TRANSFER DONE DRV DMA WRITE FUNCTION DRV INITIALIZE DRV READ DRV WRITE GP AUXILIARY COMMAND GP CLEAR EVENT GP CONFIGURE GP DEFINE PATH GP GET CONTROL GP GOTO STANDBY GP INITIALIZE GP LOAD PARALLEL POLL GP PARALLEL POLL GP PARALLEL POLL CONFIG GP PASS CONTROL GP RECEIVE CONTROL GP REQUEST SERVICE GP SEND COMMAND GP SENSE MODE GP SERIAL POLL GP SET EVENT GP TRANSFER GP UNIT INIT KWV INITIALIZE KWV READ KWV WRITE SCSI CONNECT DEVICE SCSI DISCONNECT DEVICE SCSI FREE CONFIG DATA SCSI FREE CONTROL PORT SCSI GET CONFIG DATA SCSI GET CONTROL PORTS SCSI ISSUE COMMAND SCSI MAP MESSAGE BUFFER SCSI UNMAP MESSAGE BUFFER TTY ASSERT BREAK TTY CANCEL MODEM EVENTS TTY CANCEL OOB CHARACTERS TTY GET CHARACTERISTICS TTY READ TTY RECEIVE MODEM EVENTS TTY RECEIVE OOB CHARACTER TTY SET CHARACTERISTICS TTY SIGNAL MODEM EVENTS TTY SIGNAL OOB CHARACTERS TTY WRITE A VAXELN Data Types A.1 ab_status_register A.2 adc_entry_list A.3 address A.4 adv_gain_array A.5 auxiliary_command_register A.6 axv_data_array A.7 axv_gain_array A.8 boolean A.9 break_mask A.10 byte_unsigned A.11 char_string A.12 cond_value A.13 context_identifier A.14 data_buffer A.15 descriptor A.16 drv_buffer A.17 drv_dma_csr_register A.18 extended_status A.19 gpib_conf_block A.20 gpib_message A.21 gpib_modifier A.22 gpib_path_desc A.23 gpib_pp_block A.24 gpib_sp_block A.25 gp_int_mask A.26 ioctls A.27 kwv_data_array A.28 large_integer A.29 longword_signed A.30 longword_unsigned A.31 modem_event_information A.32 object_identifier A.33 oob_char_mask A.34 parallel_poll_register A.35 port_identifier A.36 scsi_config_msg A.37 terminal_characteristics A.38 timeval A.39 time_value A.40 varying_char_string A.41 vector_byte_unsigned A.42 word_unsigned TABLES 1-1 Optional Argument Usage 1-2 VAX Data Types Used in VAXELN 1-3 Access Methods 1-4 Passing Mechanisms 2-1 Kernel and Utility Routine Operations 3-1 ADQ32 Clock Modes 3-2 ADQ32 Request Status Values 3-3 ADV11-D Request Status Values 3-4 DRB32 Request Status Values 3-5 DRQ3B Read Request Status Values 3-6 DRQ3B Write Request Status Values 3-7 DRV11-WA Request Status Values 3-8 IEC/IEEE 488 Instrument Bus Auxiliary Commands 3-9 IEC/IEEE 488 Instrument Bus Characteristics 3-10 IEQ11-A/IEU11-A Controller Status Values 3-11 IEC/IEEE 488 Instrument Bus Events 3-12 KWV11-C Clock Modes 3-13 Contents of Configuration Data Message Packet 3-14 Field Definitions for TTY GET CHARACTERISTICS 3-15 Modem State Change Field Definitions 3-16 Field Definitions for TTY SET CHARACTERISTICS