File Number 1130-30 Order Number GC26-5929-8 Systems Reference Library IBM 1130 Subroutine Library Ninth Edition (May 1974) This is a reprint of GC26-5929-7 incorporating changes released in the following newsletter GN34-0182. This edition applies to version 2, modification 12 of IBM 1130 Disk Monitor System and to all subse- quent modifications until otherwise indicated in new editions or Technical Newsletters. Changes are continually made to the specifications herein; beforeusing this publication in connection with the operation of IBM systems, consult the latest SRL Newsletter, Order No. GN20-1130, for the editions that are applicable and current. Text for this manual has been prepared with the IBM Selectric® Composer. Requests for copies of IBM publications should be made to your IBM representative or the IBM branch office serving your locality. A form for readers' comments is provided at the back of this publication. If the form has been removed, send your comments to IBM Corporation, Systems Publications, Department 27T, P. 0. Box 1328, Boca Raton, Florida 33432. Comments become the property of IBM. ©Copyright International Business Machines Corporation 1965, 1966, 1967, 1968, 1969, 1970, 1972 2 Preface The publication describes how the The operating procedures manuals for the programmer can use the IBM 1130 library programming systems also provide subroutines to increase the efficiency of information on subroutine usage. These his programs and decrease his writing and manuals are: testing time. The libraries include the following programs: IBM 1130 Card/Paper Tape Programming • Interrupt Level Subroutines. System Operators Guide, Order No. • Interrupt Service Subroutines. GC26-3629. • RPG Subroutines. • FORTRAN I/O Subroutines. • Data Code Conversion Subroutines. IBM 1130 Disk Monitor System, Version 2, • Arithmetic and Functional Subroutines. Programmers and Operators Guide, Order • Selective Dump Subroutines. No. GC26-3717. • Utility Programs. The subroutines are available for use with the 1130 Assembler, the 1130 FORTRAN Compiler, and the 1130 RPG Compiler. The MACHINE CONFIGURATION Utility Programs are executable under Monitor control. The use of the library subroutines requires the following minimum machine In Assembler language, the user calls configuration: the subroutines via a calling sequence. The appropriate subroutine calls are IBM 1131 Central Processing Unit with generated by the FORTRAN Compiler whenever 4096 words of core storage. a read, write, arithmetic, or CALL statement is encountered. The RPG Compiler IBM 1442 Carl Read Punch, or IBM 1134 generates the appropriate subroutine Paper Tape Reader with IBM 1055 Paper linkages. This publication describes each Tape Punch. subroutine and the required calling sequence. All subroutines in the 1130 libraries are included in the lists that Note: RPG, available only with the DM2 appear in Appendix A. system, requires 8192 words of core storage. It is assumed that the reader is familiar with the methods of data handling In addition, the following input/output and the functions of instructions in the units and features can be controlled by IBM 1130 Computing System. He must also be the input/output subroutines. familiar with the Assembler or Compiler used in conjunction with the subroutines. Console Printer/Keyboard The following IBM publications provide the Single Disk Storage prerequisite information: 1132 Printer 1627 Plotter IBM 1130 Functional Characteristics, 1403 Printer (DM2 only) Order No. GA26-5881. 2310 Disk Storage (DM2 only) IBM 1130 Operating System, Order No. 2311 Disk Storage (DM2 card system only) GA26-5717. 2501 Card Reader (DM2 only) 1231 Optical Mark Page Reader (DM2 only) IBM 1130 Assembler Language, Order No. GC26-5927. Synchronous Communications Adapter (DM2 only) IBM 1130/1800 Assembler Language, Plotter subroutines are described in IBM Order No. GC26-3778. 1130/1800 Plotter Subroutines, Order No. IBM 1130/1800 Basic FORTRAN IV Language, GC26-3755. Order No. GC26-3715. IBM 1130 RPG Specifications, Order No. SCA subroutines are described in IBM GC21-5002. 1130 Synchronous Communications Adapter Subroutines, Order No. GC26-3706. 3 Contents INTRODUCTION 7 CARDZ - 1442 Card Read Punch I/O Subroutine 71 INTERRUPT SERVICE SUBROUTINES 8 PAPTZ - 1134/1055 Paper Tape Realer ISS Characteristics 8 Punch I/O Subroutine 71 Methods of Data Transfer 8 PRNTZ - 1132 Printer Output Interrupt Processing 8 Subroutine 71 ILS Operation 9 ISS Operation General Error-Handling Procedures 12 I Basic ISS Calling Sequence 14 SUBROUTINES USED BY FORTRAN (DM2 Assignment of Core Storage Locations SYSTEM) 73 (C/PT System) 16 General Specifications (Except DISKZ) 73 Assignment of Core Storage Locations Error Handling 73 (DM2 System) 17 Descriptions Of I/O Subroutines . 73 Descriptions of Interrupt Service IYPEZ - Keyboard/Console Printer I/O Subroutines 19 Subroutine 74 1442 Card Read Punch Subroutines WRTYZ - Console Printer Output (CARDO and CARD1) 19 Subroutine 74 2501 Card Reader Subroutines (READO CARDZ - 1442 Card Read Punch I/O and READ1) 21 Subroutine 74 1442 Card Punch Subroutines (PNCHO PAPTZ - 1134/1055 Paper Tape Reader and PNCH1) 22 Punch I/O Subroutine 74 Disk Subroutines (C/PT PRNTZ - 1132 Printer Output System) 24 Subroutine 74 Disk Subroutines (DM2 System) . 28 PNCHZ - 1442 Output Subroutine . 75 DISKZ - Disk I/O Subroutine 32 READZ - 2501 Input Subroutine . 75 1132 Printer Subroutine (PRNT1) . 33 PRNZ - 1403 Printer Subroutine . 75 1132 Printer/Synchronous Communications Adapter Subroutine DATA CODE CONVERSION SUBROUTINES . 76 (PRNT2) 35 Descriptions Of Data Codes 76 1403 Printer Subroutine (PRNT3) . 36 Hexadecimal Notation 76 Keyboard/Console Printer 38 IBM Card Code 77 Paper Tape Subroutines (C/PT Perforated Tape And Transmission Code System) 40 (PTTC/8) 77 Paper Tape Subroutines (DM2 System) 42 Console Printer Code 77 Plotter Subroutine (PLOT1) 44 Extended Binary Coded Decimal Plotter Subroutine (PLOTX) 45 Interchange Code (EBCDIC) 78 1231 Optical Mark Page Reader 1403 Printer Code 78 Subroutine (OMPR1) 46 Conversion Subroutines 78 2250 Display Unit Model 4 I/0 BINDC 79 Subroutine (DSPYN) 48 DCBIN 80 BINHX 80 RPG SUBROUTINES (DM2 SYSTEM) 49 HXBIN 81 Disk File Management Subroutines (DM2 HOLEB 81 System) 49 SPEED 82 Disk I/O Subroutines 49 PAPEB 83 File Organization 49 PAPHL 85 File Processing 49 PAPPR 86 Sequentially Organized Disk Routines 50 HOLPR 87 Indexed Sequential Organized (I SAM) EBPRT 88 Disk Routines 53 BIDEC 89 RPG Object Time Subroutines 66 DECBI 90 ZIPCO 90 1SUBROUTINES USED BY FORTRAN (C/PT SYSTEM) 70 ARITHMETIC AND FUNCTIONAL SUBROUTINES 93 General Specifications 70 Real Data Formats 93 Error Handling 70 Real Number Pseudo Accumulator . 94 Descriptions of I/O Subroutines . 70 Calling Sequences 94 TYPEZ - Keyboard/Console Printer I/O Arithmetic And Functional Subroutine Subroutine 71 Error Indicators 98 WRTYZ - Console Printer Output Functional Subroutine Accuracy 100 Subroutine 71 Extended Precision Subroutines . 100 5 Standard Precision Subroutines . .101 Paper Tape Utility (PTUTL) 111 Elementary Function Algorithms 102 Sine-Cosine 102 WRITING ISS AND ILS (C/PT Arctangent 103 SYSTEM) 112 Square Root 103 Interrupt Service Subroutines 112 Natural Logarithm 104 Interrupt Level Subroutines 112 Exponential 104 Hyperbolic Tangent 105 APPENDIX A. LISTING OF SUBROUTINES . .118 Real Base to Real Exponent 105 APPENDIX B. ERRORS DETECTED BY THE ISS SELECTIVE DUMP SUBROUTINES 106 SUBROUTINES 130 Dump Selected Data On Console Printer Or 1132 Printer 106 APPENDIX C. SUBROUTINE ACIION ON Dump Status Area 106 RETURN FROM A USERS ERROR SUBROUTINE .132 SPECIAL MONITOR SUBROUTINES 107 APPENDIX D. CHARACTER CODE CHART . .133 FLIPR (LOCAL/SOCAL Overlay) 107 APPENDIX E. CORE REQUIREMENTS OF RDREC (READ ID Record) . 107 SUBROUTINES 137 CALPR (Call System Print) 107 FSLEN (Fetch Phase IDs and Fetch APPENDIX F. EXECUTION TIMES OF System Subroutine) 107 SUBROUTINES 139 SYSUP (DCOM Update) 107 APPENDIX G. RE-ENTERABLE CODE . .143 Re-enterable Code 143 Calling a Re-Enterable Subroutine . 144 SYSTEM LIBRARY MAINLINE PROGRAMS (242 Obtaining Temporary Storage 144 1 SYSTEM) 109 Modifying Storage or Instructions . .144.2 Disk Maintenance Programs 109 1800 Compatibility 145 INDEX 146 6 Figures Figure 1. Call Portion of an ISS . 11 Figure 17. Disk File Information Figure 2. Interrupt Response Table for ISAM Random (Part 1 of 2) 67 Portion of an ISS 11 Figure 18. Hexadecimal Notation . 77 Figure 3. (C/PT System ISS Figure 19. PTTC/8 Code for the Names) 14 Characters 1/ (if lower case) or Figure 4. DM2 System ISS Names . 15 the Characters =? (if upper case) . 77 Figure 5. ISS and ILS Core Figure 20. Types of Conversion . 79 Locations for the (C/PT Figure 20.1 System Library EBPT3 . 92 System) 17 Figure 21. Arithmetic and Figure 6. ISS and ILS Core Functional Subroutines 95 Locations for the DM2 System . 18 Figure 22. (C/PT System) Figure 7. Carriage Control ISS/ILS Correspondence 112 Operations for 1132 Printer . , . 35 Figure 23. (C/PT System) Figure 8. Carriage Control Subroutine Library (Part 1 of 3) . .118 Operations for 1403 Printer . 38 Figure 24. 1130 Disk Monitor Figure 9. PLOT1 Control Digits • . 45 Version 2 System Library (Part 1 Figure 10. PLOT1 Example 45 of 9) 121 Figure 10.1 PLOTX Control Digits . 46 Figure 25. Core Requirements of Figure 10.2 Space Utilization for Arithmetic and Functional Various Size Records for Sequential