# Compaq KAP Fortran/OpenMP
for Tru64 UNIX

# User Guide

Order Number: AA--QMB5H--TE

# February 2002

This guide tells you how to use Compaq KAP Fortran/OpenMP on Compaq Tru64 UNIX systems.

Revision/Update Information: This is a revised document.

Operating System and Version: Compaq Tru64 UNIX Versions 4.0D-4.0G or 5.0-5.1

Software Version: Version 4.4
Compaq Fortran Version 5.3

Compaq Computer Corporation
Houston, Texas

© 2002 Compaq Information Technologies Group, L.P.

© 2002 Intel Corporation.

Compaq, the Compaq logo, and Tru64 are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. KAP is a trademark of Intel Corporation in the U.S. and/or other countries. UNIX is a trademark of The Open Group in the U.S. and/or other countries. All other product names mentioned herein may be trademarks of their respective companies.

Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.

Contents | Index

# Preface

This guide tells you how to use Compaq KAP Fortran/OpenMP software on Compaq Tru64 UNIX systems.

# Intended Audience

This guide is intended for KAP users working with Compaq Fortran on Compaq Tru64 UNIX systems.

# Structure of This Guide

This guide is organized into the following chapters and appendixes:

- Chapter 1 provides an introduction to Compaq KAP Fortran/OpenMP for Tru64 UNIX.
- Chapter 2 presents information on how to run Compaq KAP.
- Chapter 3 presents information on how to compile and run programs with KAP on symmetric multiprocessor systems.
- Chapter 4 describes the command-line switches used to alter KAP defaults, such as setting Compaq KAP optimization levels and enabling or disabling classes of transformations.
- Chapter 5 presents directives to alter Compaq KAP defaults. Directives are like command-line switches, except they appear within a program and may be changed on a loop-by-loop basis.
- Chapter 6 specifies KAP assertions that can provide KAP with additional information about the input program that would normally be unknown at compile time.
- Chapter 7 provides additional information on subprogram inlining, Interprocedural Analysis (IPA), and the KAP command-line switches and directives that control them.
- Chapter 8 shows examples of the transformations that KAP performs to enhance the code.
- Chapter 9 describes the information available in the optional KAP listing and the messages that KAP produces.
- Appendix A lists the Compaq extensions to Fortran 90.
- Appendix B describes data dependence analysis and explains how KAP uses this information to determine if a given loop can be optimized.
- Appendix C presents a variety of OpenMP examples.
- Appendix D describes the use of Parallel Computing Forum directives.
- Appendix E contains a warning about processing programs that violate the rules of Fortran 90.
- Appendix F lists the diagnostic messages that can appear in the optional annotated program listing.

# Associated Documentation

This guide is part of the Compaq KAP documentation set that also includes:

- Compaq KAP Fortran/OpenMP for Tru64 UNIX Cover Letter
- Compaq KAP Fortran/OpenMP for Tru64 UNIX Installation Guide
- Compaq KAP Fortran/OpenMP for Tru64 UNIX Quick Reference

To view the KAP Fortran manpage, enter: `man kf90`

# Conventions

The following are equivalent terms in this guide:

- KAP, KAP Fortran, KAP Fortran/OpenMP, Compaq KAP, Compaq KAP Fortran
- Compaq Fortran, Fortran 90

The Fortran 90 icon indicates that the section of information immediately following is unique to Fortran 90 (does not apply to Fortran 77).

Other conventions used in this guide are as follows:

Convention | Description
--- | ---
italic type | Italic type indicates complete titles of manuals and keywords, as well as product names.
lowercase | Commands are usually presented in lowercase. The KAP command line, however, is not case-sensitive.
< > | Angle brackets denote command-line input you replace with the appropriate value.
( ) | Parentheses containing a single command-line value denote the default value. For example, `(-optimize=5)` denotes 5 is the default value. Parentheses containing hyphenated value ranges denote that you choose a value from the range.
[ ] | Square brackets denote optional items.
Defaults | Unless specified otherwise, the code examples in this manual were run with the switches `-optimize=5` , `-roundoff=3` , `-scalaropt=3` , and `-unroll=1` .

Next | Contents | Index