This document describes how to install EntireX Java components under z/OS UNIX. It covers the following topics:
The following EntireX Java components can be used under z/OS UNIX:
Java RPC Server/Client
XML/SOAP RPC Server/Client
WebSphere MQ RPC Server
WebSphere MQ Listener
RPC-ACI Bridge
XML/SOAP Listener
CICS ECI RPC Server
IMS Connect RPC Server
To install EntireX Java components under z/OS UNIX
Unload the delivered installation medium to your DASD device. See Copying the Contents of the Installation Medium to Disk.
On your UNIX system, create a directory for the installation. For example:
mkdir SoftwareAG; cd SoftwareAG;
Copy the file hlq.EXXvrs.TAR
to the created directory, where hlq is your high-level qualifier and
vrs is the product version, release and service pack:
tso "oput 'hlq.EXXvrs.TAR' 'exxvrs.tar' binary"
Unpack the TAR file:
tar xvf exxvrs.tar
Now you have created a folder structure with subdirectories EntireX and
WS-Stack which contain all necessary files in several subdirectories. In the
EntireX/bin directory you have an environment file exx_zos_env.sh, which
you can source to set your environment. Before sourcing the environment, edit this file and set
the environment variable EXXDIR to your
EntireX directory. Then you can enter the following command (note the space
after the initial period):
. ./exx_zos_env.sh
Check your Java installation and edit the file exxjenv.sh in the EntireX/bin directory.
You need to set the JAVA_HOME environment variable to your corresponding Java installation.
Bourne shell scripts are provided in the EntireX/bin directory to start the different RPC servers.
To use the XML/SOAP RPC Server, configure the path to the example.xmm file.
Edit the file EntireX/config/entirex.xmlrpcserver.configuration.xml and
adapt the pathname in the exx-xmm tag.
This file is already in EBCDIC format and the encoding has been set to CP037.
If you need a different encoding, change this setting accordingly.
The following links provide more information on configuring and administering the EntireX Java components under UNIX.
| EntireX Java Component | More Information |
|---|---|
| Java RPC Server | Administering the EntireX Java RPC Server under UNIX | Windows |
| WebSphere MQ RPC Server and WebSphere MQ Listener | EntireX WebSphere MQ RPC Server |
| RPC-ACI Bridge | EntireX RPC-ACI Bridge |
| XML/SOAP RPC Server | Administering the EntireX XML/SOAP RPC Server under UNIX | Windows |
| XML/SOAP Listener | Configuring the XML/SOAP Listener under UNIX | Windows |
| CICS ECI RPC Server | CICS ECI RPC Server |
| IMS Connect RPC Server | IMS Connect RPC Server |
The following table shows the provided start script and configuration file for each RPC server.
| RPC Server | Script in EntireX/bin | Config File in EntireX/config |
|---|---|---|
| Java RPC Server | jrpcserver.bsh |
entirex.javarpcserver.properties |
| XML/SOAP RPC Server | jxmlrpcserver.bsh |
entirex.xmlrpcserver.properties |
| WebSphere MQ RPC Server | wmqbridge.bsh |
entirex.wmqbridge.properties |
| WebSphere MQ Listener | wmqlistener.bsh |
entirex.wmqbridgelistener.properties |
| RPC-ACI bridge | jrpcacibridge.bsh |
entirex.rpcacibridge.properties |
| CICS ECI RPC Server | cicseciserver.bsh |
entirex.cicseci.properties |
| IMS Connect RPC Server | imsconnectserver.bsh |
entirex.imsconnect.properties |
For the XML/SOAP Listener you need to set up a Web server and install Software AG Common Web Services Stack to this Web server.
See Deployment of Web Services Stack Web Application Runtime in section Administration of the Web Services Stack documentation.
After successful installation, copy or upload <inst_dir>/EntireX/classes/entirex.jar to the WEB-INF/lib folder in the Web Services Stack application folder.
