Appnote Text: FORTRAN 5.1 Setup Program in Batch Files

ID: Q77074

The information in this article applies to:

SUMMARY

An application note is available that consists of the FORTRAN version 5.1 Setup program in batch files. These batch files provide an alternative to the Setup program shipped with FORTRAN 5.1, for customers having problems installing.

To obtain the application note, "FORTRAN 5.1 Setup Program in Batch Files," call Microsoft Product Support Services.

MORE INFORMATION

This application note is also available in the Microsoft Software Library.

The following file is available for download from the Microsoft Software Library:

 ~ HF0483.exe (size: 56264 bytes) 

For more information about downloading files from the Microsoft Software Library, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q119591
   TITLE     : How to Obtain Microsoft Support Files from Online Services

The following is the full text of the application note:

   Microsoft Product Support Services Application Note (Text File)
           HF0483: FORTRAN 5.1 SETUP PROGRAM IN BATCH FILES
                                                  Revision Date: 10/91
                                                         Disk Included

The following information applies to Microsoft FORTRAN version 5.1.

| INFORMATION PROVIDED IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY    |
| ACCOMPANY THIS DOCUMENT (collectively referred to as an            |
| Application Note) IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY      |
| KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO    |
| THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A     |
| PARTICULAR PURPOSE. The user assumes the entire risk as to the     |
| accuracy and the use of this Application Note. This Application    |
| Note may be copied and distributed subject to the following        |
| conditions: 1) All text must be copied without modification and    |
| all pages must be included; 2) If software is included, all files  |
| on the disk(s) must be copied without modification [the MS-DOS(R)  |
| utility DISKCOPY is appropriate for this purpose]; 3) All          |
| components of this Application Note must be distributed together;  |
| and 4) This Application Note may not be distributed for profit.    |
|                                                                    |
| Copyright 1991 Microsoft Corporation. All Rights Reserved.         |
| Microsoft, MS-DOS, and the Microsoft logo are registered           |
| trademarks and Windows is a trademark of Microsoft Corporation.    |
 --------------------------------------------------------------------

This application note contains information about the Microsoft FORTRAN 5.1 Setup batch program and combined library building utility. The disk included with this application note contains the following files:

   Filename      Description
   --------      -----------

   BUILDLIB.BAT  DOS program to build libraries
   BUILDLIB.CMD  OS/2 program to build libraries
   SETUP.BAT     DOS Setup program used to install FORTRAN
   SETUP.CMD     OS/2 Setup program used to install FORTRAN
   SETUP1.BAT    First DOS setup batch file called by Setup
   SETUP1.CMD    First OS/2 setup command file called by Setup
   SETUP2.BAT    Second DOS setup batch file called by Setup
   SETUP2.CMD    Second OS/2 setup command file called by Setup

              MICROSOFT FORTRAN 5.1 BATCH SETUP UTILITY
              =========================================

The SETUP.BAT batch file copies the files from the Microsoft FORTRAN 5.1 distribution disks to your hard drive.

To use the batch file, insert the enclosed HF0483 disk in your floppy disk drive and type "setup" (without the quotation marks) at the command prompt using the syntax described in the "Usage Syntax" section below. Setup must be run from the floppy disk drive from which you intend to install FORTRAN (for example, you cannot run Setup from drive A and put the FORTRAN disks in drive B).

  NOTE: Do not execute the files SETUP1.BAT or SETUP2.BAT; they
  are companion files that are called from SETUP.BAT.

Setup modifies your PATH environment variable while it executes. If you break out of the batch file, you must reset your PATH. If Setup completes normally, your PATH will be reset automatically.

Depending on the option you select, the files copied by Setup will require the following amount of disk space:

   9.2 MB (megabyte) if all files are copied
   6.1 MB if only DOS files are copied
   6.5 MB if only OS/2 files are copied
   7.1 MB if only DOS and Windows files are copied

If you intend to build combined libraries, you will need an additional 300K of disk space for each library you build.

USAGE SYNTAX

   setup <TARGET_SYSTEM> <drive_letter> [<directory_path>]

You must specify the type of system you are installing for and a drive letter for Setup to use. The options for the target system are D for DOS, O for OS/2, W for DOS and Windows, and A for all files.

  NOTE: The target system letter must be an uppercase letter.

You also have the option of specifying a base directory path for Setup to use. Setup will copy files into sub-directories with the default names recommended by the regular Setup program (such as \BINB, \LIB, and so on).

The optional directory path should be specified with the following syntax:

   <top_level_directory> <next_level_directory> <next_level_directory>

Note that only three levels are supported and that there are spaces, NOT backslash ( \) characters, separating the directory names.

Examples

   Command                       Result
   -------                       ------

   setup D c fortran             Copies files for a DOS system onto
                                 the hard drive C in a directory
                                 called FORTRAN with subdirectories
                                 C:\FORTRAN\BINB, C:\FORTRAN\LIB, and
                                 so on

   setup A e                     Copies all files onto the hard drive
                                 E in subdirectories E:\BINB, E:\LIB,
                                 and so on

   setup W d mslang fortran f510 Copies files for a DOS and Windows
                                 system onto the hard drive D in a
                                 directory called MSLANG\FORTRAN\F510
                                 with subdirectories
                                 D:\MSLANG\FORTRAN\F510\BINB,
                                 D:\MSLANG\FORTRAN\F510\LIB, and so on

AFTER YOU RUN SETUP

After you run Setup, you must change your AUTOEXEC.BAT file and CONFIG.SYS file so that FORTRAN will run correctly. Please refer to pages 21-23 of the "Microsoft FORTRAN Installing and Using the Professional Development System" guide for information on the required changes.

For example, if you install the FORTRAN files on drive C in a directory named FORTRAN, you should make the following changes to your AUTOEXEC.BAT file:

   SET PATH=C:\FORTRAN\BINB;C:\FORTRAN\BIN;...<existing PATH>
   SET LIB=C:\FORTRAN\LIB
   SET TMP=C:\FORTRAN\BINB
   SET INIT=C:\FORTRAN\INIT
   SET INCLUDE=C:\FORTRAN\INCLUDE
   SET HELPFILES=C:\FORTRAN\HELP\*.HLP

Setup copies the files HIMEM.SYS, RAMDRIVE.SYS, and SMARTDRV.SYS to the directory specified for DOS executable files.

HIMEM.SYS allows you to debug programs that approach 640K in size by using extended memory on machines with 286, 386, or 486 CPUs.

To avoid possible conflicts, use RAMDRIVE.SYS for memory disk emulation and SMARTDRV.SYS for disk caching. Other disk emulation and disk caching programs may conflict with HIMEM.SYS.

A more detailed explanation of these three device drivers and memory configuration (expanded versus extended) is located in Chapter 2 of the "Microsoft FORTRAN Installing and Using the Professional Development System" guide on pages 24-25.

       MICROSOFT FORTRAN 5.1 COMBINED LIBRARY BUILDING UTILITY
       =======================================================

The BUILDLIB.BAT batch file builds combined libraries for Microsoft FORTRAN 5.1.

This file should be run from the \LIB subdirectory for FORTRAN 5.1. The Setup batch program copies BUILDLIB.BAT to this directory.

The following assumptions are made:

1. You have the directory that contains LIB.EXE version 3.18 or later

   in your PATH environment variable.

2. You used the Setup batch program to copy the required component
   libraries to the \LIB\COMP subdirectory, or you manually copied the
   required components to the \LIB\COMP subdirectory.

USAGE SYNTAX

   buildlib <library_name>

Where the library name is of the form:

   mLIBFfsc

The letters m, f, s, and c are placeholders for the following values:

   Placeholder  Meaning                      Values
   -----------  -------                      ------

   m            Memory model                 M (medium)
                                             L (large)

   f            Floating-point math library  A (alternate math)
                                             E (emulator)
                                             7 (8087/287/387)

   s            Operating system             R (DOS real mode)
                                             P (OS/2 protected mode)

   c            C compatibility              C (C-compatible library)
                                             [blank] (non-C-compatible
                                               library)

This information is similar to the information on pages 19 and 20 of the "Microsoft FORTRAN Installing and Using the Professional Development System" guide.

   NOTE: If you build a library with C compatibility, routines that
   are common between the two languages are LEFT OUT of the FORTRAN
   library. This means that you must always link your program with
   both the FORTRAN library and its C counterpart.

Library Name Examples

   Name      Meaning
   ----      -------

   LLIBF7R   Large model, coprocessor math library for DOS
   LLIBFER   Large model, emulation math library for DOS
   LLIBFERC  C compatible, large model, emulation math library for DOS
   MLIBF7P   Medium model, coprocessor math library for OS/2

(The .LIB extension is assumed for library names and should NOT be included when running BUILDLIB.BAT.)

If you are installing for DOS and are unsure what options to choose, we recommend that you build the LLIBFER library if you do not have a coprocessor on your machine, or the LLIBF7R library if you do have a coprocessor.

IMPORTANT: RENAMING LIBRARIES

The FORTRAN compiler uses a default naming convention different from the BUILDLIB.BAT batch file and the standard Setup program. The convention is

   mLIBFORf

where m and f have the same values as above. The naming convention does not reflect the operating system the library was created for or tell whether it is compatible with C. If you install for only one operating system, and without C compatibility, we recommend that after you use BUILDLIB.BAT to build a library, you rename the library using the mLIBFORf convention. For example: LLIBFER.LIB would be renamed LLIBFORE.LIB.

You can find more information on library naming conventions and related compiler options on pages 322-326 in Chapter 7 of the "Microsoft FORTRAN Reference" manual.

Additional query words: Keywords : kbfile kbsetup kbFortranPS

Last Reviewed: December 12, 1998