This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
howtos:messagecapture [2007/01/20 16:41] – Fix the duplicated <code></code> tags xuesheng | howtos:messagecapture [2010/08/04 20:46] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== POPFile Message Capture utility ====== | ====== POPFile Message Capture utility ====== | ||
==== (msgcapture.exe/ | ==== (msgcapture.exe/ | ||
+ | |||
+ | |||
===== Introduction ===== | ===== Introduction ===== | ||
Line 8: | Line 10: | ||
The POPFile Message Capture Utility has been created to make it easy to capture all of the console messages output by POPFile. Instead of showing the console window used by POPFile, the utility hides the console window and displays the messages in a scrollable window. The contents of this scrollable window can be copied to the clipboard (using the right-click menu) and then saved in a text file. | The POPFile Message Capture Utility has been created to make it easy to capture all of the console messages output by POPFile. Instead of showing the console window used by POPFile, the utility hides the console window and displays the messages in a scrollable window. The contents of this scrollable window can be copied to the clipboard (using the right-click menu) and then saved in a text file. | ||
- | The Windows version of POPFile | + | |
+ | |||
+ | |||
+ | |||
+ | ===== Start Menu shortcut (0.22.5 or later) ===== | ||
+ | |||
+ | The 0.22.5 (or later) | ||
+ | |||
+ | Start -> All Programs -> POPFile -> Support -> Message Capture Utility | ||
+ | |||
+ | This shortcut can be used to start POPFile instead of the normal method. (If POPFile is already running, please shut it down before using this shortcut.) | ||
+ | |||
+ | This shortcut is intended for occasional use. If more frequent use is required it is easy to configure POPFile to use this utility whenever console mode is selected via the CONFIGURATION page in the UI. See "Using the utility instead of the console window or DOS-box" | ||
+ | |||
+ | Although the installers for POPFile 0.22.0, 0.22.1, 0.22.2, 0.22.3 and 0.22.4 install | ||
===== Using the utility instead of the console window or DOS-box ===== | ===== Using the utility instead of the console window or DOS-box ===== | ||
- | If required, the Windows version of POPFile 0.22.0 (or later) can be made to run this utility whenever ' | + | If required, the Windows version of POPFile 0.22.0 (or later) can be made to run this utility whenever ' |
This means the POPFile UI can be used to enable/ | This means the POPFile UI can be used to enable/ | ||
Line 21: | Line 38: | ||
Although this utility was created for the POPFile 0.22.0 installer, it will work with POPFile 0.20.x and 0.21.x if they were installed using the Windows installer (in some cases a small batch file will be required, see below). | Although this utility was created for the POPFile 0.22.0 installer, it will work with POPFile 0.20.x and 0.21.x if they were installed using the Windows installer (in some cases a small batch file will be required, see below). | ||
+ | |||
+ | |||
===== Debugging Aid ===== | ===== Debugging Aid ===== | ||
- | By default POPFile does not display the console messages. To help diagnose problems where POPFile does not appear to start up properly, the utility can be used to temporarily override the current configuration and display the console messages. | + | By default POPFile does not display the console messages. To help diagnose problems where POPFile does not appear to start up properly, the utility can be used to temporarily override the current configuration and display the console messages. |
+ | |||
+ | Starting with the 0.22.5 release the installer creates a Start Menu shortcut for the utility: | ||
+ | |||
+ | Start -> Programs -> POPFile | ||
+ | |||
+ | (this shortcut will work on Windows 9x as well as on more modern versions | ||
- | If you are using Windows 9x you will need to use a batch file to run the utility (see the next section) instead of just running msgcapture.exe. | + | If you prefer you can run the utility (msgcapture.exe) manually to start POPFile (instead of the normal method) but if you are using Windows 9x you will need to use a batch file to run the utility (see the next section) instead of just running msgcapture.exe. |
The Message Capture utility will perform some simple validity checks, start POPFile and display the console messages which are normally hidden. If POPFile detects a problem it sometimes shuts itself down after showing some error messages. | The Message Capture utility will perform some simple validity checks, start POPFile and display the console messages which are normally hidden. If POPFile detects a problem it sometimes shuts itself down after showing some error messages. | ||
+ | |||
===== Windows 9x systems ===== | ===== Windows 9x systems ===== | ||
+ | |||
+ | The installer for POPFile 0.22.5 (or later) creates a Start Menu shortcut for the Message Capture utility which works on Windows 9x systems. | ||
+ | |||
+ | For POPFile 0.22.4 (or earlier) a batch file is required to run the Message Capture utility on Windows 9x systems. Some installers create a suitable batch file ('' | ||
The POPFILE_ROOT and POPFILE_USER environment variables are used to find the POPFile program files and the user's POPFile configuration file. | The POPFILE_ROOT and POPFILE_USER environment variables are used to find the POPFile program files and the user's POPFile configuration file. | ||
Line 39: | Line 69: | ||
Recent Windows installers create a suitable batch file (' | Recent Windows installers create a suitable batch file (' | ||
- | If you are using an old version of POPFile then you will have to create your own batch file. For example, on a system which has POPFile 0.20.0 installed in the default location on drive C (C:\Program Files\POPFile) the following batch file can be used: | + | If you are using an old version of POPFile then you will have to create your own batch file. For example, on a system which has POPFile 0.20.0 installed in the default location on drive C ('' |
< | < | ||
Line 71: | Line 101: | ||
The Message Capture utility is included in the Windows versions of POPFile 0.22.0 or later. It can also be downloaded separately [[http:// | The Message Capture utility is included in the Windows versions of POPFile 0.22.0 or later. It can also be downloaded separately [[http:// | ||
+ | |||
===== Finding the POPFile program and POPFile data folders ===== | ===== Finding the POPFile program and POPFile data folders ===== | ||
Line 78: | Line 109: | ||
Start -> Programs -> POPFile -> Support -> PFI Diagnostic utility (simple) | Start -> Programs -> POPFile -> Support -> PFI Diagnostic utility (simple) | ||
- | This shortcut is created by the Windows installer for POPFile 0.22.0 or later. The diagnostic utility can also be downloaded separately [[http:// | + | This shortcut is created by the Windows installer for POPFile 0.22.0 or later. The diagnostic utility can also be downloaded separately [[http:// |
Should you find anything in the documentation that is incomplete, unclear, outdated or just plain wrong, please let us know and leave a note in the Documentation Forum.