This chapter helps you get the WorkShop Pro MPF Parallel Analyzer View running on your system. It contains the following sections:
To install the WorkShop Pro MPF software, you should have at least 16 MB of memory; 32 MB improves overall performance.
WorkShop Pro MPF requires the following software versions (or later):
IRIX system software version 6.2
MIPSpro Auto-Parallelizing Fortran 77, release 7.2.1
ToolTalk 1.1
WorkShop 2.0
Developer Magic 1.1
To determine what software is installed on your system, enter the following at the shell prompt:
% versions |
If the items mentioned in this section are not installed, consult your sales representative or (in the US) call the Silicon Graphics Technical Assistance Center at 1-(800)-800-4SGI. To order additional memory, consult your sales representative or call 1-(800)-800-SGI1.
If you have all the software and memory you need, you can install the Developer Magic: WorkShop Pro MPF software.
For general instructions about software installation, consult the man pages inst(1M) and swmgr(1M), and IRIX Admin: Software Installation and Licensing.
See also Developer Magic: WorkShop Pro MPF Release Notes for specific installation instructions.
The executable is cvpav, which is installed in /usr/sbin.
The process of using the Parallel Analyzer View involves two steps:
Compiling a program with appropriate options
Reading the compiled files with Parallel Analyzer View
Before starting the Parallel Analyzer View to analyze your Fortran source, you need to run the Auto-Parallelizing Fortran 77 compiler with the appropriate options. For the tutorials presented in subsequent chapters, Makefiles are provided. You can adapt these to your specific source or enter the following command:
% f77 -apo keep -O3sourcefile.f
The compiler generates its usual output files and an analysis file (sourcefile.anl), which the Parallel Analyzer reads.
The command-line options have the following effects:
See the MIPSpro Fortran 77 Programmer's Guide, MIPSpro Compiling and Performance Tuning Guide, and the f77(1) man page for more information.
 | Note: cvpav assumes that the -apo keep option was used on each of the Fortran source files named in an executable or fileset. If this is not the case, a warning message is posted, and the unprocessed files are marked by an error icon within the Parallel Analyzer's Subroutines and Files View. (See "Subroutines and Files View".) |
While they are not part of the Parallel Analyzer View, other parallelization reports can be generated using the following command-line options:
| -apo list | Produces a .l file, a listing of those parts of the program that can run in parallel and those that cannot. | |
| -mplist | Generates the equivalent parallelized program in a .w2f.f file. |
These reports are text files that can be used for analysis. For more detailed information, see MIPSpro Auto-Parallelizing Option Programmer's Guide.
The MIPSpro Auto-Parallelizing Fortran 77 compiler supports OpenMP directives, unless you are compiling with the -o32 option. If you put OpenMP directives in your o32 code, they are treated as comments rather than interpreted. For more information on OpenMP directives, see the following:
The OpenMP Architecture Review Board Web site at the following URL: http://www.openmp.org/
Although using OpenMP directives is recommended, MIPSpro Auto-Parallelizing Fortran 77 still supports PCF directives. For information on analyzing loops containing PCF directives see Appendix A, "Examining Loops Containing PCF Directives."
You can run the Parallel Analyzer View on any of the following objects:
a source file
an executable
a list of files
To run the Parallel Analyzer View for one of these cases, enter one of the following commands:
% cvpav -f sourcefile.f % cvpav -e executable % cvpav -F fileset-file |
cvpav reads information from all Fortran source files compiled into the application.
The Parallel Analyzer View has several other command line options, as well as several X resources that you can set. See the man page cvpav(1) for more information.
| Note: If you receive a message related to licensing when you start cvpav, refer to Chapter 7 in the WorkShop Pro MPFRelease Notes. To access the notes: enter grelnotes through the command line; choose Products > WorkShopMPF. |
For a more detailed introduction to the Parallel Analyzer View, follow one of tutorials provided with the product in the following chapters: