(RT--11 System Subroutine\Library Manual) <order_number>(AA--PD6MA--TC) <ABSTRACT>(August 1991) This manual contains current reference data about the system subroutine library (SSL), a collection of routines callable from high-level languages (FORTRAN and C). <ENDABSTRACT> <REVISION_INFO>(Revision/Update Information:\This information was previously published, along with reference data about the system macro library, as part of the <EMPHASIS>(RT--11 Programmer's Reference Manual,\ITALIC) <keep>(AA--H378D--TC.)) <REVISION_INFO>(Operating System:\RT--11 Version 5.6) <ENDTITLE_PAGE>() <COPYRIGHT_PAGE> <COPYRIGHT_PAGE_FORMATTING>(CONTROLLED) <PRINT_DATE>(First Printing, August 1991) 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. Any software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software or equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. Restricted Rights: Use, duplication, or disclosure by the U.S. 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_DATE>(1991\Digital Equipment Corporation) <line> All rights reserved. Printed in U.S.A. The Reader's Comments form at the end of this document requests your critical evaluation to assist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: CTS--300, DDCMP, DECnet, DECUS, DECwriter, DIBOL, MASSBUS, MicroPDP--11, Micro/RSX, PDP, Professional, Q-bus, RSTS, RSX, RT--11, RTEM--11, UNIBUS, VMS, VT, and the DIGITAL logo. <vertical_space>(fill) <document_acknowledgment>(brief) <ENDCOPYRIGHT_PAGE>(S1436) <CONTENTS_FILE> <PREFACE>(9) This manual contains reference data about RT--11 system subroutines, a collection of call routines contained in system library SYSLIB.OBJ. As a FORTRAN programmer, you access RT-11 Monitor services through these call routines to the system subroutine library. Using SYSLIB subroutines, you can write almost all application programs in FORTRAN without having to write code in any assembly language. This library is also accessible from PDP--11C. Reference data about the system macro library, previously contained in the <REFERENCE>(PRM_BOOK) is now contained in a separate manual, <EMPHASIS>(RT--11 System Macro Library Manual). See <EMPHASIS>(Associated Documents\ITALIC). <HEAD1>(Intended Audience) This information is provided for use by advanced RT--11 users, including FORTRAN IV, FORTRAN-77, and MACRO--11 assembly language programmers and C language programmers. <HEAD1>(Document Structure) <DEFINITION_LIST> <DEFLIST_ITEM>(Chapter 1 --- Using the System Subroutine Library) <DEFLIST_DEF> Describes implementation and effective use of subroutines contained in SYSLIB.OBJ; provides examples that demonstrate subroutine flexibility and value in working programs. <DEFLIST_ITEM>(Chapter 2 --- System Subroutine Description and Examples) <DEFLIST_DEF> Presents all SYSLIB functions and subroutines in alphabetical order; provides a detailed description of each one. Gives examples of each call in a FORTRAN program. <ENDDEFINITION_LIST> <HEAD1>(Associated Documents\BOOKS) The RT--11 Documentation Set consists of the following associated documents: Basic Books <list>(unnumbered) <LE> <REFERENCE>(INT_book) <LE> <REFERENCE>(GUI_book) <LE> <REFERENCE>(SUG_book) <LE> <REFERENCE>(KED_book) <LE> <REFERENCE>(KEDC_book) <LE> <REFERENCE>(MRM_book) <LE> <REFERENCE>(MAS_book) <LE> <REFERENCE>(MSG_book) <LE> <REFERENCE>(SRN_book) <ENDLIST> Installation Specific Books <list>(unnumbered) <LE> <REFERENCE>(AUT_book) <LE> <REFERENCE>(INS_book) <LE> <REFERENCE>(SYG_BOOK) <ENDLIST> Programmer Oriented Books <list>(unnumbered) <le> <REFERENCE>(IND_book) <LE> <REFERENCE>(SUM_book) <LE> <REFERENCE>(SML_book) <LE> <REFERENCE>(SSL_book) <LE> <REFERENCE>(SIM_book) <LE> <REFERENCE>(DEV_book) <LE> <REFERENCE>(VFF_book) <LE> <REFERENCE>(DBG_book) <ENDlist> <PAGE> <HEAD1>(Conventions\Conventions) The following conventions are used in this manual: <ALIGN_CHAR>(#) <TABLE> <TABLE_ATTRIBUTES>(KEEP) <TABLE_SETUP>(2\12) <TABLE_HEADS>(Convention\Meaning) <TABLE_ROW>(Black print\ In code examples, black print indicates output lines or prompting characters the system displays.) <COMMENT> <TABLE_ROW>(Red print\ In command examples, red print indicates user input. For example: <interactive> <s>(TYPE DISK.DIR/LOG <KEY>(RET):) ( Files copied: DK:DISK.DIR to TT: 12-Oct-91) <endinteractive>) <ENDCOMMENT> <TABLE_ROW>(Braces ({#})\In command examples, braces enclose mutually exclusive options. You can choose only one of the options contained in braces. ) <TABLE_ROW>(Brackets [#]\In command examples, square brackets enclose optional parameters, qualifiers or values. For example:<line> <NEWTERM>(###i#=#ISFDAT#(chan,dblk[,idate][,iold])) ) <TABLE_ROW>(UPPERCASE <LINE> characters\ In command examples, uppercase characters are command elements that should be entered exactly as given.) <TABLE_ROW>(lowercase <line> characters\ In command syntax examples, lowercase characters are command elements for which you specify a value. For example: <line> <newterm>(###CALL#POKEB#(iaddr,ivalue))) <TABLE_ROW>(Command<LINE> Syntax\Functions and subroutines have different formats:<LINE> A function has the format:<LINE> <NEWTERM>(###i#=#POKEB#(iaddr,ivalue)) <line>A subroutine has the format:<LINE> <NEWTERM>(###CALL#POKEB#(iaddr,ivalue)) <line>Alternative commands are shown as:<LINE> <NEWTERM>(###i#=#POKEB#(iaddr,ivalue))<LINE> <NEWTERM>(###CALL#POKEB#(iaddr,ivalue))) <endalign_char> <TABLE_ROW>(<BOX>(RET)\<box>(RET) in examples and in the example installation represents the RETURN key.) <TABLE_ROW>(<BOX>(CTRL/<VARIABLE>(x))\ <BOX>(CTRL/<VARIABLE>(x)) indicates a control key sequence. While pressing the key labeled Ctrl, press another key. For example: <BOX>(CTRL/C)) <ENDTABLE> <PREFACE_SECTION>(Summary of Changes) This section summarizes additions, deletions and changes to the system subroutine library (SYSLIB). Refer to Chapter 2 for detailed description of RT--11 system subroutines. <head1>(Changes Between SYSLIB and FORTRAN OTS (FORLIB and F77OTS)) The following SYSLIB changes affect the relationship between SYSLIB and the FORTRAN Object Time Systems (OTS). <LIST>(UNNUMBERED) <LE>Functions and subroutines DATE, IDATE, RAN, and RANDU, previously in the distributed FORTRAN subroutine libraries, are now located in SYSLIB.OBJ. <LE>The following functions and subroutines (see <REFERENCE>(DELIST)), specific to FORTRAN programming, have been deleted from the distributed RT-11 system subroutine library, SYSLIB.OBJ, because they do not work without a resident FORTRAN OTS. These functions and subroutines have been added to the FORTRAN IV distributed FORLIB and the FORTRAN-77 distributed F77OTS. <ENDLIST> <ALIGN_CHAR>(#) <TABLE>(Functions and Subroutines Deleted from SYSLIB\DELIST) <TABLE_ATTRIBUTES>(MULTIPAGE) <TABLE_SETUP>(4\3\15\15) <TABLE_ROW>(\GETSTR\IFREEC\INTSET) <TABLE_ROW>(\IASIGN\IGETC#\IQSET#) <TABLE_ROW>(\ICDFN#\IGETSP\PUTSTR) <TABLE_ROW>(\IFETCH\ILUN##\SECNDS) <ENDTABLE> <ENDALIGN_CHAR> <NOTE> Because IQSET is no longer in SYSLIB.OBJ, FORTRAN programmers who need to add queue elements for certain other SYSLIB functions, should refer to the FORTRAN IV distributed FORLIB and the FORTRAN-77 distributed F77OTS. <ENDNOTE> <HEAD1>(SYSLIB Subroutines) <HEAD2>(Changes for I-D Space\MAP) <REFERENCE>(MAPLIST) lists subroutine changes resulting from the addition of Supervisor Mode, I-D space. One of the major features of V5.6 SYSLIB support added mapping routines that begin with letter <EMPHASIS>(M\ITALIC). The <EMPHASIS>(mapping\ITALIC) version of a routine is called in the same manner as an unmapped version, but has an added argument that specifies the type of mapping required. In these cases, mapping is shown as an optional parameter in the generic command string. For example, ISDATW/MSDATW is shown as: <ALIGN_CHAR>(#) Form: <line>(indent\1\smallskip)<NEWTERM>(i#=#ISDATW#(buff,wcnt)) <line>(indent\1\smallskip)<NEWTERM>(i#=#MSDATW#(buff,wcnt[,bmode])) <ENDALIGN_CHAR> <ALIGN_CHAR>(#) <TABLE>(Routines Added or Changed for I-D Space\MAPLIST) <TABLE_ATTRIBUTES>(KEEP) <TABLE_SETUP>(7\3\8\8\8\8\8\) <TABLE_ROW>(\ICMAP\IUNMAP\JREADW\MREAD\MREADC\MSPFNC) <TABLE_ROW>(\ICRAW\ISCCA\JWRITE\MREADW\MRVCDW\MTATCH) <TABLE_ROW>(\ICRRG\JREAD\JWRITW\MRKT\MSDS\MWRITC) <TABLE_ROW>(\IELRG\JREADC\MAP\MSDAT\MSPFN\MWRITE) <TABLE_ROW>(\IGCMAP\JREADW\MRCVD\MSDAT\MSDATC\MWRITW) <TABLE_ROW>(\IGCMX\JWRITC\MRCVDC\MSPFNW\MSDATW\) <ENDTABLE> <ENDALIGN_CHAR> <HEAD2>(SYSLIB Subroutine Changes) <REFERENCE>(SUBCHG) lists subroutines that have been changed in V5.6. <ALIGN_CHAR>(#) <TABLE>(Other Changes to SYSLIB Subroutines\SUBCHG) <TABLE_ATTRIBUTES>(MULTIPAGE) <TABLE_SETUP>(4\3\15\15) <TABLE_ROW>(\DEVICE\IFPROT\ISPY) <TABLE_ROW>(\GIWRIT\IGTDUS\IUNTIL) <TABLE_ROW>(\GTLIN\ISFDAT\LOOKUP) <TABLE_ROW>(\ICSTAT\ISPFN\SCCA) <ENDTABLE> <ENDALIGN_CHAR> <ENDPREFACE> <ENDFRONT

*********************** 18 July 1991 Description of Manual - fill in changes to syslib - three tables: Table 1 Functions and Subroutines Deleted from SYSLIB (DELIST) Table 2 Changes to SYSLIB Subroutines (SUBCHG) Table 3 Mapping Routines Added for I-D Space (MAPLIST) ********************** (SSL_FRONT) (RT--11 System Subroutine\Library Manual) <order_number>(AA--PD6MA--TC) <ABSTRACT>(August 1991) This manual contains current reference data about the system subroutine library (SSL), a collection of routines callable from high-level languages (FORTRAN and C). <ENDABSTRACT> <REVISION_INFO>(Revision/Update Information:\This information was previously published, along with reference data about the system macro library, as part of the <EMPHASIS>(RT--11 Programmer's Reference Manual,\ITALIC) <keep>(AA--H378D--TC.)) <REVISION_INFO>(Operating System:\RT--11 Version 5.6) <ENDTITLE_PAGE>() <COPYRIGHT_PAGE> <COPYRIGHT_PAGE_FORMATTING>(CONTROLLED) <PRINT_DATE>(First Printing, August 1991) 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. Any software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software or equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. Restricted Rights: Use, duplication, or disclosure by the U.S. 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_DATE>(1991\Digital Equipment Corporation) <line> All rights reserved. Printed in U.S.A. The Reader's Comments form at the end of this document requests your critical evaluation to assist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: CTS--300, DDCMP, DECnet, DECUS, DECwriter, DIBOL, MASSBUS, MicroPDP--11, Micro/RSX, PDP, Professional, Q-bus, RSTS, RSX, RT--11, RTEM--11, UNIBUS, VMS, VT, and the DIGITAL logo. <vertical_space>(fill) <document_acknowledgment>(brief) <ENDCOPYRIGHT_PAGE>(S1436) <CONTENTS_FILE> <PREFACE>(9) This manual contains reference data about RT--11 system subroutines, a collection of call routines contained in system library SYSLIB.OBJ. As a FORTRAN programmer, you access RT-11 Monitor services through these call routines to the system subroutine library. Using SYSLIB subroutines, you can write almost all application programs in FORTRAN without having to write code in any assembly language. This library is also accessible from PDP--11C. Reference data about the system macro library, previously contained in the <REFERENCE>(PRM_BOOK) is now contained in a separate manual, <EMPHASIS>(RT--11 System Macro Library Manual). See <EMPHASIS>(Associated Documents\ITALIC). <HEAD1>(Intended Audience) This information is provided for use by advanced RT--11 users, including FORTRAN IV, FORTRAN-77, and MACRO--11 assembly language programmers and C language programmers. <HEAD1>(Document Structure) <DEFINITION_LIST> <DEFLIST_ITEM>(Chapter 1 --- Using the System Subroutine Library) <DEFLIST_DEF> Describes implementation and effective use of subroutines contained in SYSLIB.OBJ; provides examples that demonstrate subroutine flexibility and value in working programs. <DEFLIST_ITEM>(Chapter 2 --- System Subroutine Description and Examples) <DEFLIST_DEF> Presents all SYSLIB functions and subroutines in alphabetical order; provides a detailed description of each one. Gives examples of each call in a FORTRAN program. <ENDDEFINITION_LIST> <HEAD1>(Associated Documents\BOOKS) The RT--11 Documentation Set consists of the following associated documents: Basic Books <list>(unnumbered) <LE> <REFERENCE>(INT_book) <LE> <REFERENCE>(GUI_book) <LE> <REFERENCE>(SUG_book) <LE> <REFERENCE>(KED_book) <LE> <REFERENCE>(KEDC_book) <LE> <REFERENCE>(MRM_book) <LE> <REFERENCE>(MAS_book) <LE> <REFERENCE>(MSG_book) <LE> <REFERENCE>(SRN_book) <ENDLIST> Installation Specific Books <list>(unnumbered) <LE> <REFERENCE>(AUT_book) <LE> <REFERENCE>(INS_book) <LE> <REFERENCE>(SYG_BOOK) <ENDLIST> Programmer Oriented Books <list>(unnumbered) <le> <REFERENCE>(IND_book) <LE> <REFERENCE>(SUM_book) <LE> <REFERENCE>(SML_book) <LE> <REFERENCE>(SSL_book) <LE> <REFERENCE>(SIM_book) <LE> <REFERENCE>(DEV_book) <LE> <REFERENCE>(VFF_book) <LE> <REFERENCE>(DBG_book) <ENDlist> <PAGE> <HEAD1>(Conventions\Conventions) The following conventions are used in this manual: <ALIGN_CHAR>(#) <TABLE> <TABLE_ATTRIBUTES>(KEEP) <TABLE_SETUP>(2\12) <TABLE_HEADS>(Convention\Meaning) <TABLE_ROW>(Black print\ In code examples, black print indicates output lines or prompting characters the system displays.) <COMMENT> <TABLE_ROW>(Red print\ In command examples, red print indicates user input. For example: <interactive> <s>(TYPE DISK.DIR/LOG <KEY>(RET):) ( Files copied: DK:DISK.DIR to TT: 12-Oct-91) <endinteractive>) <ENDCOMMENT> <TABLE_ROW>(Braces ({#})\In command examples, braces enclose mutually exclusive options. You can choose only one of the options contained in braces. ) <TABLE_ROW>(Brackets [#]\In command examples, square brackets enclose optional parameters, qualifiers or values. For example:<line> <NEWTERM>(###i#=#ISFDAT#(chan,dblk[,idate][,iold])) ) <TABLE_ROW>(UPPERCASE <LINE> characters\ In command examples, uppercase characters are command elements that should be entered exactly as given.) <TABLE_ROW>(lowercase <line> characters\ In command syntax examples, lowercase characters are command elements for which you specify a value. For example: <line> <newterm>(###CALL#POKEB#(iaddr,ivalue))) <TABLE_ROW>(Command<LINE> Syntax\Functions and subroutines have different formats:<LINE> A function has the format:<LINE> <NEWTERM>(###i#=#POKEB#(iaddr,ivalue)) <line>A subroutine has the format:<LINE> <NEWTERM>(###CALL#POKEB#(iaddr,ivalue)) <line>Alternative commands are shown as:<LINE> <NEWTERM>(###i#=#POKEB#(iaddr,ivalue))<LINE> <NEWTERM>(###CALL#POKEB#(iaddr,ivalue))) <endalign_char> <TABLE_ROW>(<BOX>(RET)\<box>(RET) in examples and in the example installation represents the RETURN key.) <TABLE_ROW>(<BOX>(CTRL/<VARIABLE>(x))\ <BOX>(CTRL/<VARIABLE>(x)) indicates a control key sequence. While pressing the key labeled Ctrl, press another key. For example: <BOX>(CTRL/C)) <ENDTABLE> <PREFACE_SECTION>(Summary of Changes) This section summarizes additions, deletions and changes to the system subroutine library (SYSLIB). Refer to Chapter 2 for detailed description of RT--11 system subroutines. <head1>(Changes Between SYSLIB and FORTRAN OTS (FORLIB and F77OTS)) The following SYSLIB changes affect the relationship between SYSLIB and the FORTRAN Object Time Systems (OTS). <LIST>(UNNUMBERED) <LE>Functions and subroutines DATE, IDATE, RAN, and RANDU, previously in the distributed FORTRAN subroutine libraries, are now located in SYSLIB.OBJ. <LE>The following functions and subroutines (see <REFERENCE>(DELIST)), specific to FORTRAN programming, have been deleted from the distributed RT-11 system subroutine library, SYSLIB.OBJ, because they do not work without a resident FORTRAN OTS. These functions and subroutines have been added to the FORTRAN IV distributed FORLIB and the FORTRAN-77 distributed F77OTS. <ENDLIST> <ALIGN_CHAR>(#) <TABLE>(Functions and Subroutines Deleted from SYSLIB\DELIST) <TABLE_ATTRIBUTES>(MULTIPAGE) <TABLE_SETUP>(4\3\15\15) <TABLE_ROW>(\GETSTR\IFREEC\INTSET) <TABLE_ROW>(\IASIGN\IGETC#\IQSET#) <TABLE_ROW>(\ICDFN#\IGETSP\PUTSTR) <TABLE_ROW>(\IFETCH\ILUN##\SECNDS) <ENDTABLE> <ENDALIGN_CHAR> <NOTE> Because IQSET is no longer in SYSLIB.OBJ, FORTRAN programmers who need to add queue elements for certain other SYSLIB functions, should refer to the FORTRAN IV distributed FORLIB and the FORTRAN-77 distributed F77OTS. <ENDNOTE> <HEAD1>(SYSLIB Subroutines) <HEAD2>(Changes for I-D Space\MAP) <REFERENCE>(MAPLIST) lists subroutine changes resulting from the addition of Supervisor Mode, I-D space. One of the major features of V5.6 SYSLIB support added mapping routines that begin with letter <EMPHASIS>(M\ITALIC). The <EMPHASIS>(mapping\ITALIC) version of a routine is called in the same manner as an unmapped version, but has an added argument that specifies the type of mapping required. In these cases, mapping is shown as an optional parameter in the generic command string. For example, ISDATW/MSDATW is shown as: <ALIGN_CHAR>(#) Form: <line>(indent\1\smallskip)<NEWTERM>(i#=#ISDATW#(buff,wcnt)) <line>(indent\1\smallskip)<NEWTERM>(i#=#MSDATW#(buff,wcnt[,bmode])) <ENDALIGN_CHAR> <ALIGN_CHAR>(#) <TABLE>(Routines Added or Changed for I-D Space\MAPLIST) <TABLE_ATTRIBUTES>(KEEP) <TABLE_SETUP>(7\3\8\8\8\8\8\) <TABLE_ROW>(\ICMAP\IUNMAP\JREADW\MREAD\MREADC\MSPFNC) <TABLE_ROW>(\ICRAW\ISCCA\JWRITE\MREADW\MRVCDW\MTATCH) <TABLE_ROW>(\ICRRG\JREAD\JWRITW\MRKT\MSDS\MWRITC) <TABLE_ROW>(\IELRG\JREADC\MAP\MSDAT\MSPFN\MWRITE) <TABLE_ROW>(\IGCMAP\JREADW\MRCVD\MSDAT\MSDATC\MWRITW) <TABLE_ROW>(\IGCMX\JWRITC\MRCVDC\MSPFNW\MSDATW\) <ENDTABLE> <ENDALIGN_CHAR> <HEAD2>(SYSLIB Subroutine Changes) <REFERENCE>(SUBCHG) lists subroutines that have been changed in V5.6. <ALIGN_CHAR>(#) <TABLE>(Other Changes to SYSLIB Subroutines\SUBCHG) <TABLE_ATTRIBUTES>(MULTIPAGE) <TABLE_SETUP>(4\3\15\15) <TABLE_ROW>(\DEVICE\IFPROT\ISPY) <TABLE_ROW>(\GIWRIT\IGTDUS\IUNTIL) <TABLE_ROW>(\GTLIN\ISFDAT\LOOKUP) <TABLE_ROW>(\ICSTAT\ISPFN\SCCA) <ENDTABLE> <ENDALIGN_CHAR> <ENDPREFACE> <ENDFRONT_MATTER>