FORTRAN 5.1 Setup Program in Batch Files (77074)



The information in this article applies to:

  • Microsoft FORTRAN Compiler for MS-DOS 5.1
  • Microsoft FORTRAN compiler for OS/2 5.1

This article was previously published under Q77074

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

The following file is available for download from the Microsoft Download Center:
For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:

119591 How to Obtain Microsoft Support Files from Online Services

Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help to prevent any unauthorized changes to the file. 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.
				

Modification Type:MinorLast Reviewed:8/4/2004
Keywords:kbdownload kbfile kbinfo kbsetup KB77074