M T S The Michigan Terminal System Volume 3: System Subroutine Descriptions Reference R1003 April 1981 Updated March 1982 (Update 1) Updated February 1983 (Update 2) Updated January 1984 (Update 3) Updated September 1984 (Update 4) Updated April 1985 (Update 5) Updated September 1985 (Update 6) Updated July 1987 (Update 7) Updated September 1989 (Update 8) The University of Michigan Computing Center Ann Arbor, Michigan 1 DISCLAIMER This volume is intended to represent the current state of the Michigan Terminal System (MTS), but because the system is constantly being developed, extended, and refined, sections of this volume will become obsolete. The user should refer to the U-M___ Computing_________ News,____ Computing Center Memos, and future updates to this volume for the latest information about changes to MTS. Copyright 1981 by the Regents of the University of Michigan. Copying is permitted for nonprofit, educational use provided that (1) each repro- duction is done without alteration and (2) the volume reference and date of publication are included. Permission to republish any portions of this manual should be obtained in writing from the Director of the University of Michigan Computing Center. 2 MTS 3: System Subroutine Descriptions April 1981 Page Revised September 1989 PREFACE_______ The software developed by the Computing Center staff for the operation of the high-speed processor computer can be described as a multiprogramming supervisor that handles a number of resident, reentrant programs. Among them is a large subsystem, called MTS (Michigan Terminal System), for command interpretation, execution control, file management, and accounting maintenance. Most users interact with the computer’s resources through MTS. The MTS Manual is a series of volumes that describe in detail the facilities provided by the Michigan Terminal System. Administrative policies of the Computing Center and the physical facilities provided described in other publications. The MTS volumes now in print are listed below. The date indicates the most recent edition of each volume; however, since volumes are periodically updated, users should check the file *CCPUBLICATIONS, or watch for announcements in the U-M___ Computing_________ News,____ to ensure that their MTS volumes are up to date. Volume 1: The____________________________ Michigan Terminal System, November 1988 Volume 2: Public________________________ File Descriptions, January 1987 Volume 3: System______________________________ Subroutine Descriptions, March 1989 Volume 4: Terminals_____________________________ and Networks in MTS, July 1988 Volume 5: System_______________ Services, May 1983 Volume 6: FORTRAN______________ in MTS, October 1983 Volume 7: PL/I___________ in MTS, September 1982 Volume 8: LISP____________________ and SLIP in MTS, June 1976 Volume 9: SNOBOL4______________ in MTS, September 1975 Volume 10: BASIC____________ in MTS, December 1980 Volume 11: Plot_______________________ Description System, August 1978 Volume 12: PIL/2____________ in MTS, December 1974 Volume 13: The_____________________________ Symbolic Debugging System, September 1985 Volume 14: 360/370_________________________ Assemblers in MTS, May 1983 Volume 15: FORMAT__________________ and TEXT360, April 1977 Volume 16: ALGOL______________ W in MTS, September 1980 Volume 17: Integrated__________________________ Graphics System, December 1980 Volume 18: The___________________ MTS File Editor, February 1988 Volume 19: Tapes______________________ and Floppy Disks, March 1989 Volume 20: Pascal_____________ in MTS, January 1989 Volume 21: MTS_________________________________ Command Extensions and Macros, April 1986 Volume 22: Utilisp______________ in MTS, May 1988 Volume 23: Messaging_________________________________ and Conferencing in MTS, August 1988 The numerical order of the volumes does not necessarily reflect the chronological order of their appearance; however, in general, the higher the number, the more specialized the volume. Volume 1, for example, 3 MTS 3: System Subroutine Descriptions Page Revised September 1989 April 1981 introduces the user to MTS and describes in general the MTS operating system, while Volume 10 deals exclusively with BASIC. The attempt to make each volume complete in itself and reasonably independent of others in the series naturally results in a certain amount of repetition. Public file descriptions, for example, may appear in more than one volume. However, this arrangement permits the user to buy only those volumes that serve his or her immediate needs. Richard A. Salisbury, General Editor 4 MTS 3: System Subroutine Descriptions April 1981 PREFACE___________________________ TO REVISED VOLUME 3 The April 1981 edition reflects the changes that have been made to MTS since October 1976. Some of these changes were described in Updates 1-5 and are incorporated into this revision. The section "PL/I Library Subroutines" has been deleted from this edition as those subroutines are currently described in MTS Volume 7, PL/I___________ in MTS. The section "External Symbol Index" has been deleted. This informa- tion is now available through the program *SYMBOLS. The following subroutine descriptions have been added to this edition since Update 5 (April 1980). CHKPAR COMMAND GPRJNO NPAR PKEY RSSAS TRLCUC, TRUCLC TRTLC, TRTUC, TRTNONAN The following subroutines have been deleted from this edition as they are no longer actively supported by the Computing Center. Descriptions of these subroutines may be found in the October 1976 edition of MTS Volume 3, System______________________________ Subroutine Descriptions, which is available in the Computing Center staff library. CVTOMR E7090, D7090, E7090P, D7090P KEYWRD TRACER The following subroutine has been deleted from this edition as it is callable only from internal system programs. SETFPRIV The CASECONV subroutine description is now a part of the TRLCUC, TRUCLC subroutine description. A special edition of this volume has been published for use by systems programmers. This edition contains descriptions of several internal system subroutines which are callable only from system mode or 5 MTS 3: System Subroutine Descriptions April 1981 which contain parameters which are only of use to systems programs. A copy of this edition is available in the Computing Center Staff Library. 6 MTS 3: System Subroutine Descriptions April 1981 Contents________ Preface . 3 LAND . 61 LCOMPL . 61 Preface to Revised Volume 3 . 5 LOR . 61 LXOR . 61 Using Subroutine Libraries . 11 OR . 61 SHFTL . 61 Subroutines Libraries SHFTR . 61 Available in MTS . 13 XOR . 61 Blocked Input/Output Subject Categories of Routines . 63 Subroutines . 19 QGETUCB . 64 Character and Numeric QOPEN . 65 Conversion . 19 QGET . 67 Date and Time Conversion . 19 QPUT . 69 File and Device Usage . 20 QCLOSE . 71 FORTRAN Usage . 21 QFREEUCB . 72 Input/Output Routines . 22 QCNTRL . 73 Interrupt Processing . 22 BLOKLETR . 75 Status of User and System . 22 CALC . 77 System Utilities . 23 CANREPLY . 81 Virtual Memory Management . 23 CATSCAN . 82.1 CFDUB . 83 Calling Conventions . 25 Character Manipulation Routines . 85 Resident System and *LIBRARY BTD . 87 Subroutines . 35 COMC . 88 ADROF . 37 DTB . 89 ANSI Standard Bit EQUC . 91 Manipulation Subroutines . 38.1 FINDC . 92 ANSI Standard File Control FINDST . 94 Subroutines . 38.3 IGC . 95 Array Management Subroutines 39 LCOMC . 97 ARINIT . 41 MOVEC . 98 ARRAY, ARRAY2 . 42 SETC . 99 EXTEND, XTEND2 . 44 TRNC . .100 ERASE . 46 TRNST . .101 ERASAL . 46 CHARGE . .103 ASCEBC, IASCEBC . 47 CHGFSZ . .107 ATNTRP . 53 CHGMBC . .109 ATTNTRP . 55 CHGXF . .111 BINEBCD . 57 CHKACC . .115 BINEBCD2 . 59 CHKFDUB . .117 BMS (Bit Manipulation CHKFILE . .119 Subroutines) . 60.1 CHKPAR . .121 Bitwise Logical Functions . 61 CLOSEFIL . .125 AND . 61 CMD . .127 COMPL . 61 CMDNOE . .129 7 MTS 3: System Subroutine Descriptions April 1981 CNFGINFO . .131 LINK, LINKF . .319 CNTLNR . .137 LIOUNITS . .325 COMMAND . .139 LOAD, LOADF . .327 CONTROL . .143 LOADINFO . .335 COST . .147 LOCK . .339 CREATE . .149 LODMAP . .343 CRYPT . .151 Logical Operators . .345 CSGET, CSSET . .152.1 ICLC . .345 DESTROY . .153 IED . .345 DISMOUNT . .155 IEDMK . .345 DUMP, PDUMP . .157 IMVC . .345 EBCASC, IEBCASC . .159 INC . .345 EDIT . .167 IOC . .345 EMPTY . .179 ITR . .345 EMPTYF . .181 ITRT . .345 ERROR . .183 IXC . .345 FILEINFO . .184.1 LSFILE . .348.1 FNAMETRT . .185 LSTASK . .348.5 FREAD/FWRITE . .187 MOUNT . .349 FREEFD . .189 MTS . .355 FREESPAC . .191 MTSCMD . .357 FSIZE . .193 NOTE . .359 FSRF, BSRF . .195 NPAR . .361 FTNCMD . .197 OSGRDT . .363 GDINF . .199 PAR . .365 GDINFO . .201 PARSTR . .366.1 GDINFO2 . .207 Pattern-Matching Routines . .366.3 GDINFO3 . .209 PATBUILD . .366.4 GETFD . .211 PATMATCH . .366.7 GETFST, GETLST . .213 PATFREE . .366.9 GETIME . .215 PERMIT . .367 GETSPACE . .217 PGNTTRP . .371 GFINFO . .221 PKEY . .373 GPRJNO . .229 POINT . .375 GPSECT, QPSECT, FPSECT . .231 Printer Plot Routines . .377 GRAND, GRAND1 . .233 PLOT1 . .381 GRGJULDT, GRGJULTM, GRJLSEC .235 PLOT2 . .382 GRJLDT, GRJLTM . .237 PLOT3 . .383 GROSDT . .239 PLOT4 . .384 GTDJMS . .241 PLOT14 . .385 GTDJMSR . .243 PRCHAR . .386 GUINFO, CUINFO . .245 PREND . .387 GUINFUPD . .271 PRPLOT . .388 GUSER . .273 STPLT1 . .390 GUSERID . .275 STPLT2 . .391 IBSCH . .276.1 SETLOG . .392 IOH . .277 OMIT . .393 JLGRDT, JLGRTM . .279 QUIT . .395 JMSGTD, JTUGTD . .283 RCALL . .397 JMSGTDR, JTUGTDR . .285 READ . .399 JULGRGDT, JULGRGTM, JLGRSEC .287 READBFR . .403 KWSCAN . .289 RENAME . .405 LETGO . .317 RENUMB . .407 8