Home

About Us

Books

Free Stuff

Oh, So That's How It Works!

Fellow Magicians

Useful Links



WizardWrx Logo

P6Just1
One Instance Only!

Name

P6Just1

Version

2.51

Synopsis

P6Just1 "FQPgmName PgmArgs" "WindowTitle"

Where: FQPgmName   = Fully qualified name of program file or existing shortcut
       PgmArgs     = Command line arguments passed to program, unless included in shortcut
       WindowTitle = Title (Caption) of main window displayed by FQPgmName

Purpose:

Ensure that one instance only of FQPgmName runs. Brings existing instance into foreground or starts a new one.

Description

FQPgmName is the fully qualified name of a program, such as "C:\Program Files\Microsoft Office\Office10\MSACCESS.EXE" that you want to run. This may be any program, even a MS-DOS program.

PgmArgs is parameters (arguments), if any, that you would pass to the program if you ran it from the command line or the Run box.

WindowTitle is the title, or caption, seen in the program's main window. Use only enough to uniquely identify the program.

Note: Beginning with Version 2.50, the window caption is no longer required for 32 bit Windows programs, which can be recognized based solely on their program names.

The program handles three cases.

  1. An instance of FQPgmName is already running. Its main window is activated and given the focus.
  2. Program FQPgmName is not currently running. A new instance is started and given the focus.
  3. Program FQPgmName cannot be found. This produces a critical error.

Although P6Just1 is a 32 bit Windows program, it can control any program that is accessible to your machine. This includes 16 bit Windows 3.x program and even MS-DOS programs.

Additional Documentation

The package includes an illustrated color manual, in PDF format, which you may view on-line here.

Contents of This Package

The table below lists all the files that come in this package.

File Name

Purpose and Other Notes

P6Just1.EXE

This is the main program file.

P6Just1_Version_2_User_Manual.PDF

An expanded, illustrated version of this document.

End_User_License_Agreement.pdf

End User License Agreement (EULA) governing your use of this software.

wbdDC34i.dll

WIL language run-time DLL. This must occupy the same directory as the program file.

P6Just1 for Calculator.lnk

An example shortcut showing how P6Just1 can restrict you to a single instance of the Calculator program that comes with Windows.

Though you may copy and run P6Just1.EXE anywhere, the WIL language run-time DLL wbdDC34i.dll, must accompany it.

Note: Unless explicitly stated otherwise in the documentation, we recommend that you install of our utilities into the same directory because they use a common set of DLLs. When you install more of our utilities, you will be prompted to overwite one or more DLLs and a Cascading Style Sheet (CSS) that accompany the documentation. Please allow the updates; like named DLLs have been tested with the entire collection and found to work correctly.

Development History

The table below gives a brief development history of this program.

Date

By Whom

Version

Remarks

10/10/1999

DAG 1.00 Initial version, written for, tested, and used by one DataEase client on Windows 98, Windows ME, Windows NT, and Windows XP. Used internally on NT, 2000, and XP.

04/25/2004 DAG 1.50
  1. The WILx extender DLL is no longer required, as this version calls the MessageBoxA function directly.
  2. This version sets a return code if the program itself encounters a fatal error.
  3. Substitute the more versatile RunShell for the deprecated Run function as the program launcher.
  4. This version is digitally signed.
05/01/2004 DAG 1.51 Fix bug that prevents detection of existing window, not noticed in testing.
05/06/2004 DAG 2.00
  • Add the WILPower start-up code so that we can take advantage of code from the WILPower library.
  • " Add code to support use of the program name alone as the criterion for existence of another instance of the named program.
05/06/2004 DAG 2.01 Allow a single command line argument, since we can look up programs' windows by their class names by commenting out Error Code 102, rendering it obsolete.
05/11/2004 DAG 2.50 Use the new CountRunningCopies_P6C and Enum_Windows_P6C functions to terminate the program if another copy is already running. This should prevent additional mouse clicks from causing any harm.
03/20/2006 DAG 2.51 Incorporate new version of function WIL_Program_Begin_P6C, which corrects several obesucre and harmless problems in the initialization code.

License

This software is distributed as shareware. That is, you are free to download a copy for your own use for an evaluation period of up to 90 days and to make copies for your colleagues, who may use the copies subject to the same terms. If you give copies to your friends, you must give them the entire Zip file that you downloaded from this server.

Your use of the software is governed by the End User License Agreement which is also contained in the package and available in HTML format.

Paid licenses entitle you to technical support by email and, within reasonable limits, by telephone, and are priced as follows.

Soon, we shall be accepting payments through PayPal. For now, please remit payment by check, made payable to P6 Publishing Company to:

5006 Cloyce Court North Richland Hills, TX 76180-6944 USA

Support

This software is shareware. Support is available to registered users via email. Limited support for unregistered users is available, on a best efforts basis. Please use this form to submit your inquiry. Your inquiry will be handled on a best efforts basis, with a strong preference for registered users. Any information you send us about your specific situation will be treated as confidential. We do, however, reserve the right to incorporate any ideas we get from our correspondence with you into future versions of P6Just1 or other software either for internal use or for sale. Should we do so, we shall give full credit to its source in the accompanying documentation.

Author

David A. Gray, MBA of Simple Soft Services, Inc., d/b/a WizardWrx

Copyright

© 1999-2006 Simple Soft Services, Inc.. All rights reserved world wide.

Download your free trial copy here (494 KB).

WizardWrx Home page www.wizardwrx.com.

P6Just1 Home Page

P6C Contact Info

Copyright and Legal Notice