How to Create the PCF and Run PREP

The PCF (Profiler Command File) provides greater control to select the parts of the executable program to profile. The PCF is optional and is not necessary to collect statistics about all functions of the application.

With the following PCF, the profiler collects statistics only for the main window procedure and for the About dialog box procedure in GENERIC. For more information on PCFs, see chapter 4 of the Source Profiler "User's Guide." Place the following text into the GENERIC.PCF file:
FPROFILE TIME
PROGRAM GENERIC.EXE DELETE
OBJECT GENERIC.OBJ
FUNCTION MainWndProc ADD # Note: function names are case sensitive
FUNCTION About ADD
To use this file, perform the following three steps:
1. Place the GENERIC.PCF file into the same directory as the source code for the GENERIC sample.
2. Build the GENERIC sample with debugging information (specify the /Zi compiler option switch and the /CO linker option switch).
3. Use the following command line to run the PREP utility:

PREP /P GENERIC.EXE /OT GENERIC.PBT /OI GENERIC.PBI GENERIC.PCF


For more information about the PREP utility, see Appendix A of the Source Profiler "User's Guide."

You can place the PREP command into the makefile that builds profiling versions of your application. Run the PREP utility after building the executable file.

Version 1.2 of the Microsoft Source Profiles includes two executable files: PROFILE.EXE and PROFILEW.EXE. PROFILEW.EXE is a Microsoft Windows-hosted source profile utility that can run from the command line or from an icon in the Microsoft Windows operating system. The names of batch files used to profile a Windows-based application end with the letter "W." Run these batch files from the MS-DOS prompt because each one starts Windows. You also can profile a Windows-based application in Windows.

APPLIES TO

•	Microsoft Source Profiler 1.0
•	Microsoft Source Profiler 1.2