Description
-----------
Nonnative probe server. This patch replaces nco-p-nonnative, nco-p-nonnative-java and nco-p-nonnative-scripts.


Name
----
probe-nonnative-base

Please refer to the complete documentation on the IBM support site
for full instructions of how to use this product.
http://www.ibm.com/support/knowledgecenter


Known Issues
------------
Installation in SOLARIS Omnibus 7.4 and below.
For the system installed with nonnative probe of version earlier than release 20, its $OMNIHOME/platform/solaris2/probes64 directory contains 64-bit nco_p_nonnative.
64-bit nco_p_nonnative will *NOT* be removed when installing nonnative probe 20 or above.

Before running probe installation, do one of the following:
1. Uninstall nonnative probe, or all probes dependent on nonnative probe, Or
2. Manually remove $OMNIHOME/platform/solaris2/probes64/nco_p_nonnative


Patch Dependencies
------------------

For Netcool/OMNIbus 7.3.0:
        - common-libnetcool-5
          Fix Pack 6 or later (7.3.0.6-FP0006)

For Netcool/OMNIbus 7.3.1:
        - common-libnetcool-5
	  Fix Pack 2 or later (7.3.1.2-FP0002)


Revision History
----------------
PATCH probe-nonnative-base-21
REVISION 0
	Added the support of Java 64-bit runtime execution for Java probes on Unix and Linux platforms
	Removed the support of 32-bit nco_p_nonnative binary for Linux x86 platform

PATCH probe-nonnative-base-20
REVISION 0
	General maintenance.
	Removed the support of 64-bit nco_p_nonnative binary for Solaris due to a known issue querying non-existent probe properties

PATCH probe-nonnative-base-19
REVISION 1
        APAR IV90431 - Rebuild probe to include 32-bit Solaris binary.

REVISION 0
	General maintenance.
	Added Event Load Profiling functionality.

PATCH probe-nonnative-base-18
REVISION 1
	APAR IV75523 - Fixed a problem where the nonnative probe generated event elements with garbled characters.

REVISION 0
	64 bit support

PATCH probe-nonnative-base-17
REVISION 0
	General maintenance.

PATCH probe-nonnative-base-16
REVISION 1
	APAR IV57244 - Resolved a hang on later versions of Linux (e.g. SLES 11 SP3) when a nonnative probe is run with the '-version', '-help', or '-dumpprops' arguments.

REVISION 0
	Added support for libOpl HTTP interface

PATCH probe-nonnative-base-15
REVISION 0
	Add ability for nco_jprobe to detect IDK-written probes and behave appropriately

PATCH probe-nonnative-base-14
REVISION 1
        APAR IV11075 - Huawei U2000 Probe : Does not give -version as expected due to the DE not deploying nsprobe.jar
        The fix for APAR IV11075 was made via a change to the patch / package build environment.

REVISION 0
	Add support to query on current mode in peer-to-peer probe failover relationship.
	Added script 'set_ibm_jre.sh' to allow a probe to select the IBM JRE at runtime
	Added environment variable NCO_PROBE_JRE to allow the user to select a specific JRE at runtime

PATCH probe-nonnative-base-13
REVISION 0
	Internal maintenance changing partialbuild version.
	Removed dependency on probe-sdk-java

PATCH probe-nonnative-base-12
REVISION 1
	APAR IZ98499 - Fixed crash in Windows with Omnibus FP4 when running query commands, for examples "-version" and "-dumpprops".
	APAR IZ98504 - Fixed probe displaying "Indeterminate Date" when running in console mode. 

REVISION 0
	Separated NSHead into its own package and added dependency

PATCH probe-nonnative-base-11
REVISION 1
	Fix shutdown sequence for DataManager and probe.
	
REVISION 0
	Introduce constant-wait endpoint retry behaviour with new properties of RetryMaxTime and RetryConstantWait.
	Reduce waiting time for immediate termination during probe startup. 
	Fix occasional failure of timely probe disconnection from target system due to ineffective thread interruption.
	Fix failed probe disconnection from target system upon failure of first-time HTTP resynchronisation at startup.
	Fix ineffective property of EnableEndpointFailover.
	Fix to reset connection retry wait which was not reset during life time of probe process.

PATCH probe-nonnative-base-10
REVISION 2
	APAR IZ79683 - Move the <probe>.check.jar to $OMNIHOME/probes/java/ for Unix platform.

REVISION 1
	APAR IZ78452 - Fixed java probe not properly closed down.

REVISION 0
	Added a few utilities components to NSHead
	APAR IZ74069 - nco_jprobe now detects Java within Omnibus Installation.
       		       It also accommodates JAVA_HOME variable to be set manually if required.

PATCH probe-nonnative-base-9
REVISION 0
	Added support for generic endpoint failover functionality. (alm00132886)
	To fix probe disconnection due to premature timeout when Resync is set to false. (alm00132887)
	To include failure reason in probewatch "Unable to get events". (alm00132888)

PATCH probe-nonnative-base-8
REVISION 0
	Added new common NSHead components

PATCH probe-nonnative-base-7
REVISION 0
	Added FlushBufferInterval property

PATCH probe-nonnative-base-6
REVISION 1
	Fixed Japanese character set issue
REVISION 0
	Added UTF-8 support - this release is for the OMNIbus 7.3 beta programme
	and is not intended for general release

PATCH probe-nonnative-base-5
REVISION 1:
Added obsolete for v4

REVISION 0:
ALM 00105807 Config Analyser
Added support in nco_jprobe to run config analyser

PATCH probe-nonnative-base-4
REVISION 0:
NBS 061380 Performance enhancements
Added support for probe env files to set up CLASSPATH etc.

PATCH probe-nonnative-base-3
REVISION 0:
General maintenance release - incorporates all previous fixes since GA release 2_0

PATCH probe-nonnative-base-2
REVISION 2:
NBS55654 / APAR IZ16369 - nco_jprobe now unsets XPG_SUS_ENV variable on AIX platforms

REVISION 1:
NBS50092 / APAR IY96362	- The possibility of event duplication during the master to slave handover period has been increased.

REVISION 0:
General maintenance release - incorporates all previous fixes since GA release 1_0

PATCH probe-nonnative-base-1
REVISION 1:
The "Invalid command" and "Invalid command line" error messages from the non-native program will now get logged into the probe's messagelog file

REVISION 0:
Electronic licensing no longer implemented. Probes are now subject to the IBM Licensing agreement.

PATCH probe-nonnative-base-0
REVISION 1:
Added patches to be obsoleted.

REVISION 0:
Initial revision


Detailed Description
~~~~~~~~~~~~~~~~~~~~
This 'probe' allows probes not written in C/C++ languages to behave just like
regular C/C++ probes, with custom properties, rules file processing etc.


Client/Server relationship
==========================
In the following discussion, the non-native probe is considered to be the
client, and is the java/perl/whatever component. The native probe is considered
to be the part which talks to the ObjectServer, and is referred to as the
server.

The protocol between the client and the server component is conducted over two 
pipes, which form the standard input and standard output of the client.

The following diagram illustrates the relationship:

 +--------+  stdout   +--------+                 +------
 |        |---------->|        |     Sybase      | Object
 | Client |  stdin    | Server |<--------------->| Server
 |        |<----------|        |                 |
 +--------+        +->+--------+                 +------
     |             |
     +-------------+
          stderr

The client is started as a child process of the server. The client's standard 
error is output to the probe log file.


