XJWEB Web Adapter

XJWEB is the XFRAME web adapter for XCICS. Its goal is to make available on the WWW data coming form XCICS transaction.

XJWEB is based on JSP/Servlet technology and require a J2EE compatible web server (i.e. Tomcat).

By default XJWEB provides a simple HTML refacing function. It means that no re-arrangement is made to the BMS map sent by XCICS, and the HTML shown by the browser will look very similar to the original 3270 screen.

Otherwise, user may provide its own JSP in order to completely re-arrange the BMS map sent by XCICS and to give a completely new look & feel to the old map.

XJWEB is composed by two main components:

The communication module aim is to connect and exchange data with XCICS. It is based on the X4J communication module.

XJWEB is like a normal terminal: it connects XCICS, it works then disconnects. The connection between XCICS and the XJWEB object for the user web session is permanent. Therefore it is very important to correctly define the session timeout, because XJWEB automatically provides disconnection when session is timed out.

The webifier module is the module that allows the transformation of data received by XCICS, in a more programmer-friendly data format. It also provides a set of programming API to make easier the work of the JSP programmers.

XJWEB requires the XCICS transactions to be coded as a pure standard pseudo-conversational programs, that mean that each transaction must be composed by:

Any other structure may cause unpredictable results (for such situations refer the XJEB/3270 wrapper below).

This documentation assumes you are using Tomcat 4.1 as Java Web Server.

The XJWEB/3270 wrapper

Under some circumstances, the coding of the on line program may result incompatible with the standard required by the XJWEB framework.

In these situations, the XJWEB/3270 servelet may be used. This servlet acts as real terminal emulator, wrapping the underlying 3270 video memory to HTML, enabling the access to the application using a standard web browser without make use of any additional components by the client side.