TOC PREV NEXT INDEX

Chapter 4 Postinstallation Tasks

This chapter contains the following sections:

4.1 Applying the Visual Fortran Per-User Setup Option

After installation, every user needs to apply the Per-User Setup option before using Visual Fortran. This must be done no matter what type of license you purchased.

To apply the Per-User Setup option, select it from the Compaq Visual Fortran program folder. If you are not sure the Per-User Setup option was previously applied, it is safe to apply it multiple times for the same account.

After installing (or reinstalling) Visual Fortran, if you do not apply the Per-User Setup option, you might encounter difficulties locating the Visual Fortran driver image DF.EXE and viewing Fortran data in the visual development environment debugger. For example, you might have trouble compiling Visual Fortran programs or might not be able to view the contents of arrays within the debugger.

4.2 Specifying the COM Server Wizard as a Developer Studio Add-in (Professional and Enterprise Editions Only)

The Visual Fortran COM server wizard is implemented as a Developer Studio add-in. (An add-in lets you automate routine tasks in the Developer Studio environment.) After you install Visual Fortran, you need to register and load the COM server wizard on your system.

If you have not already done so, do the following:

  1. In the Developer Studio Tools menu, click Customize.
  2. Click the Add-ins and Macro Files tab.
  3. Turn on the checkbox for the Fortran COM server wizard if it is displayed in the list.
  4. If it is not displayed, click the Browse button and find the CSAddin.dll file in the following directory: 
    \Microsoft Visual Studio\Common\MSDev98\Addins\Df98\
  5. Click the Close button.

You only need to perform this procedure once on your system.

4.3 Performing Compilations with a Concurrent-Use License

For sites that purchased a concurrent-use license, the FLEXlm software license manager must be installed on a license server, as described in Chapter 5, Using a Concurrent-Use License.

The first time a user runs Visual Fortran, a short procedure must be followed. See Section 5.5, Running Visual Fortran for the First Time.

4.4 Copying Visual Fortran Project Files

When you create a project, you can specify where the project folder is created. If you accepted the default directory both during installation and when creating the project, the new project is created in a directory under: 

\Program Files\Microsoft Visual Studio\My Projects

You should make backup copies of your project folders periodically.

The project files for Visual Fortran Version 5 and Version 6 are different. If you open a Visual Fortran project that was created using Visual Fortran Version 5, a Visual Fortran dialog box asks you whether you want to convert the project files to Version 6 format.

If your development environment requires that you use both Version 5 and Version 6, copy the Version 5 project directory and its files to another location first, before converting the project to Version 6.

For more information, see Section 6.3, Visual Fortran Projects and the Copying Projects topic in the online Programmer's Guide.

4.5 Changing Installation Options or Reinstalling Visual Fortran

If you need to install additional components of the same Visual Fortran version, do not remove Visual Fortran. For example, if you previously performed a Typical installation and need to install additional components by using a Custom installation, perform the Custom installation without removing Visual Fortran.

You should remove Visual Fortran before reinstalling it if any of the following apply:

When reinstalling Visual Fortran, accept the previous location unless you need to install Visual Fortran on a different drive.

If you need to install Visual Fortran on a different drive, specify a different disk location using the Directory buttons. Before reinstalling Visual Fortran, you can remove Visual Fortran from the last directory locations, but you will need to copy your source and other project-related files to the corresponding directories if you specify a new location.

To remove Visual Fortran Version 6, see Section 4.10, Removing Visual Fortran Version 6 (6.0, 6.1, 6.5, 6.5A, or 6.6).

To remove Visual Fortran Version 5, see Section 4.11, Removing Visual Fortran Version 5.

To run the Visual Fortran installation procedure, see Section 3.4, Installing Visual Fortran.

4.6 Setting Up Visual Fortran Online Documentation

If you have the Microsoft MSDN online documentation installed (such as for a Microsoft Visual Studio product or subscription), the MSDN Library might be the default online documentation that you see when you run Visual Fortran.

If this is the case, you can change your default online documentation collection to be Visual Fortran.

For details on how to do this, see Section 9.9, Changing the Current Collection.

For details on using the HTML Help Viewer, see Chapter 9, Using the HTML Help Viewer.

4.7 Redistributing Visual Fortran Files

You might need to redistribute files. This means that you might need to send your Visual Fortran application files to a system that does not have your version (or a later version) of Visual Fortran installed.

Visual Fortran provides a run-time redistributables kit that you can download from the Compaq Fortran Web site to help with this redistribution. It is strongly recommended that you download this kit if you need to redistribute files. See Section 4.7.2, Using the Run-Time Redistributables Kit to Redistribute Files for details.

A separate kit is provided for applications that use Array Visualizer components. See Section 4.7.2.1, Array Viewer Run-Time Redistributables Package.

4.7.1 Which Files Might Need to be Redistributed?

If your application does not use dynamic-link libraries (it links only against static libraries), does not use the Fortran QuickWin or Fortran Standard Graphics project type, and does not use ActiveX controls in a dialog box, you do not need to redistribute any files.

If your application uses the Fortran QuickWin or Fortran Standard Graphics project type, you need only one redistribution file: FQWIN.HLP. See Section 4.7.3, Files in the Redistribution Folders. (These two project types do not use dynamic-link libraries.)

If your application uses dynamic-link libraries, you will need to redistribute certain DLLs. See Section 4.7.4, Redistributing Dynamic-Link Libraries (DLLs).

The following files may be redistributed without permission:

Other files from the Visual Fortran kit may not be redistributed.

4.7.2 Using the Run-Time Redistributables Kit to Redistribute Files

A run-time redistributables kit (also known as VFRUNxx, where xx is the version number) is provided by Visual Fortran to help you redistribute files. This kit installs redistributable run-time components.

The main advantages of using this kit rather than copying files manually are that it:

It is strongly recommended that you download this kit and run the executable if you need to redistribute any files.

To download the kit and run the executable:

  1. Open the Fortran home page at: 
    http://www.compaq.com/fortran
  2. Click on Downloads and Updates in the left margin.
  3. Click on Run-Time Redistributables Kit under the Compaq Visual Fortran heading.
  4. Download the appropriate self-installing executable for your system and run it.

For applications that use the Array Visualizer, see Section 4.7.2.1, Array Viewer Run-Time Redistributables Package.

4.7.2.1 Array Viewer Run-Time Redistributables Package

A separate run-time redistributables package is provided for applications that use Array Visualizer components.

To download the kit and run the executable:

  1. Open the Fortran home page at: 
    http://www.compaq.com/fortran
  2. Click on Downloads and Updates in the left margin.
  3. Click on Compaq Array Viewer Demo and Redistributables Kit under the Compaq Visual Fortran heading.
  4. Download the appropriate self-installing executable for your system and run it.

4.7.3 Files in the Redistribution Folders

Some of the files in the Redist folders that you can redistribute are:

Because DFORRT.DLL references MSVCRT.DLL (in \VC\Redist), you would need to copy DFORRT.DLL and MSVCRT.DLL (as well as any other DLL files referenced) to the target system. (This is done automatically by the run-time redistributables kit.)

Because DFORMD.DLL references MSVCRT.DLL (in \VC\Redist), you would need to copy DFORMD.DLL and MSVCRT.DLL (as well as any other DLL files referenced) to the target system. (This is done automatically by the run-time redistributables kit.)

Because DFDLG100.DLL references MSVCRT.DLL (in \VC\Redist), you would need to copy DFDLG100.DLL and MSVCRT.DLL (as well as any other DLL files referenced) to the target system. Also, DFDLG100.DLL must be registered on the target system. (This is done automatically by the run-time redistributables kit.)

This should be redistributed only with applications using the Fortran QuickWin or Fortran Standard Graphics project types. (This file is contained in the run-time redistributables kit.)

4.7.3.1 Redistribution Files for Array Visualizer Applications

If your application uses the Array Visualizer, you might need to redistribute the following files in the Redist folders. Note that the Array Viewer run-time distributables package (described in Section 4.7.2.1, Array Viewer Run-Time Redistributables Package) contains these files:

If the target system does not have Visual Fortran installed, the target system will need to download and install the demo file containing the Array Viewer executable.

To download the Array Viewer demo and run it:

  1. Open the Fortran home page at: 
    http://www.compaq.com/fortran
  2. Click on Downloads and Updates in the left margin.
  3. Click on Compaq Array Viewer Demo and Redistributables Kit under the Compaq Visual Fortran heading.
  4. Download the appropriate self-installing executable for your system and run it.

4.7.4 Redistributing Dynamic-Link Libraries (DLLs)

If you move an application to another system that uses Fortran DLLs, the required DLL (and any DLLs it references) must be placed on the target system before running the application.

The Fortran DLLs are used by an application (either by the .EXE or another DLL) when either of the following is true:

For example, if you run your application on the target system that uses a Fortran DLL (such as DFORRT.DLL) without copying DFORRT.DLL, the following message appears: 

The dynamic link library DFORRT.dll could not be found in the specified path ......

To view whether a DLL references other DLLs:

  1. Run Windows Explorer.
  2. Locate the CD-ROM drive that contains the Visual Fortran CD-ROM.
  3. Locate the appropriate directory (such as \Df\Redist or \VC\Redist or \x86\Redist).
  4. Select one of the DLLs you might redistribute (such as DFORRT.DLL).
  5. In the File menu, click Quick View.
  6. Scroll the displayed text to look under Import Table for information about imported DLLs.

4.7.5 Redistributing Files by Hand

If you do not use the run-time redistributables kit described in Section 4.7.2, Using the Run-Time Redistributables Kit to Redistribute Files, you can manually copy the necessary files.

Copy files from the appropriate Redist directory on the Visual Fortran
CD-ROM to one of the following directories on the target system:

For information about the DLL directory search order, see the CreateProcess Win32 API routine. When copying the DLL to the target system, make sure that you are not replacing a newer DLL with an older version.

For files that need to be registered, use the REGSVR32 utility from the Windows system directory.

For applications that use Array Visualizer components, if you do not use the run-time distributables kit described in Section 4.7.2.1, Array Viewer Run-Time Redistributables Package, see Section 4.7.3.1, Redistribution Files for Array Visualizer Applications for Array Visualizer Applications.

To develop an installation procedure for your Visual Fortran application, see File Installation Library in the Platform SDK online title in the HTML Help Viewer.

4.8 Increasing the Stack Size for Programs That Use Large Data Arrays

Certain programs use large amounts of data. In particular, with those programs that use large allocatable arrays (dynamically allocated at run time), certain tasks must be performed to provide enough stack space for the program to run.

Many kinds of variables and expressions can be allocated on the stack. If you are using array intrinsics or expressions, these can use large amounts of stack-allocated temporary storage (temporaries), even if the original variable is static or dynamically allocated.

The default stack size is 1 MB. You can increase this by specifying the linker option
/stack:nnnnn, where n is the number of bytes (in decimal) you want for the stack. In Developer Studio, choose the Project menu Settings item, select the Link tab, and add the option switch to the list of Project Options. This switch can also be specified on the DF command line.

To change the stack size of an already-linked executable, use the EDITBIN command,
/stack:nnnnn option.

Certain large programs may run into larger limits imposed by the operating system. For example, Windows NT Version 4 Service Pack 3 (or later) and Windows 98 extend the addressable range of static storage. See the Visual Fortran release notes, described in Section 2.2, Release Notes.

4.9 Installing Visual Fortran Service Update Kits

Visual Fortran service update kits provide fixes to problems discovered since the release of Visual Fortran for a particular version. For information on service update kits, see the Compaq Fortran home page at: 

http://www.compaq.com/fortran

The service update kits need to be downloaded and carefully applied. For example:

Read and follow the directions in the download area carefully.

4.10 Removing Visual Fortran Version 6 (6.0, 6.1, 6.5, 6.5A, or 6.6)

If any of the following apply, you should remove Visual Fortran before reinstalling it:

To remove Visual Fortran Version 6 (Version 6.0, 6.1, 6.5, 6.5A, or 6.6), do the following:

  1. If you are using a Windows 2000 or Windows NT 4 system, log into an account with Administrator privilege.
  2. Click the Start menu.
  3. Move the pointer to Settings, then click Control Panel.
  4. Double-click Add/Remove Programs.
  5. Within the displayed list, click Visual Fortran 6.n.
  6. Click the Add/Remove button.

This procedure removes files created by the Visual Fortran installation program and installed during the previous Visual Fortran installation. It does not remove files created by the visual development environment, such as the \Common\MSDev98\Gallery folder, as long as you installed the visual development environment files before you installed Visual Fortran.

After you remove Visual Fortran, you may also need to check and remove old environment variable definitions. See Section 4.14, Checking for and Removing Old Environment Variable Definitions.

4.11 Removing Visual Fortran Version 5

To remove Visual Fortran Version 5 from its last directory location, do the following:

  1. If you are using a Windows 2000 or Windows NT 4 system, log into an account with Administrator privilege.
  2. Click the Start menu.
  3. Move the pointer to Settings, then click Control Panel.
  4. Double-click Add/Remove Programs.
  5. Within the displayed list, click Visual Fortran Version 5.
  6. Click the Add/Remove button.

This Add/Remove Programs procedure removes files created only by the Visual Fortran Version 5 installation procedure. For example, it does not remove files created by Visual Studio Version 5 products, such as the \SharedIDE\Gallery folder.

Note:

If you have other Visual Studio Version 5 tools installed when you remove Visual Fortran Version 5, they may need to be reinstalled.

After you remove Visual Fortran, you may also need to check and remove old environment variable definitions. See Section 4.14, Checking for and Removing Old Environment Variable Definitions.

If you installed Visual Fortran Version 5 multiple times without removing Visual Fortran Version 5 before an installation, you can use the uninst command to complete the removal of additional Visual Fortran files. This extra step is no longer needed for Version 6 installations.

For example, if you originally did a Typical installation and added some Visual Fortran Version 5 components with a Custom installation, there will be multiple DeIsLn.isu files in the Visual Fortran installation folder, where n is an integer value.

If you are using a dual-boot system, before using the following procedure, use the Control Panel Add/Remove program procedure on both operating systems to remove Visual Fortran registry entries and most of the files.

To remove additional Visual Fortran Version 5 files and delete the specified DeIsLn.isu file:

  1. On a Windows 2000 or Windows NT 4 system, log into an account with Administrator privilege.
  2. Locate the correct DeIsLn.isu file in: \Program Files\DevStudio\DF

Use Windows Explorer or My Computer to look in your installation directory (by default subfolders under \Program Files\DevStudio) for files with the name DeIsLn.isu. (Each time Visual Fortran is installed, a file with this name is created using a value n. The first Visual Fortran installation creates DeIsL1.isu, the second creates DeIsL2.isu, and so on.)

If there are multiple DeIsLn.isu files, note the file with the greatest value of n.

  1. From a command window or the Run prompt, enter the following uninst command, replacing C with the actual device letter, \Program Files\DevStudio with the actual directory path, and n with the highest number of the DeIsLn.isu file: 
    uninst -f''C:\Program Files\DevStudio\DeIsLn.isu''
Note:

If there is only one DeIsLn.isu file and you have not yet used the Add/Remove Programs procedure, you should not use the uninst command.

Note:

Do not enter uninstal; enter the command as uninst.

Repeat the uninst command multiple times for each DeIsLn.isu file, always using the DeIsLn.isu file with the greatest value of n on the command line.

If you remove Visual Fortran Version 5 after you install Version 6, you need to reinstall Visual Fortran Version 6 with the same options as the current installation to reset the registry entries that are removed when you remove Visual Fortran Version 5.

4.12 Removing Internet Explorer

If you are using a Windows 2000 or Windows NT 4 system, log into an account with Administrator privilege.

If Internet Explorer was provided with your operating system (such as Windows 2000, Windows Me, or Windows 98), consult your operating system documentation about whether you can remove Internet Explorer.

To remove Internet Explorer from the last directory location:

  1. Click the Start menu.
  2. Move the pointer to Settings, then click Control Panel.
  3. Double-click Add/Remove Programs.
  4. Within the displayed list, click Microsoft Internet Explorer.
  5. Click the Add/Remove button.

For information about installing Internet Explorer, see Section 3.4.4, Installing Internet Explorer.

4.13 Removing Array Visualizer

To remove the Array Visualizer (included with the Professional and Enterprise Editions):

If you are using a Windows 2000 or Windows NT 4 system, log into an account with Administrator privilege.

  1. Click the Start menu.
  2. Move the pointer to Settings, then click Control Panel.
  3. Double-click Add/Remove Programs.
  4. Within the displayed list, click Compaq Array Visualizer.
  5. Click the Add/Remove button.

4.14 Checking for and Removing Old Environment Variable Definitions

When you installed Visual Fortran, if you allowed the setup process to update your environment variables, you need to remove these changes manually.

For example, if you have installed Visual Fortran Version 6 on a system where Visual Fortran Version 5 was previously installed, you need to check the environment variables. If you no longer need to use Version 5, you can safely remove the old Version 5 directory paths (listed in Section 2.6, Considerations for Installing with Visual Fortran Version 5). Removing unneeded Version 5 directory paths can improve Visual Fortran build performance and can eliminate the cause of certain unexpected errors.

4.14.1 Removing Environment Variable Definitions on Windows 98 and Windows 95 Systems

On Windows 98 and Windows 95 systems, make a backup copy of your AUTOEXEC.BAT file and then carefully edit the AUTOEXEC.BAT file in the root directory of your system disk:

  1. Locate lines that contain the following: 
    rem - lines added by Visual Fortran x.x.x on MM-DD-YYYY 
call x:\dirname\...\DFVARS.BAT AUTOEXEC 
rem - end of lines added by Visual Fortran x.x.x Setup

For example, environment variables defined by Visual Fortran Version 5 when the default installation directory was used might contain:

rem - lines added by Visual Fortran 5.0.0 on MM-DD-YYYY 
call C:\Program Files\DevStudio\Df\DFVARS.BAT AUTOEXEC 
rem - end of lines added by Visual Fortran 5.0.0 Setup
  1. Carefully remove each set of old lines for previous versions of Visual Fortran from this file.
  2. Save the AUTOEXEC.BAT file before you exit the editor.

4.14.2 Removing Environment Variable Definitions on Windows 2000 and Windows NT 4 Systems

On Windows 2000 and Windows NT 4 systems:

  1. Log into an account with Administrator privilege.
  2. Click the Start menu, then click Settings.
  3. Click Control Panel.
  4. Click System.
  5. Windows 2000 systems: Click the Advanced tab and then click the Environment Variables button.

Windows NT 4 systems: Click the Environment tab.

  1. View the displayed environment variables.

For example, in the System Variables, check the definitions of the Path variable, which is used by Visual Fortran and other products.:

Check the INCLUDE and LIB variables (used by Visual Fortran and other program development products).

With the Professional and Enterprise Editions, check the LINK_F90 and VNI_F90_MSG environment variables.

  1. To have the environment variable changes take effect immediately, click Apply.
  2. Click OK (to allow changes to be made) or Cancel (to not allow changes to be made.

4.14.3 Removing Environment Variable Definitions on Windows Me Systems

On Windows Me systems:

  1. Click the Start menu, then click Run.
  2. Enter MSCONFIG in the Open field, then click OK. The System Configuration utility window appears.
  3. Click the Environment tab.
  4. Follow the instructions starting at Step 6 in Section 4.14.2, Removing Environment Variable Definitions on Windows 2000 and Windows NT 4 Systems.

4.15 Updating Include and Library Paths After Installing Visual C++

Note:

The information in this section applies only to sites that installed Visual C++ Version 6.0 after installing Visual Fortran Version 6.6.

If you install Visual C++ V6.0 after Visual Fortran, the Visual C++ installation does not update the Include and Library paths used by Developer Studio to include the MFC and ATL paths. You can add these yourself as follows:

  1. Select the Options entry from the Developer Studio Tools menu.
  2. Select the Directories tab.
  3. In the Show directories for: box, choose the type of path you wish to modify (in this case, Include files).
  4. Double-click on the last (empty) entry, and use the ellipsis button to browse for the MFC\INCLUDE and ATL\INCLUDE directories and add them to the list.

Use a similar procedure to add the MFC\LIB directory to the Library Files list.

4.16 Installing f90SQL-lite

f90SQL-lite from Canaima Software is a library that makes it possible for Fortran applications to directly read and write data stored in databases that are compliant with the Open Database Connectivity (ODBC) API such as Microsoft Excel, Microsoft Access, and Oracle.

To install f90SQL-lite, insert the Visual Fortran CD-ROM and run the <cd>: F90_SQL\setup.exe file, where <cd> is the drive letter of the CD drive that contains the CD-ROM.

Note

Before you perform the installation, see the \F90_SQL\readme.txt file on the
CD-ROM, which contains installation notes.

To remove f90SQL-lite, use Add/Remove Programs in the Control Panel.

For more information about f90SQL-lite, see Section 7.9, Using f90SQL-lite.

TOC PREV NEXT INDEX