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

ELOQUENCE B.08.00 - patch PE80-0903300

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

This patch adds enhancements or fixes defects of the dbrepl utility
for Eloquence B.08.00. This patch will be integrated in the 
Eloquence B.08.00 release.

Eloquence B.08.00 must be installed before applying this patch.

Severity:
 PE80-0903300: ENHANCEMENT

Superseded patches:
 none


Patch PE80-0903300
------------------

Platforms: All

* The dbrepl utility now issues an additional exit code 3 in case
  a connection problem is detected, for example if the replication
  slave server is temporarily unavailable.

  The exit codes issued by dbrepl are:
  
  0 - successful execution, graceful exit

      (will only be issued if the -S or -G command line option is
      used and dbrepl executed normally until the existing log or
      the current generation has been processed) 

  1 - failure, typically requires manual intervention

      (for example, a configuration problem on the replication
      master or slave servers)

  2 - invalid or -help command line option

      (the command line usage was output)

  3 - connection problem

      (could not connect or lost the connection to the replication
      slave server)

  Exit code 3 may be used in a script to retry the dbrepl invocation.
  Preferably, repeated invocations should be appropriately delayed,
  for example by sleeping 60 seconds between two invocations.


Installation:
-------------

Please download the patch archive that corresponds with the installed
release.  The patch files follow the conventions below:

   PE80-0903300-hpux-ia64.tar.gz
        ^       ^    ^
        |       |    Architecture / OS specific build
        |       Operating system
        Patch ID


HP-UX:

In order to install this patch, you need to unpack it with gzip and tar.
Gzip is included with HP-UX. Installation requires root privileges.

cd /opt/eloquence/8.0
gzip -dc /path/to/PE80-0903300-hpux.tar.gz | tar xf -

Files:

   bin/dbrepl
   share/doc/PE80-0903300-README


Linux:

In order to install this patch, you need to unpack it with tar.
Installation requires root privileges.

cd /opt/eloquence/8.0
tar xzf /path/to/PE80-0903300-linux.tar.gz

Files:

   bin/dbrepl
   share/doc/PE80-0903300-README


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 PE80-0903300-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 PE80-0903300-win32.zip and unpack its contents. Then perform
the following steps:

* Please copy the dbrepl.exe file into the Eloquence bin directory
  (by default: C:\Program Files\Eloquence\bin).

* Please copy the PE80-0903300-README.txt file into the Eloquence
  share\doc directory (by default: C:\Program Files\Eloquence\share\doc).

Files:

   dbrepl.exe
   PE80-0903300-README.txt