CONFIGURATION GUIDE / INSTALLATION MANUAL FOR FTN4X. 1   CONFIGURATION GUIDE / INSTALLATION MANUAL FOR FTN4X.   REV.2030 800820 1                              Table of Contents   1 REQUIREMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . 1   1.1 HARDWARE . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.2 SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.3 SOFTWARE . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 LOADING THE COMPILER . . . . . . . . . . . . . . . . . . . . . . . 2 2.1 RTE-IVB SYSTEM . . . . . . . . . . . . . . . . . . . . . . . 2 2.2 RTE-L SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . 2 3 GENERATING FTN4X INTO A SYSTEM . . . . . . . . . . . . . . . . . . 3 3.1 THE COMPILER PROPER . . . . . . . . . . . . . . . . . . . . 3 3.1.1 RTE-IVB . . . . . . . . . . . . . . . . . . . . . . . 3 3.1.2 RTE-L . . . . . . . . . . . . . . . . . . . . . . . . 3 3.2 RUN-TIME LIBRARIES . . . . . . . . . . . . . . . . . . . . . 4 4 USING FTN4X . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 4.1 COMPILING PROGRAMS . . . . . . . . . . . . . . . . . . . . . 5 4.2 LOADING PROGRAMS . . . . . . . . . . . . . . . . . . . . . . 5 4.3 USING FTN4X RELOCATABLES IN A GENERATION . . . . . . . . . . 5 1   +---------------------------------------------------+------------------+ | | | | REQUIREMENTS | CHAPTER 1 | | | |   +---------------------------------------------------+------------------+   1.1 HARDWARE   FTN4X REQUIRES AN HP1000 M, E, F, OR L-SERIES COMPUTER TO RUN THE   COMPILER AND/OR THE GENERATED CODE.   1.2 SYSTEM   FTN4X REQUIRES AN RTE-IVB OR RTE-L OPERATING SYSTEM, OR SUPPORT OF THE   APPROPRIATE CLIB ENTRY POINTS AND THE ROUTINES .MVW AND IFBRK.  THE   RELOCATABLE FILES GENERATED CONFORM TO THE RTE FORMAT FOR RELOCATABLE   FILES, AS SPECIFIED FOR RTE-IVB AND RTE-L.      FTN4X REQUIRES A MINIMUM OF 13-14 PAGES. THE RECOMMENDED SIZE IS 18-20   PAGES TO ALLOW FOR SUFFICIENT SYMBOL TABLE SPACE.  IF NO PARTITION THIS   LARGE EXISTS (E.G.  ON AN RTE-L SYSTEM) THE SIZE PROGRAM WHICH MAY BE   COMPILED MAY BE SEVERELY LIMITED. ON AN RTE-IVB SYSTEM, FTN4X SHOULD BE   LOADED AS LARGE BACKGROUND, SO THAT IT MAY BE SIZED LARGER IF NECESSARY.   1.3 SOFTWARE   THE 92834 PRODUCT INCLUDES THE FOLLOWING FILES:     +------------------------------------------------------------+   | NAME PART NUMBER DESCRIPTION |   +------------------------------------------------------------+   | "FTN4X 92834-17001 THIS FILE. |   | A92834 92834-17999 SOFTWARE NUMBERING CATALOG FILE. |   | $F4XCS 92834-12001 COMMON COMPILER MODULES (LIBRARY). |   | %F4X1 92834-16002 COMPILER MODULES, PART 1. |   | %F4X2 92834-16003 COMPILER MODULES, PART 2. |   | $F4XLB 92834-12002 RUN-TIME LIBRARY. |   | $F4XDS 92834-12003 DS LIBRARY. |   | $F4XND 92834-12004 NON-DS LIBRARY. |   +------------------------------------------------------------+     THE DS FILE I/O CAPABILITY REQUIRES DS/1000-IV, PRODUCT 91750.  1 1   +---------------------------------------------------+------------------+ | | | | LOADING THE COMPILER | CHAPTER 2 | | | |   +---------------------------------------------------+------------------+   2.1 RTE-IVB SYSTEM   1) 'OF' MAIN & SEGMENTS: FTN4X, F4X.0, F4X.1, F4X.2, F4X.3, F4X.4,   F4X.5, & F4X.6 .     2) 'OF' T5IDM TO RELEASE ITS SEGMENT TABLES.      3) LOAD AS FOLLOWS:     :RU,LOADR   /LOADR: OP,LB   /LOADR: SZ,18 (OR AS DESIRED)   /LOADR: LI,$F4XCS   /LOADR: RE,%F4X1   /LOADR: RE,%F4X2   /LOADR: EN     4) 'SP' MAIN & SEGMENTS AS DESIRED.     5) 'OF' MAIN & SEGMENTS.    2.2 RTE-L SYSTEM   1) PURGE FILE FTN4X.      2) LOAD AS FOLLOWS:     :RU,LOADR   /LOADR: SG,7   /LOADR: LI,$F4XCS   /LOADR: LI,$CLIBL (INCLUDED WITH RTE-L SYSTEM)   /LOADR: RE,%F4X1   /LOADR: RE,%F4X2   /LOADR: EN   2 1   +---------------------------------------------------+------------------+ | | | | GENERATING FTN4X INTO A SYSTEM | CHAPTER 3 | | | |   +---------------------------------------------------+------------------+   3.1 THE COMPILER PROPER   3.1.1 RTE-IVB   THE COMPILER MAY BE GENERATED INTO A SYSTEM SIMPLY BY SPECIFYING THE   FILES:     $F4XCS %F4X1 %F4X2     IN THE APPROPRIATE SECTION OF THE ANSWER FILE. FTN4X MAY COEXIST WITH   FTN4 IF NECESSARY.      THE FOLLOWING ADDITIONS SHOULD BE MADE TO THE "CHANGE ENTS?" SECTION OF   THE ANSWER FILE:     Z$INT,RP,1 DEFAULT INTEGER*2   Z$LPP,RP,73 DEFAULT 59 LINES PER PAGE.     TO DEFAULT ALL INTEGERS TO INTEGER*4 (J OPTION), SET Z$INT TO 2. THE   VALUE OF Z$LPP IS THE MAXIMUM NUMBER OF LINES WHICH MAY BE PRINTED ON A   PHYSICAL PAGE, IGNORING THE FORMAT OF THE DATA. THE ACTUAL NUMBER OF   SOURCE LINES PRINTED ON A PAGE OF A LISTING WILL BE SMALLER, DUE TO THE   TITLE.      THE ENTRY POINT Z$DBL SHOULD ALREADY BE RP'D TO 3 OR 4; FTN4X USES THIS   AS FTN4 DOES TO DETERMINE THE DEFAULT PRECISION OF "DOUBLE PRECISION".    3.1.2 RTE-L   THE FTN4X COMPILER MAY NOT BE GENERATED INTO AN RTE-L SYSTEM. ON-LINE   LOAD IT.  3 1   3.2 RUN-TIME LIBRARIES   FOR SYSTEMS OF REVISION CODE 2101 OR LATER, NO SPECIAL ACTION IS   REQUIRED FOR RUN-TIME LIBRARIES. THE FILES $F4XLB, $F4XDS AND $F4XND   SHOULD BE DISCARDED.      FOR EARLIER SYSTEMS, THE RUN-TIME LIBRARIES SUPPLIED WITH THE COMPILER   MUST BE USED. IN ORDER TO GENERATE THEM INTO A SYSTEM, THE FILE $F4XLB   SHOULD REPLACE $MLIB1 IN THE GENERATION, AND EITHER $F4XDS OR $F4XND,   BUT NOT BOTH, SHOULD BE ADDED.  $F4XDS IS FOR DS SYSTEMS AND REFERENCES   "DEXEC", AND THE DS VERSION OF THE FMP ROUTINES (RFA), WHICH WILL NOT BE   FOUND IN A NON-DS GENERATION. $F4XND IS FOR NON-DS SYSTEMS AND   SATISFIES CERTAIN REFERENCES IN $F4XLB WHICH OTHERWISE WOULD BE FOUND IN   $F4XDS.     IN SHORT:     ---- (DS) -----> $F4XLB   / $F4XDS   $MLIB1   \   --- (NON-DS) --> $F4XLB   $F4XND   WHERE 'DS' REFERS TO DS/1000-IV, PRODUCT 91750. EARLIER VERSIONS MAY BE USED, BUT REMOTE CONNECTIONS WILL BE LIMITED TO LU'S (NO FILES). THE FOLLOWING ENTRY POINTS WILL BE MISSING: DXCRE DXCLO DXLOC DXPOS DXREA DXWRI THE ENTRY POINT ".DMOD" MAY SHOW UP AS A DUPLICATE IN $F4XLB AND $PLIB . IF SO, JUST IGNORE IT: THE MODULES ARE IDENTICAL. THIS ROUTINE WILL BE REMOVED FROM $PLIB AT 2101, WHEN IT IS ADDED TO $MLIB1 . 4 1   +---------------------------------------------------+------------------+ | | | | USING FTN4X | CHAPTER 4 | | | |   +---------------------------------------------------+------------------+   4.1 COMPILING PROGRAMS   TO COMPILE PROGRAMS, USE EXACTLY AS FTN4.  SEE THE FTN4X MANUAL FOR   DETAILS AND COMPILE OPTIONS.    4.2 LOADING PROGRAMS   IF THE SYSTEM IS OF REVISION CODE 2101 OR LATER, ALL REQUIRED LIBRARY   ROUTINES ARE ALREADY IN THE SYSTEM, AND NO SPECIAL LIBRARY SEARCHES ARE   REQUIRED.     IF $F4XLB AND ($F4XDS OR $F4XND) ARE GENERATED INTO THE SYSTEM, NO   SPECIAL LIBRARY SEARCHES ARE REQUIRED.      OTHERWISE, AN FTN4X RUN-TIME LIBRARY SHOULD BE CONSTRUCTED.  MERGE   $F4XLB AND ($F4XDS OR $F4XND), THE LIBRARIES SPECIFIED IN THE GENERATION   CHAPTER, CREATING A NEW LIBRARY, E.G.  $F . THIS LIBRARY MUST BE   SEARCHED WHEN FTN4X RELOCATABLES ARE LOADED.  THIS MAY BE DONE USING THE   "LI" COMMAND TO THE LOADR.  FOR LOADS OF SINGLE RELOCATABLES, IT IS   CONVENIENT TO HAVE A LOADR COMMAND FILE WITH JUST THE COMMAND "LI,$F";   IF THIS FILE IS CALLED *F, THEN A SINGLE RELOCATABLE FILE "%ABC" MAY BE   LOADED WITH THE COMMAND:     :RU,LOADR,*F,%ABC     WHEN THE SYSTEM IS UPDATED TO REVISION CODE 2101, THESE LIBRARIES SHOULD   BE DISCARDED.     SEE THE SECTION ON "GENERATION" FOR RESTRICTIONS ON DS.   4.3 USING FTN4X RELOCATABLES IN A GENERATION   ALL FTN4X MAIN PROGRAMS CONTAIN ENTRY POINTS WHICH ARE ALSO FOUND IN THE   RUN-TIME LIBRARIES. THEREFORE, FTN4X MAIN PROGRAMS MAY NOT BE GENERATED   INTO A SYSTEM.    5 1   FTN4X SUBPROGRAMS MAY BE GENERATED INTO A SYSTEM AS LIBRARY ROUTINES,   BUT THEY SHOULD NOT BE USED BY ANY PROGRAM LOADED BY THE GENERATOR. 6