HP DVR23 User's Manual
Contents
1. 75 attempts have been made Equipment Not Ready The tape unit will stop if a write is made and no write ring is provided or if a tape motion request is made when the tape unit is offline The operating system prints I O ERR NR EQT n where n isthe Equipment Table EQT entry number Attempted Write at End of Tape EOT The drive will allow one additional forward motion request made after an EOT condition is encountered There are only two legal forward motion requests after EOT a Write end of file EOF mark b Read record A second forward motion request after EOT is sensed will put the magnetic tape unit down This is to ensure that the user rewinds the magnetic tape inserts a new reel and ups the unit Backward motion requests rewind and backspace record and backspace file will reinstate the EOT situation to the way it was upon first encountering EOT 2 6 Application Information Limited Length Records The minimum record length is one word The maximum record length is dependent on DMA operation and available memory Only the length specified in the request will actually be transmitted from or to the user buffer Note that due to hardware limitations of the controller DVR23 cannot write odd byte length records Dynamic Status The dynamic status request has been provided so that the actual status of the tape unit can be determined Because this type of status request goes all the way to the driver for it2. G HEWLETT PACKARD RTE Driver DVR23 for HP 7970 Series Digital Magnetic Tape Units Reference Manual Software Technology Division 11000 Wolfe Road Cupertino CA 95014 9804 Manual Part No 92202 93001 Printed in U S A June 1993 E0693 Sixth Edition NOTICE The information contained in this document is subject to change without notice HEWLETT PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THE MATERIAL INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE Hewlett Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing performance or use of this material Hewlett Packard assumes no responsibility for the use or reliability of its software on equipment that is not furnished by Hewlett P ackard This document contains proprietary information which is protected by copyright All rights are reserved No part of this document may be photocopied reproduced or translated to another language without the prior written consent of Hewlett P ackard Company RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the Government is subject to restrictions as set forth in subparagraph c 1 ii of the Rights in Technical Data and Computer Software clause at DFARs 252 227 7013 Copyright O 1979 1981 1984 1993 by Hewlett Packard Company Printing History The Printing History below ident
3. last read write operation I O request rejected a Tape motion required but tape is at load point b Backward tape motion required but tape is at load point c Write Request was given but reel does not have a Write enable ring Reel does not have a Write enable ring Parity and or timing error Tape unit not online this bit can be ignored by the user Table 2 5 Status Return Information ISTA2 Contents CAD Te Te nn an if DMA is required if automatic output buffering is used 1 if driver is to process timeout D B P if driver is to process powerfail S T 1 if device timed out system sets to zero before each I O request Unit Last subchannel addressed Channel 1 O select code for device lower number if a multi board interface Application Information 2 5 Error Recover Procedures Read Parity Error The driver will re read a given record up to ten times before declaring the parity error to be irrecoverable After the tenth attempt the last try will be transmitted to the user buffer and nominal return taken The status will indicate the parity error the user must check for this condition The operating system prints I O ERR PE EQT n where n isthe Equipment Table EQT entry number Write Parity Error The driver will continue to retry writing a given record until one of three conditions is met a The record is successfully written b The end of tape EOT is encountered c
4. able 2 4 B Transmission Log The positive number of word or characters transmitted on all reads and unbuffered writes Units will be words if IBUFL is positive and characters if IBUFL is negative FORTRAN CALL EXEC ICODE ICNWD IBUFR IBUFL 2 2 Application Information Table 2 2 HP 7970 Control Request Calls DVR23 Assembly EXT EXEC Function code 3 Control request Control word JSB EXEC Bits 0 5 LU number of tape unit DEF 3 Bits 6 9 Function code DEF ICODE 01 Write End of File DEF ICNWD 02 Backspace 1 record lt return point gt 03 Forward 1 record 04 Rewind 05 Rewind Standby 06 Dynamic Status 12 Erase 4 inches of tape 13 Forward file 14 Backspace file Motion requests codes 02 thru 04 and 12 thru 14 set the transmission log to zero When a rewind is requested control is returned to the caller after a rewind is indicated before rewind is completed Dynamic Status request 06 is never buffered by the system Therefore the status returned by this call is always a post operation status Bit 10 Transparency bit 1 transparent request 0 non transparent request When the transparent bit is not set the tape LU will be placed down if more than two forward motion requests are attempted at or beyond the EOT marker When the transparent bit is set there are no restrictions on the number of forward motion requests processed at or beyond the EOT marker CAUTION When the transpar
5. ansfer control signals required for generating IBM compatible nine track formats The multi speed capability of the interface kit permits interfacing with tape units operating at 12 5 37 5 or 45 inches per second with a packing density of 800 or 1600 characters per inch Commonly controlled paralleled tape units must be at the same tape speeds The interface kit requires two computer I O addresses a command channel address and a data channel address The data channel is assigned the higher priority I O address DMA is required for all tape speed configurations Operating Environment The operating environment for this software must be an HP 21xx Series Computer an RTE Operating System and interface kit hardware Refer to one of the following manuals for interface kit hardware details e HP 13181A Digital Magnetic Tape Unit Interface Kit Operating and Service Manual part number 13181 90901 e HP 13183A Digital Magnetic Tape Unit Interface Kit Operating and Service Manual part number 13183 90000 General Information 1 1 Application Information General This chapter details the calls to the driver Before writing programs using the driver it is recommended that you consult Chapter 3 of the interface kit operating and service manual That chapter provides instructions on how to operate the tape unit including a description of controller commands status information and typical Assembly language operating programs Calling Seque
6. ent bit is set it is the responsibility of the user program to check and handle the EOT condition If the user program does not check for EOT tape run off can occur All other bits are set to zero 0 On Return A Status see Table 2 4 For a buffered device the status is not affected but retains the same value as before the request was made No meaning FORTRAN CALL EXEC 3 ICNWD Application Information 2 3 Table 2 3 HP 7970 Status Request Call DVR23 Assembly EXT EXEC JSB EXEC DEF 4 or 5 DEF ICODE DEF ICNWD DEF ISTA1 DEF ISTA2 optional lt return point gt FORTRAN where ICODE Function code 13 Status request ICNWD Control word Bits 0 5 LU number of tape unit All Other Bits not used Word 5 of Equipment Table EQT Tape Unit Status flags See Table 2 4 for format Word 4 of EQT See Table 2 5 for format CALL EXEC 13 ICNWD ISTA1 ISTA2 optional 2 4 Application Information Table 2 4 Status Return Information ISTA1 14 and 15 Tape unit availability code 0 Unit available for use not busy 1 Unit disabled 2 Unit currently in operation busy 3 Unit waiting for an available DMA channel Equipment code Always 23 octal 10 Status flags Meaning when on 1 on O off Bit Status 7 End of file record encountered when reading forward spacing or backward spacing Start of tape marker sensed End of tape marker sensed Timing error on
7. ered bit in their EXEC calls for large record transfers to eliminate this condition T is the timeout value in units of tens of milliseconds Note that the D bit is not required since DVR23 will allocate a DCPC channel automatically when needed Configuration Information 3 1 b A Device Reference Table DRT entry for each HP 13181A or HP 13183A Interface card DEVICE REFERENCE TABLE EQT n m where n is the logical unit number assigned to the tape drive Response m is the EQT number of the tape drive that corresponds to the nn DVR23 position in the Equipment Table c An Interrupt Table entry for each HP 13181A or HP 13183A card INTERRUPT TABLE nn EQT m nn 1 EQT m where nn is again the lower numbered select code of the HP 13181A or HP 13183A Card nn 1 is the higher numbered select code of the card m is again the position of the tape drive in the Equipment Table 3 2 Configuration Information Below is an example of the entries that could be made for the three tables discussed above In this example the magnetic tape interface cards are in select codes 13 and 14 the EQT number of the tape drive is 3 and the LU number is 4 Equipment Table EQT 01 12 DVR32 D EQT 02 11 DVROO B EQT 03 13 DVR23 B T 700 Device Reference Table EQT EQT EQT EQT WPROWFRNN EH Il Interrupt Table 11 EQT 2 12 EQT 1 13 EQT 3 14 EQT 3 Configuration Information 3 3
8. g SEQUONUGS 00 rin a ia ies aaa Status Request nara 22 een re Err r Recover Procedures store to A RI ES Read Parity AA A Nae he re ee Write Parity Estor 22 2 ee oe au sean ea u Equipment Not Ready u ea ee ii Attempted Write at End of Tape EOT lt lt m messen a pr nn Limited Length Records ac essen ir TEE EEEE TE REEE E Dynamic Statis tl dr aa dde Chapter 3 Configuration Information Generation zu a a Gilad ed Be Bone Bone ehr a bce se nde Program Input Phase vs shag thie thos bbe Casas hay AR e tos Table Generation Phase 4 3230 Tables Table 2 1 HP 7970 Read Write Calls DVR23 2 2 22 522222404 Table 2 2 HP 7970 Control Request Calls DV R23 su cis Table 2 3 HP 7970 Status Request Call DY R23 2er Table 2 4 Status Return Information ISTAl sonic ea a Table 2 5 Status Return Information STA Lc et a 5 6 DODODDDDDDDND AAADADODOD A a WW Ww Raja General Information This manual contains information and procedures that allow you to write application programs using FORTRAN or Assembly language and RTE Driver DVR23 Chapter 3 provides information required when configuring DVR23 into a Real Time Executive RTE Operating System The driver is entered through a FORTRAN or Assembly language call to control one to four HP 7970 Series 9 track Digital Magnetic Tape Units via an HP 13181A or HP 13183A Magnetic Tape Unit Interface Kit in an RTE environment The interface provides all tape motion and data tr
9. ifies the edition of this manual and any updates that are included Periodi cally update packages are distributed that contain replacement pages to be merged into the manual in cluding an updated copy of this printing history page Also the update may contain write in instructions Each reprinting of this manual will incorporate all past updates however no new information will be added Thus the reprinted copy will be identical in content to prior printings of the same edition with its user in serted update information New editions of this manual will contain new information as well as all updates To determine which manual edition and update is compatible with your current software revision code refer to the Manual Numbering File or the Computer User s Documentation Index The Manual Numbering File is included with your software It consists of an M followed by a five digit product number Fourth Edition NOV 1979 costra tiara Update 1 Jan VOSA Gist tas entered rn Update 2 OCU 198I O ia A EAR Reprint oras ies Oct 1981 Updates 1 and 2 incorporated Fifth Edition Oct 1984 Transparent Bit Documentation Sixth Edition Juni 1993 sacred chase ne a een 3 4 Table of Contents Chapter 1 General Information Operating Environment su cis a RA AA A a ee Chapter 2 Application Information A ne ee RAR eh Callin
10. nces The HP 7970 Series Magnetic Tape Unit is operated in the RTE System through FORTRAN Assembly language programs calling DVR23 The driver will cause the magnetic tape unit to respond to Read Write Control and Status requests using the standard calls to EXEC These calls are listed in Tables 2 1 through 2 3 Status Request Information returned from a status request is detailed in Table 2 4 Note that 1 A rewind backspace record or backspace file request will perform no action if the tape unit is at load point The start of tape condition will be reflected both before and after the request in the status word 2 Forwardspace file and backspace file commands cause the tape unit to go forward or backward until a file mark has been detected Data is not transferred but parity is checked A parity error in any record of the file will set the parity error status bit A backspace file will position the tape in front of a file mark or at load point whichever comes first 3 If the end of tape mark is sensed during the execution of a forwardspace file function the tape will stop at the end of the current record rather than after a file mark The user must check for this condition with a status request Application Information 2 1 Table 2 1 HP 7970 Read Write Calls DVR23 Assembly EXT EXEC Function code 1 Read request 2 Write request JSB EXEC Control word DEF 45 Bits 0 5 LU number of tape unit DEF ICODE Bit 6 Type
11. of data only used when a zero length read occurs cie cada 0 ASCII read write DEF IBUFR f DEE TPUFL 1 binary read write Bit 10 Transparency bit TETT POMI 1 transparent request 0 non transparent request When the transparent bit is not set the tape LU will be placed down if more than two forward motion requests are attempted at or beyond the EOT marker When the transparent bit is set there are no restrictions on the number of forward motion requests processed at or beyond the EOT marker CAUTION When the transparent bit is set it is the responsibility of the user program to check and handle the EOT condition If the user program does not check for EOT tape run off can occur All other bits are set to zero 0 IBUFR Address of first word of input output buffer IBUFL Input output buffer length in either characters or words A negative value indicates ASCII characters 2 per word a positive value indicates words A length of O on output causes immediate completion of the request On input only as much data as will fit within specified buffer length is transmitted A zero length buffer size on Binary Read causes a forward skip of one record A zero length buffer size on ASCII read causes immediate completion of the request The minimum length of a Read Write operation for tape unit is one word or 2 characters Because of hardware limitations only even byte length records can be written On Return A Status see T
12. s operation it may take slightly longer than the normal status request The status word is returned in the A Register to the user This request will not be processed until the mag tape EQT entry is not busy The EQT entry is updated by this request Application Information 2 7 Configuration Information This section provides configuration information for Driver DVR23 and is intended to augment the data provided in the RTE Software System programming and operating manuals Note that DVR23 drives either an 800 BPI or a 1600 BPI 9 track magnetic tape Generation The driver is loaded into the RTE system during system generation At this time the following items must be supplied by the operator to configure the tape unit into the RTE system being generated Program Input Phase Driver DVR23 must be relocated during this phase Table Generation Phase In this phase the following three entries must be made a An Equipment Table entry for each HP 13181A or HP 13183A Interface card EQUIPMENT TABLE ENTRY EQT m nn DVR23 B T 700 where m is the EQT number of the tape nn is the lower numbered select code of the HP 13181A or HP 13183A Interface card B is output buffering enabled This is not required but is usually set to increase the throughput for short records It can however have the adverse effect of causing some utilities to suspend due to lack of System Available Memory SAM HP supplied utilities use the unbuff
Download Pdf Manuals
Related Search