----------------------------------------------------------------------

ELOQUENCE B.08.30 - patch PE83-2006052

----------------------------------------------------------------------

This patch adds enhancements or fixes defects of the eqsignal utility
as released with Eloquence B.08.30-1810. This patch will be integrated
in the Eloquence B.08.30 release.

Eloquence B.08.30-1810 must be installed before applying this patch.

Severity:
 PE83-2006052: ENHANCEMENT

Superseded patches:
 none


Patch PE83-2006052
------------------

Platforms: Windows

* This patch delivers the new eqsignal utility on Windows.

  This command line utility allows to send USR1 signals to trigger
  ON SIGNAL handlers. It also allows to send TERM or ABRT signals
  to terminate or abort running programs.

  usage: eqsignal.exe [options] PID [PID ...]
  options:
   -help              = show usage (this list)
   -signal|-s signal  = signal to send (number/name), default: 10 (SIGUSR1)
   -l                 = list supported signal numbers/names
   -version           = show program version

  Supported signals:
   6) SIGABRT     10) SIGUSR1     12) SIGUSR2     15) SIGTERM

  The USR1 signal triggers an ON SIGNAL handler. The TERM signal
  terminates an eloqcore process. The ABRT signal allows to print
  a segment list before aborting the process.

  The USR2 signal is reserved for future use. Currently it has
  the same effect as the ABRT signal.

  Please note:

  - On Windows, the PID (eloqcore process identifier) is equivalent
    to the TASKID of the associated program.

  - The eqsignal utility is specific to the Windows platform because
    Windows does not provide an equivalent to the HP-UX/Linux kill(1)
    utility.

  Related patches:

  - PE83-2006050 or newer (eloqcore). This patch is required.

  - PE83-2006051 or newer (eloqsd server). This patch is required.
    The SIGNAL functionality relies on a running eloqsd server.


Installation (Windows):
-----------------------

Two options are available for patch installation. The patch is
available as self extracting archive for automatic installation
and as a zip archive for manual installation. Both patches are
equivalent. Installation requires administrative capabilities.

For automatic installation of this patch, please download the patch
file PE83-2006052-win32.exe. Installation does not require a reboot
unless the patched files were active.

For a manual installation of the patch, please download the patch
file PE83-2006052-win32.zip and unpack its contents. Then perform
the following steps:

* Please copy the eqsignal.exe file into the Eloquence bin directory.
  (Default location: C:\Program Files\Eloquence\8.3\bin)

* Please copy the PE83-2006052-README.txt file into the Eloquence
  share\doc directory.
  (Default location: C:\Program Files\Eloquence\8.3\share\doc)

Files:

   eqsignal.exe
   PE83-2006052-README.txt