PQ69795: MANUALS CONTAIN NO DOCUMENTATION FOR USING JAVA AWT CLASSES

APAR status
Closed as documentation error.

Error description
Program Directory states that java AWT classes are supported
but there is no documentation on the steps to setup a proper
environment for them to function.  There is one statement but
it appears to be wrong or incomplete.
  Testing an AWT app in the plugin, it appears that:
1) environment variable DISPLAY must be set in httpd.envvars
 DISPLAY=x.xx.xx.xx:0.0
2) variables LANG and LC_ALL must be set to "C" in httpd.envvars
 LANG=C   and   LC_ALL=C
3) LIBPATH in httpd.envvars needed to have /usr/lib added to
 the concatenation so we picked up Xm.dll and X11.dll
----------------------------------------------------------------
We have been unable to run a java AWT app in the webcontainer
at this time, so we have not been able to test that environment.
----------------------------------------------------------------

The program directory states that you need to perform an
export DISPLAY=x.xx.xx.xx command, but it appears that is to
run an AWT app from omvs outside of WebSphere
Local fix
HBC
Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V4.0.1 for z/OS and OS/390.                  *
*                                                              *
****************************************************************
* PROBLEM DESCRIPTION: The "WebSphere Application Server       *
*                      V4.0.1 for z/OS and OS/390 Program      *
*                      Directory" states that Java AWT classes *
*                      are supported, but there is no          *
*                      documentation on the steps required     *
*                      to setup an environment in which they   *
*                      can run .                               *
*                                                              *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The "WebSphere Application Server V4.0.1 for z/OS and OS/390
Program Directory" states that Java AWT classes are supported,
but there is no documentation on the steps required to setup
an environment in which they can run. A description of the
required setup needs to be added to "WebSphere Application
Server V4.0.1 for z/OS and OS/390: Assembling J2EE
Applications," SA22-7836.
Problem conclusion
The following note will be added to
the first step in Chapter 2. Overview of application development
and tools of "WebSphere Application Server V4.0.1 for z/OS and
OS/390:Assembling J2EE Applications," SA22-7836:

   c. Java AWT classes are supported but an application
      containing a Java AWT class must be hosted in the Local
      Redirector Plug-in. If you want to use Java AWT classes,
      you must make the following changes to the HTTP Server's
      httpd.envvars file:

      1. Set the DISPLAY environment variable to "x.xx.xx.xx:0.0
         where x.xx.xx.xx:0.0 is the XWindows environment variab
         stating the IP address of the XTerminal.
      2. Set the LANG and LC_ALL environment variables to "C".
      3. Add "/usr/lib" to the LIBPATH so that you pick up Xm.dl
         and X11.dll

More information about using AWT classes is available at URL:
        
http://java.sun.com/products/jdk/awt/

NOTE: Periodically, we refresh the documentation on our
Web site, so the changes might have been made before you
read this text. To access the latest on-line
documentation, go to the product library page at:


http://www.ibm.com/software/webservers/appserv/zos_os390/library
.html

APAR 
PQ69797 has been opened to add Java AWT classes support for
applications hosted in the Web container.
Temporary fix Comments
APAR information
APAR number PQ69795
Reported component name WEBSPHERE OS/39
Reported component ID 5655A9800
Reported release 401
Status CLOSED DOC
PE NoPE
HIPER NoHIPER
Submitted date 2003-01-13
Closed date 2003-06-18
Last modified date 2003-06-18

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 #: PQ69795
IBM Group: Software Group
Modified date: Jun 18, 2003