PGI VISUAL FORTRAN USER'S GUIDE Version 2019 TABLE OF CONTENTS Preface............................................................................................................. xi Audience Description.......................................................................................... xi Compatibility and Conformance to Standards............................................................ xi Organization....................................................................................................xii Hardware and Software Constraints...................................................................... xiii Conventions....................................................................................................xiii Terms............................................................................................................xiv Related Publications.......................................................................................... xv Chapter 1. Getting Started with PVF........................................................................ 1 1.1. PVF on the Start Screen and Start Menu............................................................. 1 1.1.1. Shortcuts to Launch PVF........................................................................... 2 1.1.2. Commands Submenu................................................................................ 2 1.1.3. Profiler Submenu.................................................................................... 2 1.1.4. Documentation Menu............................................................................... 2 1.1.5. Licensing Submenu.................................................................................. 2 1.2. Introduction to PVF...................................................................................... 3 1.2.1. Visual Studio Settings...............................................................................3 1.2.2. Solutions and Projects.............................................................................. 3 1.3. Creating a Hello World Project.........................................................................3 1.4. Using PVF Help............................................................................................6 1.5. PVF Sample Projects..................................................................................... 6 1.6. Compatibility.............................................................................................. 7 1.6.1. Win32 API Support (dfwin).........................................................................7 1.6.2. Unix/Linux Portability Interfaces (dflib, dfport)............................................... 8 1.6.3. Windows Applications and Graphical User Interfaces......................................... 8 Chapter 2. Build with PVF....................................................................................10 2.1. Creating a PVF Project................................................................................. 10 2.1.1. PVF Project Types..................................................................................10 2.1.2. Creating a New Project........................................................................... 10 2.2. PVF Solution Explorer.................................................................................. 11 2.3. Adding Files to a PVF Project.........................................................................11 2.3.1. Add a New File.....................................................................................11 2.3.2. Add an Existing File............................................................................... 12 2.4. Adding a New Project to a Solution................................................................. 12 2.5. Project Dependencies and Build Order.............................................................. 13 2.6. Configurations............................................................................................13 2.7. Platforms..................................................................................................13 2.8. Setting Global User Options........................................................................... 13 2.9. Setting Configuration Options using Property Pages...............................................14 2.10. Property Pages..........................................................................................14 PGI Visual Fortran User's Guide Version 2019 | ii 2.11. Setting File Properties Using the Properties Window............................................ 19 2.12. Setting Fixed Format..................................................................................20 2.13. Building a Project with PVF..........................................................................20 2.13.1. Order of PVF Build Operations................................................................. 21 2.14. Build Events and Custom Build Steps...............................................................21 2.14.1. Build Events....................................................................................... 21 2.14.2. Custom Build Steps...............................................................................22 2.15. PVF Build Macros.......................................................................................22 2.16. Static and Dynamic Linking.......................................................................... 22 2.17. VC# Interoperability................................................................................... 23 2.18. VC++ Interoperability..................................................................................23 2.19. Linking PVF and VC++ Projects...................................................................... 23 2.20. Common Link-time Errors............................................................................ 24 2.21. Migrating an Existing Application to PVF.......................................................... 24 2.22. Fortran Editing Features..............................................................................25 Chapter 3. Debug with PVF.................................................................................. 26 3.1. Windows Used in Debugging...........................................................................26 3.1.1. Autos Window.......................................................................................26 3.1.2. Breakpoints Window............................................................................... 26 3.1.3. Call Stack Window................................................................................. 27 3.1.4. Disassembly Window...............................................................................27 3.1.5. Immediate Window................................................................................ 27 3.1.6. Locals Window......................................................................................28 3.1.7. Memory Window....................................................................................28 3.1.8. Modules Window................................................................................... 28 3.1.9. Output Window.....................................................................................28 3.1.10. Processes Window................................................................................ 28 3.1.11. Registers Window................................................................................. 29 3.1.12. Threads Window.................................................................................. 29 3.1.13. Watch Window.................................................................................... 29 3.2. Variable Rollover........................................................................................ 29 3.2.1. Scalar Variables.................................................................................... 30 3.2.2. Array Variables..................................................................................... 30 3.2.3. User-Defined Type Variables..................................................................... 30 3.3. Debugging an MPI Application in PVF................................................................ 31 3.4. Attaching the PVF Debugger to a Running Application............................................31 3.4.1. Attach to a Native Windows Application.......................................................31 3.5. Using PVF to Debug a Standalone Executable...................................................... 32 3.5.1. Launch PGI Visual Fortran from a Native Windows Command Prompt.....................32 3.5.2. Using PGI Visual Fortran After a Command Line Launch.................................... 33 3.5.3. Tips on Launching PVF from the Command Line..............................................34 Chapter 4. Using MPI in PVF................................................................................. 35 4.1. MPI Overview.............................................................................................35 PGI Visual Fortran User's Guide Version 2019 | iii 4.2. System and Software Requirements..................................................................35 4.3. Compile using MS-MPI.................................................................................. 36 4.4. Enable MPI Execution...................................................................................36 4.4.1. MPI Debugging Property Options...............................................................