Connection attempt fails when using "local:" URL with CICS Transaction Gateway from WebSphere Application Server V5.x
 Technote (troubleshooting)
 
Problem(Abstract)
When using the local: URL to invoke the CICS client directly, the connection attempt fails due to a misconfiguration of the WebSphere® Application Server environment.
 
Cause
The SystemOut.log shows the sequence of exceptions:

ConnectionEve A J2CA0056I: The Connection Manager received a fatal connection error from the Resource Adaptor for resource eis/cics_resource. The exception which was received is null

ConnectionEve A J2CA0092E: This is an English only message: Event source is [com.ibm.connector2.cics.ECIManagedConnection@65a7e227 gatewayURL="local:" server="MYSERVER" Port=2006 Userid="NOT NULL" TranName=null TPNName=null TXN State=Local:no LUW assigned].

ExceptionUtil E CNTR0020E: Non-application exception occurred while processing method "myMethod" on bean "BeanId(MY_EAR#MY_EJB.jar#myBean, null)". Exception data: java.lang.NullPointerException
at com.mycode.dowork.cics.run.dorun(Run.java:51)


The trace.log with trace string:

WAS.j2c=all=enabled:RRA=all=enabled:com.ibm.connector2.*=all=enabled
shows this:
ECIManagedCon d 15:08:15:445 : [Servlet.Engine.Transports : 0:65a7e227] : Exception Logged com.ibm.connector2.cics.ECIManagedConnection
ECIManagedCon d java.io.IOException:

CCL6670E: Exception occurred in the Gateway. [java.lang.Exception:
CCL6703E: CICS Request: Load of native library failed
java.lang.UnsatisfiedLinkError: Can't find library CTGJNI (libCTGJNI.a
or .so) in java.library.path

ECIManagedCon d
java.library.path=/usr/WebSphere/AppServer/java/jre/bin:/usr/WebSphere/A
java.library.path=/usr/WebSphere/AppServer/java/jre/bin:/usr/WebSphere/A
ppServer/java/jre/bin/classic:/usr/WebSphere/AppServer/bin:/usr/mqm/java
ppServer/java/jre/bin/classic:/usr/WebSphere/AppServer/bin:/usr/mqm/java
/lib:/usr/opt/wemps/lib:/home/db2inst1/sqllib/lib::/usr/lib.]
 
Resolving the problem
The directory containing libCTGJNI.so shared library must be put on the java.library.path. This can be done in several ways.
Here are two of the methods:
  1. Edit the setupCmdLine.sh script to include the path in the LIBPATH (for AIX®) or LD_LIBRARY_PATH (for Solaris) environment variable.

    or

  2. Create an Environment Entry for the LIBPATH or LD_LIBRARY_PATH variable for the application server that is using the gateway:
    1. From the WebSphere Administrative Console, go to Servers > Application Servers > server_name > Process Definition > Environment Entries > New.
    2. Enter the Name and Value pair:
      1. Name: LIBPATH or LD_LIBRARY_PATH
      2. Value: the_path
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Application Servers Runtimes for Java Technology Java SDK
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Java 2 Connectivity (J2C)
Operating system(s): Solaris
Software version: 5.0
Software edition:
Reference #: 1181707
IBM Group: Software Group
Modified date: Oct 12, 2004