Release Notes for iPlanet ECXpert

Version 3.6

These release notes contain important information that was unavailable when the regular documentation was being prepared.

In addition, new features and known problems are addressed here. Read this document before you begin using ECXpert Version 3.6.

An electronic version of these release notes is posted on the iPlanet documentation web site: http://docs.iplanet.com/docs/manuals/. Check the web site after installing your software and then periodically thereafter to view the most up-to-date release notes and manuals.

These release notes contain the following sections:

• "What's New in ECXpert Version 3.6"

• "Downloading ECXpert Documentation"

• "Configuring Partner Agent Server"

• "Known Problems and Limitations"

• "How to Report Problems"

• "For More Information"

---

What's New in ECXpert Version 3.6

iPlanet ECXpert Version 3.6 is a Solaris-only release, and contains:

• An XSLT Translator for translating XML input into any type of output.

• A JMS interface connector, which allows ECXpert to talk to JMS Clients; documents can be submitted to ECXpert by an application with a JMS implementation, and ECXpert can send documents to the client application.

• Various bug fixes

XSLT Translator

In previous releases of ECXpert you could only use Mercator maps to transform XML documents. ECXpert now supports the use of XSL stylesheets for transforming XML input into virtually any output format. As described in the iPlanet ECXpert Administrator's Guide, users create two XSL stylesheets: one to transform input XML into the desired output format, and another, intermediate, stylesheet to retrieve key data from the input document. The rest of the process is the same as when you use Mercator maps: create memberships, create a partnership, create a service list, and submit the document.

JMS Interface Connector

ECXpert supports JMS messaging: it lets ECXpert receive or send data using messages that conform to the Java Message Service (JMS) specification. This support is provided through two communications agents—JMSReceive (commjms-receive) and JMSSend (commjms-send). The JMSReceive communication agent retrieves JMS messages from preconfigured queue destinations on a JMS message service. Similarly, the JMSSend communication agent sends JMS messages to specified queue destinations on a JMS message service.

---

Downloading ECXpert Documentation

You can download the latest version of ECXpert documentation from:

http://docs.iplanet.com/docs/manuals/ecxpert.html

---

Configuring Partner Agent Server

To configure the Partner Agent Server:

1. Set the environment variable NSBASE to the top level directory of your ECXpert installation. For example:

   If you are using a C shell:

   % setenv NSBASE NS-apps

   If you are using a Bourne shell:

   % set NSBASE NS-apps
   % export NSBASE

2. Execute the script pascfg_exe:

   % $NSBASE/pascfg_exe

---

Known Problems and Limitations

Table 1 lists known problems in ECXpert 3.6.

Table 1    Bug Descriptions 

Bug Number	Description
N/A	The "Configuring Shared Memory and Semaphores" section in Chapter 1 of the iPlanet ECXpert Installation Guide provides recommended values for a number of operating system parameters. You should make sure these parameters are set as recommended, even if your Oracle server is installed on another machine. ECXpert processes may encounter system resource problems if these parameters are not set to proper values.
4614777	When using either the ECXpert GUI or the ecxstop utility, if you click the JMSReceive button JMSReceive appears to shut down, but its process is actually still running. If you then invoke JMSReceive from the ECXpert GUI a second JMSReceive process is spawned. At this point ECXpert will no longer be able to shut down.
4614906	In the AIAG Obtain Schedule screen if a password longer than 5 characters is entered the AIAGSend comm agent appends random characters to the password, and authentication fails.
4614954	AIAGObtain does not work when using a transactionID. A workaround is to use matching Obtain parameters.

---

How to Report Problems

If you have problems with ECXpert, contact iPlanet customer support using one of the following mechanisms:

• iPlanet online support web site at http://www.iplanet.com/support/online/

  From this location, the CaseTracker and CaseView tools are available for logging problems.

• The telephone dispatch number associated with your maintenance contract

So that we can best assist you in resolving problems, please have the following information available when you contact support:

• Description of the problem, including the situation where the problem occurs and its impact on your operation

• Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem

• Detailed steps on the methods you have used to reproduce the problem

• Any error logs or core dumps

---

For More Information

You can find useful iPlanet information at the following Internet locations:

• iPlanet release notes and other documentation — http://docs.iplanet.com/docs/manuals/

• iPlanet product status — http://www.iplanet.com/support/technical_resources/

• iPlanet Professional Services information — http://www.iplanet.com/services/professional_services_3_3.html

• iPlanet developer information — http://developer.iplanet.com/

• iPlanet learning solutions — http://www.iplanet.com/learning/index.html

• iPlanet product data sheets — http://www.iplanet.com/products/index.html

Last Updated December 19, 2001