        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 
                                                                                                                                                                                                                                                