Purpose

GZProMon is a command line process monitor for Windows. Its job is to examine the Windows running processes list to see whether a given executable is running. If it is, GZProMon can sleep for a configurable interval and check again. This polling process can be repeated a configurable number of times before GZProMon exits.

The primary use for GZProMon is in an ACM task list where some process has been spawned off asynchronously (using the trailing & on the parameters). If the task list must then wait until this process completes, then it can use GZProMon at the end of the task list to do so.

Command Format

The line command is of the following generic form:

gzpromon process-list <options>

process-list
is the list of processes to examine. This can be a single process executable name, e.g. myapp.exe, or a list of two or more processes separated by commas, e.g. myapp1.exe,myapp2.exe. Note that the executable names are not case-sensitive.

options is a set of zero or more options or switches. Each option is preceded by a slash (/) or dash (-). The order of options is unimportant.

The command will complete when all the processes in the process list have been found to be not running or the timeout limit has been reached. In the former case, GZProMon will exit with a completion code of zero (0). In the latter, it will exit with code one (1). Note that the /run option inverts the completion logic so that a zero return code indicates all processes are still running.

Options

This is the list of options which may appear on the command line after the process list. Options may have parameters. If so, an equal sign separates the option from its parameters. No spaces can appear around the equal sign.

Exit Codes

GZProMon exits with zero when the monitoring condition is met, i.e. when all processes are not running (by default) or when all processes are running if the /run option is used. If the condition is not met, it exits with code of one.

Example

Consider this command:

gzpromon myapp1.exe,myapp2.exe /initwait=30 /nextwait=10 /retries=5

This will wait for two programs, MYAPP1 and MYAPP2, to complete. No check of the process list will be done for 30 seconds. GZProMon will pause for 10 seconds between each check. There will be five retries or a total of 6 checks before exiting with exit code one. The maximum length of time allowed by this command for these two programs to finish is 80 seconds (5x10 + 30).

Sample Output