
                      PGMCNTRL V1.04 Readme
                      =====================

Contents
========
1. What is the PGMCNTRL package for ?
2. Install and usage of PGMCNTRL
3. Prerequisites/Restrictions/Limitations
4. Freeware license
5. Disclaimer
6. Author




1. What is the PGMCNTRL package for ?
=====================================

PGMCNTRL is a small vio utility that allows you to perform
actions like kill and query and window functions like minimize,
maximize, restore and hide on _every_ process in the system.

You can identify the process by
  - the pid (decimal and hex (format example : 0x0E)
  - the tasklist entry ( use PGMCNTRL to determine it)
  - the simple or the fully qualified Exe-Name
    - MYPROG.EXE or D:\UTIL\MYPROG.EXE

When the driver xf86sup.sys of the XFREE86 for OS/2 package is
installed under Warp 3 Fixpack 17 or better, PGMCNTRL will also
execute a forced kill automatically, if the normal kill does not
work (no extra parameter required).



2. Install and configure PGMCNTRL
=================================

The package comes with the following files

readme               - you are reading this file
history              - revision history
file_id.diz          - package description file
pgmcntrl.exe         - the PGMCNTRL program
pgmcntrl.ico         - an icon you may want to use for
                       program objects

In order to install the program, copy the executable to a
directory of your PATH statement. If you use PGMCNTRL
also from custom WPS program objects, copy also the icon
file to the same directory, so that it is automatically
used by the program object.

NOTE:
      within the package the icon is not attached to the
EXE file, as from OS/2 Warp 4 on an attached icon is used
by WPS only for PM executables, not for VIO programs :-(
The resource compiler also attaches it as an extended
attribute, which woul well be used by the WPS, but
extended attributes can get lost (e.g. when burning creating
a tools CD-ROM).

      As a workaround we still can use the feature of
a separate icon file, which is searched for by WPS
program objects for all types of programs, so that is the
reason for the exta icon file.

NOTE:
      From v1.04 on PGMCNTRL allows to specify session titles
using regular expressions by specifying parameter /X:.....
The specified string matches any substring in entries of the
current window list. Hint: In order to search a substring
- from the beginning of window list entries, start the
  regular expression with the caret character '^'.
- at the end of window list entries, end the regular
  expression with the dollar character '$'.



3. Prerequisites/Restrictions/Limitations
=========================================

This package requires
- OS/2 Warp 3 or better
- for the "forced kill feature"
  - xf86sup.sys of the XFREE86 for OS/2 package
  - OS/2 Warp 3 FP 17 or better



4. Freeware license
===================

This software package is freeware.
It can be used wherever you use OS/2 WARP Version 3 or later.

You are allowed to freely use and distribute PGMCNTRL as
long as

 -  PGMCNTRL is not sold as a part of another program package;
 -  no fee is charged for the program other than for cost of
    media;
 -  the complete package is distributed unmodified in the
    original and unmodified zip file;
 -  you send me some e-mail telling me how you liked it (or
    didn't like it), and/or your suggestions for enhancements.



5. Disclaimer
=============

Since this program is free, it is supplied with no warranty,
either expressed or implied.

I disclaim all warranties for any damages, including, but not
limited to, incidental or consequential damage caused directly
or indirectly by this software.

All software is supplied AS IS. You may use the PGMCNTRL package
only at your own risk.

The PGMCNTRL package must not be used in states that do not allow
the above limitation of liability.



6. Author
=========

This program is written by Christian Langanke.

You can contact the author via internet e-mail.

Send your email to C.Langanke@TeamOS2.de

You can also visit my home page and download more free OS/2
utilities at:

     http://www.clanganke.de

