PQ75357: STEPS TO CONFIGURE CTG CONNECTORS FOR J2EE APPLICATIONS NEED TO BE CHANGED IN THE INSTALLATION & CUSTOMIZATION GUIDE.

APAR status
Closed as documentation error.

Error description
In the WebSphere "Installation and Customization" guide, chap 5,
Overview of setting up the CICS Transaction Gateway ECI
Connector for J2EE applications,
.
Currently it says,
2. Make sure the WebSphere for z/OS J2EE server can access and
load CICS module DFHXCSTB. To do so, complete one of the
following steps:
Place module DFHXCSTB in the link pack area (LPA), or
Add the CICSTS13.SDFHEXCI data set to either the system linklist
concatenation, or to a steplib concatenation defined in the
start procedure for the J2EE server region.
.
The either/or part of these paragraphs is incorrect. SDFHEXCI
must be in STEPLIB and 'program controlled' if pthread security
is used. The safe thing is to put the whole library in STEPLIB.
.
Also currently on page 325 there are a list of jar files that
get generated as a result of ar -xvf cicseciRRS.rar, the book
excluded ccf2.jar, this should be in the list.
.
Also bottom of page 326, top of page 327, there is a list of
jar files to add for the CLASSPATH environment variable for the
j2ee server - ccf2.jar is missing here as well and should be in
the list.
Local fix Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 version 4.0.1 for z/OS and OS/390            *
****************************************************************
* PROBLEM DESCRIPTION: Error in description of SDFHEXCI data   *
*                      set handling, jar files left out of     *
*                      lists.                                  *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
Need to update the SDFHEXCI data set information and add the
missing jar files to the lists.
Problem conclusion
A change to V4.0.1 WebSphere for z/OS: Installation and
Customization, GA22-7834-07 will be available in
the next refresh of the documentation. To access the latest
online documentation, go to the product library page at:

www.ibm.com/software/webservers/appserv/zos_os390/library/

The change is to page 267, which now reads:

2. Make sure the WebSphere for z/OS J2EE server can access and
   load the CICS module DFHXCSTB. To do so, complete one of the
   following steps:
   - Place module DFHXCSTB in the link pack area (LPA), or
   - Add the CICSTS13.SDFHEXCI data set to a steplib
     concatenation defined in the start procedure for the J2EE
     server region. Ensure that CICSTS13.SDFHEXCI is set to
     'program controlled.'

and page 268, which now reads:

3. Under the work directory, expand the cicseciRRS.rar file by
   entering the following command:
   jar -xvf cicseciRRS.rar
   Result: The expansion extracts the following files into the
   directory:
   - ccf2.jar
   - cicseciRRS.jar
   - cicsframe.jar
   - ctgserver.jar
   - ctgclient.jar
   - libCTGJNI.so
   - libCTGJNI_g.so
   Note: Additional files also are extracted, but you do not
         need to do anything with them.

and page 269, which now reads:

2. For the new or existing J2EE server, use the properties form
   for the server to enter the following environment variable
   values:
   - For the CLASSPATH environment variable, add the full
     directory name for the following files:
     - ccf2.jar
     - cicseciRRS.jar
     - cicsframe.jar
     - ctgserver.jar
     - ctgclient.jar
...
Temporary fix Comments
APAR information
APAR number PQ75357
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 401
Status CLOSED DOC
PE NoPE
HIPER NoHIPER
Submitted date 2003-06-17
Closed date 2003-09-11
Last modified date 2003-09-11

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros

Fix information

Applicable component levels


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 401
Software edition:
Reference #: PQ75357
IBM Group: Software Group
Modified date: Sep 11, 2003