SC28-6891-1 IBM VM/370 (eMS) Terminal User's Guide for FORTRAN IV Program Product Program Products Program Numbers 5734-F01 5734-F02 5734-F03 5734-LM1 5734-LM3 Page of SC28-6891-0,-1 Revised May 13, 1977 By TNL SN20-922S Second Edition (April 1975) This edition, as amended by technical newsletters SN20-9201 and SN20-9225, applies to Release 1.0 of the IBM Virtual Machine Facility/370 (VM/370) (CMS). This edition is a reprint of SC28-6891-0 incorporating changes released in Technical Newsletters SN28-0609 (dated March 1, 1973) and SN28-0620 (dated January 3, 1974). Changes are listed in the Summary of Amendments, Number 3, on the facing page. Information in this publication is subject to significant change. Any such changes will be published in new editions or technical newsletters. Before using the publication, consult the latest IBM System/360 Bibliography, GC20-0360, or IBM System/370 Bibliography, GC20-0001, and the technical newsletters that amend the particular bibliography, to learn which editions are applicable and current. Requests for copies of IBM publications shou'ld be made to your IBM representative or to the IBM branch office that serves your locality. Forms for readers' comments are provided at the back of this publication. If the forms have been removed, address comments to IBM Corporation, P. O. Box 50020, Programming Publishing, San Jose, California 95150. Comments and suggesti~ns become the property of IBM. © Copyright International Business Machines Corporation 1972 Summary of Amendments Number 1 Date of Publication: March 1, 1973 Form of Publication: TNL SN28-0609 to SC28-6891-0 CP and CMS Command Abbreviations Maintenance: Documentation Only Valid abbreviations have been added to the summary descriptions of significant CP and CMS commands. XTENT Option New: Documentation Only A description of the XTENT option of the FILEDEF command has been added for users of direct access files. Flagging of Data Spill I New: Documentation Only A statement has been added to the description of data spill indicating that several compilers will flag spill as an error even though they process it correctly. Reproduction of Command Formats for Internal Use Only New: Documentation Only Footnotes have been added to the sections describing the compiler command formats. These footnotes indicate that users may copy the sections for internal use only. H Extended SIZE Option New: Documentation Only The description of the SIZE option for the H Extended compiler has been expanded to reflect the operation of the option and to guide the user in its use. Asynchronous I/O Message New: Programming and Documentation A message indicating that an asynchronous I/O operation has been attempted has been added to the restriction on asynchronous I/O. Terminal Listing Sheet Examples Maintenance: Documentation Only Examples showing terminal listing sheets have been revised to more accurately reflect their actual appearance. Foldout Pages for the Sample Terminal Session Maintenance: Documentation Only The terminal listing sheets for the sample terminal session have been printed on foldout pages for ease of reference. Editorial changes having no technical significance are not noted here. Specific changes to the text as of this publishing date are indicated by a vertical bar to the left of the text. These bars will be deleted at any subsequent republication of the page affected. Summary of Amendments Number 2 Date of Publication: January 3, 1974 Form of Publication: TNL SN28-0620 to SC28-6891-0 as amended by TNL SN28-0609 CMS Support of FREEFORM Source Programs New: Programming and Documentation A description of preparing free form source programs and of the new filetype FREEFORT has been added. SI FT Utility New: Programming and Documentation A description of the changes made to the SIFT Utility program in support of free-form source files has been added. ASA Carriage Control Characters Modification: Documentation Only The character + has been removed from the list of supported ASA carriage control characters. OS File Compatability Modification: Documentation Only Restrictions have been added to the description of file compatability and conditions under which it can be accomplished are outlined. Editorial changes having no technical significance are not noted here. Specific changes to the text of this pUblication are indicated by a vertical bar to the left of the text. These bars will be deleted at any subsequent repUblication of the page affected. Summary of Amendments Number 1 Date of Publication: March 1, 1973 Form of Publication: TNL SN28-0609 to SC28-6891-0 CP and CMS Command Abbreviations Maintenance: Documentation Only Valid abbreviations have been added to the summary descriptions of significant CP and CMS commands. XTENT Option New: Documentation Only A description of the XTENT option of the FILEDEF command has been added for users of direct access files. Flagging of Data Spill New: Documentation Only A statement has been added to the description of data spill indicatmg that several compilers will flag spill as an error even though they process it correctly. Reproduction of Command Formats for Internal Use Only New: Documentation Only Footnotes have been added to the sections describing the compiler command formats. These footnotes indicate that users may copy the sections for internal use only. H Extended SIZE Option New: Documentation Only The description of the SIZE option for the H Extended compiler has been expanded to reflect the operation of the option and to guide the user in its use. Asynchronous I/O Message New: Programming and Documentation A message indicating that an asynchronous I/O operation has been attempted has been added to the restriction on asynchronous I/O. Terminal Listing Sheet Examples Maintenance: Documentation Only Examples showing terminal listing sheets have been revised to more accurately reflect their actual appearance. Foldout Pages for the Sample Terminal Session Maintenance: Documentation Only The terminal listing sheets for the sample terminal session have been printed on foldout pages for ease of reference. Editorial changes having no technical significance are not noted here. Specific changes to the text as of this publishing date are indicated by a vertical bar to the left of the text. These bars will be deleted at any subsequent republication of the page affected. Summary of Amendments Number 3 Form ofPublication: TNL SN20-920 1 to SC28-6891-1 Default Record Format, Logical Record Length, and Block Size Maintenance: Documentation Only The default record format, logical record length, and block size when using the FILEDEF command has been added. Listing Produced When the PRINT Option is Used Maintenance: Documentation Only If the FORTHX command is entered with the PRINT option, a listing is produced at the offline printer instead of the primary disk. Base Register Usage When Using the FORTRAN IV (H Extended) Compiler Maintenance: Documentation Only A description of base register usage in an object program compiled by the FORTRAN IV (H Extended) compiler has been added. Registers Reserved for Branch Optimization Maintenance: Documentation Only A description of the registers reserved for branch optimization has been added. Miscellaneous: Maintenance: Documentation Only Various examples have been corrected and/or expanded. Editorial changes having no technical significance are not noted here. Specific changes to the text as of this publishing date are indicated by a vertical bar to the left of the text. These bars will be deleted at any subsequent republication of the page affected. Summary of Amendments Number 2 Date of Publication: January 3, 1974 Form of Publication: TNL SN28-0620 to SC28-6891-0 as amended by TNL SN28-0609 CMS Support of FREE FORM Source Programs New: Programming and Documentation A description of preparing free form source programs and of the new filetype FREEFORT has been added. SI FT Utility New: Programming and Documentation A description of the changes made to the SIFT Utility program in support of free-form source files has been added. ASA Carriage Control Characters Modification: Documentation Only The character + has been removed from the list of supported ASA carriage control characters. OS File Compatability Modification: Documentation Only Restrictions have been added to the description of file compatability and conditions under which it can be accomplished are outlined. Editorial changes having no technical significance are not noted here. Specific changes to the text of this publication are indicated by a vertical bar to the left of the text. These bars will be deleted at any subsequent republication of the page affected. Preface This user's guide is intended for FORTRAN programmers who will be using the IBM System/360 OS FORTRAN IV (Gl) or Code and Go FORTRAN IV compiler and the FORTRAN IV Library (Mod I) or the FORTRAN IV (H Extended) compiler and the IBM FORTRAN IV Library (Mod II) under the control of the Conversational Monitor System component of the Virtual Machine Facility /370. It is assumed that the reader is familiar with the FORTRAN IV Language and the CMS component of VM/370. This publication is divided into 9 parts as follows: • Introduction • What You Need To Know before Using CMS and the FORTRAN IV Compilers for the First Time • Sample CMS Terminal Session • VM/370 Commands for the FORTRAN IV Programmer • CMS Programming Considerations • FORTRAN IV Programming Considerations • Using the FORTRAN IV Compilers • Loading and Executing FORTRAN TEXT files under CMS • Appendixes The "Introduction" briefly describes the operation of CMS and the relation of the FORTRAN IV compilers and libraries to that system. The part "What You Need To Know before Using CMS and the FORTRAN IV Compilers for the First Time" lists information about CMS and the compilers that a new programmer must obtain from the system administrator in his computing center before using the system. The "Sample CMS Terminal Session" illustrates a typical terminal session and introduces a less experienced user to some of the commands and techniques necessary to write, compile, and execute a FORTRAN program under CMS.