EntireX Prerequisites
This document describes the product prerequisites for the following
EntireX platforms:
Note:
Software AG supports third-party technology, for example operating
system versions, products or functionality, only for as long as this technology
is officially supported by the third-party vendor.
z/OS Prerequisites
Note:
z/OS 1.13 or higher is required for all components.
For information regarding Software AG product compatibility with IBM platforms and any IBM requirements for Software AG products,
see Product Compatibility for IBM Platforms on the Software AG website.
Component |
Prerequisites |
EntireX Broker |
|
CICS RPC Server Batch RPC Server IMS
RPC Server
|
|
Broker Stubs
|
|
Workbench |
- COBOL Wrapper
-
To compile the sources generated by the EntireX Workbench
component COBOL Wrapper: Compiler supported by the
COBOL Wrapper: standard COBOL compiler, for example IBM Enterprise COBOL for
z/OS 4.2.
-
For client side, see prerequisites for
Broker stubs.
-
For server side, an RPC server. See prerequisites for relevant RPC
server above.
- PL/I Wrapper
-
To compile the sources generated by the EntireX Workbench
component PL/I Wrapper: Compiler supported by the
PL/I Wrapper, for example PL/I for MVS & VM V1R1.1, or the newer Enterprise PL/I for z/OS V4.R1.
-
For client side, see prerequisites for
Broker stubs.
-
For server side, an RPC server. See prerequisites for relevant RPC
server above.
-
IDL Extractor for Natural To extract from z/OS, a standard Natural RPC server is required with
one of the following Natural versions. The scope of the generation depends on
the version:
-
Natural 4.2.7.4 is required for improved handling if IDL
extractions fails.
-
Natural 4.2.7 or higher is required to make use of the following
features:
-
during runtime to support a redesigned interface including
support for REDEFINE s, map to suppress etc.
-
Optional replacing of special characters
("@") in parameter names by underscore
-
Natural 4.2.6.2 or higher is required for object extractions to
make use of the features (introduced with EntireX 8.1 SP2).
-
Optional replacing of special characters
("#", "$",
"&", "/") in
parameter names by underscore
-
Hints (comments) in extracted IDL per parameter for restrictions
and usage where appropriate.
-
Support for Natural V-arrays (Natural syntax: A100/1:V). They
are mapped to IDL unbounded arrays.
-
Combinations of Natural X-array dimensions together with Natural
V-array dimensions (Natural syntax: A100/1:*,1:V) are supported. They are
mapped to IDL unbounded arrays.
-
Natural 4.2.6.1 or lower can be used, but if extracted from
objects there is no support of the features supported by Natural 4.2.6.2 (see
above).
-
Natural Wrapper To generate a client interface object, a standard Natural RPC server
is required with one of the following Natural versions. The scope of the
generation depends on the version:
To generate a server skeleton, a standard Natural RPC server is required with Natural version 4.2.7.11 or higher or Natural
8.2.2.6 or higher.
See Using the Natural Wrapper for the Server Side.
|
Attach Manager
|
The attach services supplied with Broker Services are still supported
in this version but may be replaced in the future.
|
Additional Notes for z/OS
- Entire Net-Work
-
EntireX works with any supported version of Entire Net-Work. We
recommend you use the latest version, which for z/OS is currently 6.3. The
Adabas version we recommend is 8.2.
-
Adabas Cross-Memory Services are required if you are using NET
transport or using Adabas as your persistent store.
We recommend using at least the version delivered with EntireX (WAL825).
See Installing Adabas Components for EntireX under z/OS in the z/OS installation documentation.
UNIX Prerequisites
Component |
Prerequisites |
EntireX Broker
|
|
EntireX Workbench |
- General Prerequisites
- C Wrapper
- COBOL Wrapper
-
See prerequisites for target platform, for example
z/OS |
Windows |
BS2000/OSD |
z/VSE |
IBM i.
-
For Micro Focus COBOL, Micro Focus Server Express 5.1 and Net
Express 5.1 or compatible development environment.
- Wrapper for EJB
- IDL Extractor for Natural
-
To extract from UNIX, a standard Natural RPC server is required
with one of the following versions. The scope of the extraction depends on the
version:
-
Natural 6.3.11 or higher is required for improved handling if
IDL extractions fails.
-
Natural 6.3.10 or higher is required for optional replacing of
special characters ("@") in parameter names by
underscore for object extractions.
-
Natural 6.3.9 or higher is required during runtime to support a
redesigned interface including support for REDEFINE s, suppress etc.
-
Natural 6.3.8 or higher is required for object extractions to
make use of the following features (introduced with EntireX 8.1 SP2):
-
Optional replacing of special characters
("#", "$",
"&", "/") in
parameter names by underscore
-
Hints (comments) in extracted IDL per parameter for
restrictions and usage where appropriate.
-
Support for Natural V-arrays (Natural syntax: A100/1:V). They
are mapped to IDL unbounded arrays.
-
Combinations of Natural X-array dimensions together with
Natural V-array dimensions (Natural syntax: A100/1:*,1:V) are supported. They
are mapped to IDL unbounded arrays.
-
Natural 6.3.7 or lower can be used, but if extracted from
objects, there is no support of the features supported by Natural 6.3.8 (see
above).
-
To extract from other platforms, a Natural RPC server for the
respective platform must be available, see prerequisites for target platform,
for example z/OS |
Windows |
BS2000/OSD |
IBM i.
- Natural Wrapper
-
To generate a client interface object, a standard Natural RPC
server is required with one of the following versions. The scope of the
generation depends on the version:
-
To generate a server skeleton, a standard Natural RPC server is required
with Natural version 6.3.13 or higher.
See Using the Natural Wrapper for the Server Side.
-
To generate into another platform, a Natural RPC server for the
respective platform must be available, see prerequisites for target platform,
for example z/OS |
Windows |
BS2000/OSD.
-
To generate with the default RPC environment installed in a UNIX NaturalONE environment,
the scope of the generation depends on the version:
-
NaturalONE 8.2.6 or higher is required to generate Natural RPC server skeletons (subprograms (NSNs) with their parameter data
areas (PDAs)) and adapt their names,
see Step 2: Customize Natural Server Names.
-
NaturalONE 8.2.6 or higher is required to disable/enable the generation of Natural client test programs.
See Step 2: Customize Natural Client Names.
-
NaturalONE 8.2.5 or higher is required to adapt the names for the Natural client interface objects (subprograms (NSNs) with
their parameter data areas (PDAs)).
See Step 2: Customize Natural Client Names.
-
NaturalONE 8.1.5 or higher or NaturalONE 8.2.4 or higher is required if a CVM File is used in addition to an IDL file to support features introduced with EntireX 8.2 such as multiple Natural subprogram interfaces,
REDEFINE s or map to suppress. See Redesigning the Extracted Interface in the IDL Extractor for Natural documentation.
-
NaturalONE 8.1.1 or higher or NaturalONE 8.2.1 or higher is required to generate Natural client interface objects, separate
Natural parameter data areas (PDAs) and Natural client test programs. See Step 2: Customize Natural Client Names.
- PL/I Wrapper
- XML/SOAP Wrapper, Web Services Wrapper
|
EntireX RPC
|
- General Prerequisites
- EntireX XML/SOAP Listener (formerly XML Servlet)
- XML/SOAP Wrapper Runtime
- Micro Focus RPC Server
|
WebSphere MQ RPC Server
|
-
To run the WebSphere MQ RPC Server or WebSphere MQ Listener, you need either the base Java classes or a full installation
of WebSphere MQ.
For WebSphere MQ version 7.0, 7.1 or 7.5 you need at least the JAR file com.ibm.mq.jar .
Note that this file name is subject to change in a future version of WebSphere MQ.
Check your IBM documentation for details.
|
EntireX ACI
|
- Broker Stubs
-
For Natural-based applications, all Natural versions supported by
Software AG are valid.
-
Supported transport methods: SSL and/or TCP/IP.
- Java ACI
|
EntireX administration with System Management Hub
|
|
The products listed here have been thoroughly tested and are known to work.
In most cases, more recent versions of the required components should also
work.
Additional Notes for UNIX
-
Entire Net-Work
Entire Net-Work is no longer supported as transport method under UNIX. We
recommend you use transport method TCP/IP.
-
We strongly recommend you install the latest operating system and
compiler patches.
Additional Notes for HP-UX 11.31 (11i v3)
It is required to install the following manufacturer's patch before you
start the installation: PHCO_36900.
Additional Notes for Linux (x86 and IBM
System z)
If the system is configured to run in parallel boot mode, the installed rc
scripts will not work by default. To work around this problem on SUSE
Enterprise Server, simply set RUN_PARALLEL=no
in file
/etc/sysconfig/boot.
During installation of EntireX, the Software AG Installer will ask whether
you want to install using sudo authentication or run a script after
installation. If you want to install using sudo, and you are installing on a
SUSE Linux Enterprise Server or Red Hat Enterprise Linux Server system, you
cannot use the option Defaults env_reset
. Open the sudo
configuration file /etc/sudoers and explicitly set the Defaults env_reset
option with
"!" (that is, Defaults
!env_reset
).
If you use the option Defaults env_reset
instead of following
the instructions above, you will have to use su authentication during
installation.
If you are installing on a SUSE Linux Enterprise Server or Red Hat
Enterprise Linux Server 6 system, install glibc, libgcc, pam
and ncurses RPM from your operating system distribution, using the vendor
instructions. For Red Hat
Enterprise Linux Server 6 system, additionally install compat-libstdc++.
If you are using the EntireX Workbench on SUSE Linux Enterprise Server 11 (x86-64),
install the RPM package pango-devel (64-bit) from your operating system distribution. Follow the instructions provided by
the vendor.
Additional Notes for Linux
x86
Please note that IBM Java or the GCJ Java should not be used with our
products for Linux x86 platforms. Use only Oracle or Blackdown Java for our
products on Linux x86. (Our products only support IBM Java on AIX and Linux for
IBM System z).
Windows Prerequisites
Component |
Prerequisites |
EntireX Broker
|
|
EntireX Workbench |
- General Prerequisites
- C Wrapper
-
For target platform Windows, Microsoft Visual Studio 2010.
-
For other target platforms, see prerequistites for that platform,
for example UNIX |
BS2000/OSD.
- COBOL Wrapper
-
See prerequisites for target platform, for example
z/OS |
UNIX |
BS2000/OSD |
z/VSE |
IBM i.
-
For Micro Focus COBOL, Micro Focus Server Express 5.1 and Net
Express 5.1 or compatible development environment.
-
DCOM Wrapper C++ Compiler from Microsoft Visual Studio 2010.
-
For generated interface objects: Microsoft Visual Studio .NET
2010 C/C++ runtime environment.
-
To run DCOM components that were generated with the
DCOM Wrapper, the Mini Runtime must be installed. See Mini Runtime.
-
DCOM Wrapper and .NET Wrapper Add-ins for
Microsoft Visual Studio Microsoft Visual Studio 2010
- .NET Wrapper
- Wrapper for EJB
- IDL Extractor for Natural
-
Natural 6.3.11 or higher is required for improved handling if IDL
extractions fails.
-
To extract from Windows, a standard Natural RPC server is required
with one of the following versions. The scope of the extraction depends on the
version:
-
Natural 6.3.10 or higher is required for optional replacing of
special characters ("@") in parameter names by
underscore for object extractions.
-
Natural 6.3.9 or higher is required during runtime to support a
redesigned interface including support for REDEFINE s, map to suppress etc.
-
Natural 6.3.8 or higher is required for object extractions to
make use of the features (introduced with EntireX 8.1 SP2):
-
Optional replacing of special characters
("#", "$",
"&", "/") in
parameter names by underscore
-
Hints (comments) in extracted IDL per parameter for
restrictions and usage where appropriate.
-
Support for Natural V-arrays (Natural syntax: A100/1:V). They
are mapped to IDL unbounded arrays.
-
Combinations of Natural X-array dimensions together with
Natural V-array dimensions (Natural syntax: A100/1:*,1:V) are supported. They
are mapped to IDL unbounded arrays.
-
Natural 6.3.7 or lower can be used, but if extracted from
objects, there is no support of the features supported by Natural 6.3.8 (see
above).
-
To extract from other platforms, a Natural RPC server for the
respective platform must be available, see prerequisites for target platform,
for example z/OS |
UNIX |
BS2000/OSD |
IBM i.
- Natural Wrapper
-
To generate a client interface object, a standard Natural RPC
server is required with one of the following versions. The scope of the
generation depends on the version:
-
To generate a server skeleton, a standard Natural RPC server is required
with Natural version 6.3.13 or higher.
See Using the Natural Wrapper for the Server Side.
-
To generate into another platform, a Natural RPC server for the
respective platform must be available, see prerequisites for target platform,
for example z/OS |
UNIX |
BS2000/OSD.
-
To generate with the default RPC environment installed in a Windows NaturalONE environment,
the scope of the generation depends on the version:
-
NaturalONE 8.2.6 or higher is required to generate Natural RPC server skeletons (subprograms (NSNs) with their parameter data
areas (PDAs)) and adapt their names,
see Step 2: Customize Natural Server Names.
-
NaturalONE 8.2.6 or higher is required to disable/enable the generation of Natural client test programs.
See Step 2: Customize Natural Client Names.
-
NaturalONE 8.2.5 or higher is required to adapt the names for the Natural client interface objects (subprograms (NSNs) with
their parameter data areas (PDAs)).
See Step 2: Customize Natural Client Names.
-
NaturalONE 8.1.5 or higher or NaturalONE 8.2.4 or higher is required if a CVM File is used in addition to an IDL file to support features introduced with EntireX 8.2 such as multiple Natural subprogram interfaces,
REDEFINE s or map to suppress.
See Redesigning the Extracted Interface in the IDL Extractor for Natural documentation.
-
NaturalONE 8.1.1 or higher or NaturalONE 8.2.1 or higher is required to generate Natural client interface objects, separate
Natural parameter data areas (PDAs) and Natural client test programs. See Step 2: Customize Natural Client Names.
-
PL/I Wrapper See prerequisites for target platform, for example
z/OS.
-
XML/SOAP Wrapper, Web Services Wrapper JAXP-capable XML parser. Delivered with Web Services Stack.
|
EntireX RPC
|
- General Prerequisites
- EntireX XML/SOAP Listener (formerly XML Servlet)
- XML/SOAP Wrapper Runtime
- Micro Focus RPC Server
|
WebSphere MQ RPC Server
|
-
To run the WebSphere MQ RPC Server or WebSphere MQ Listener, you need either the base Java classes or a full installation
of WebSphere MQ.
For WebSphere MQ version 7.0, 7.1 or 7.5 you need at least the JAR file com.ibm.mq.jar .
Note that this file name is subject to change in a future version of WebSphere MQ.
Check your IBM documentation for details.
|
EntireX ACI
|
- Broker Stubs
-
For Natural-based applications, all Natural versions supported by
Software AG are valid.
-
Supported transport methods: SSL and/or TCP/IP.
- Java ACI
|
EntireX administration with System Management Hub
|
|
The products listed above have been thoroughly tested and are known to
work. In most cases, more recent versions of the required components should
also work.
Additional Notes for Windows
BS2000/OSD Prerequisites
Component |
Prerequisites |
EntireX Broker |
|
Batch RPC Server |
|
Broker Stubs |
|
Workbench |
- General Prerequisites
-
EntireX Workbench version 9.6.
-
For the client side, see prerequisites for Broker stubs.
-
For the server side, an RPC server. See prerequisites for relevant
RPC server above.
-
COBOL Wrapper To compile the sources generated by the EntireX Workbench
component COBOL Wrapper: the IDL types U or UV require a compiler that
supports COBOL data type NATIONAL, for example COBOL2000 V01.4B00, otherwise
any ILCS-enabled COBOL compiler on BS2000/OSD.
-
C Wrapper To compile the applications generated by the EntireX Workbench
component C Wrapper: any ILCS-enabled C/C++ compiler on
BS2000/OSD
-
IDL Extractor for Natural To extract from BS2000/OSD, a standard Natural RPC server is required
with one of the following Natural versions. The scope of the generation depends
on the version:
-
Natural 4.2.7.4 is required for improved handling if IDL
extractions fails.
-
Natural 4.2.7 or higher is required to make use of the following
features:
-
during runtime to support a redesigned interface including
support for REDEFINE s, map to suppress etc.
-
optional replacing of special characters
("@") in parameter names by underscore for object
extractions
-
Natural 4.2.6.2 or higher is required for object extractions to
make use of the following features (introduced with EntireX 8.1 SP2):
-
Optional replacing of special characters
("#", "$",
"&", "/") in
parameter names by underscore
-
Hints (comments) in extracted IDL per parameter for restrictions
and usage where appropriate.
-
Support for Natural V-arrays (Natural syntax: A100/1:V). They are
mapped to IDL unbounded arrays.
-
Combinations of Natural X-array dimensions together with Natural
V-array dimensions (Natural syntax: A100/1:*,1:V) are supported. They are
mapped to IDL unbounded arrays.
-
Natural 4.2.6.1 or lower can be used, but if extracted from objects
there is no support of features supported by Natural 4.2.6.2 (see above).
-
Natural Wrapper To generate a client interface object, a standard Natural RPC server
is required with one of the following Natural versions. The scope of the
generation depends on the version:
To generate a server skeleton, a standard Natural RPC server is required with Natural version 4.2.7.11 or higher or Natural
8.2.2.6 or higher.
See Using the Natural Wrapper for the Server Side.
|
Additional Notes for BS2000/OSD
-
Entire Net-Work
EntireX works with any supported version of Entire Net-Work. We recommend
you use the latest version, which for BS2000/OSD is currently WCP 6.2.1.
-
The Adabas version we recommend is ADA 8.1.4.
z/VSE Prerequisites
Component |
Prerequisites |
Broker Kernel |
Product requirements:
-
z/VSE Version 5.1 or above
-
Adabas SVC 8.2.6 or above
-
If you are using Entire Net-Work, Version 6.3.1 or above
-
If you are using ADASVC transport, Adabas Limited Load libraries
(WAL826). These are provided on the installation medium.
Installation data sets:
System Resource Requirements
-
The minimum partition size for running EntireX Broker is approx. 45 MB,
using the parameter values as supplied.
By default, EntireX Broker uses DYNAMIC-MEMORY-MANAGEMENT , which means that the partition size
corresponds to the load EntireX Broker can handle. When running with ICU-CONVERSION ,
an additional 16 MB are required above the 16 MB line.
The recommended partition size is at least 100 MB.
Performance
-
Please note that with any kind of tracing switched on, performance
will be adversely affected due to the extra work load.
-
We recommend you set job priorities in the following order (highest
first):
|
Broker Stubs
|
-
z/VSE Version 5.1 or above
-
Adabas SVC 8.2.6 or above
-
WAL826
-
CSI's TCP/IP for z/VSE Version 1.5F and/or BSI's TCP/IP for z/VSE Version 2.5.3 or above
-
IBM Language Environment 1.4.4 or above
|
Security |
To run a Broker application in a secure environment, the following
prerequisites must be met:
-
The security system in the EntireX Broker kernel must be activated
with the attribute definition SECURITY=YES .
-
The kernel security exit USRSEC delivered with the Broker must be
accessible.
-
IBM Basic Security Manager must be enabled.
Note: EntireX Broker will not start if SECURITY=YES is
specified and USRSEC cannot be loaded or if IBM Basic Security Manager is not
activated.
|
Batch RPC Server |
-
z/VSE Version 5.1 or above
-
Adabas SVC 8.2.6 or above
-
WAL826
-
CSI's TCP/IP for z/VSE Version 1.5F and/or BSI's TCP/IP for z/VSE Version 2.5.3 or above
-
IBM Language Environment 1.4.4
|
CICS RPC Server |
-
z/VSE Version 5.1 or above
-
CICS TS 1.1.1
-
Adabas SVC 8.2.6 or above
-
WAL826
-
CSI's TCP/IP for z/VSE Version 1.5F and/or BSI's TCP/IP for z/VSE Version 2.5.3 or above
-
IBM Language Environment 1.4.4
|
EntireX Workbench |
- General Prerequisites
-
EntireX Workbench version 9.6.
-
For the client side, see Prerequisites for Broker Stubs.
-
For the server side, an RPC server. See prequisites for relevant RPC server above.
-
COBOL Wrapper To compile the sources generated by the EntireX Workbench: component COBOL Wrapper:
Compiler supported by the COBOL Wrapper: standard COBOL compiler, for example
IBM COBOL for VSE/ESA 1.1.1.
-
IDL Extractor for Natural Natural 8.2.3 or higher.
-
Natural Wrapper Natural 8.2.3 or higher.
|
IBM i Prerequisites
Component |
Prerequisites |
Broker Stubs |
-
IBM i 6.1, 7.1.
-
Controller that supports TCP/IP protocol.
-
Any IBM i ILE-enabled programming language.
-
TCP/IP connection to an EntireX Broker kernel on a Windows, z/OS or
UNIX platform.
-
About 16 MB of disk space for the Broker stub installation and about
50 MB for the RPC server installation.
-
Each process that includes the Broker stub occupies one additional
MB of virtual memory.
|
EntireX Workbench
|
-
COBOL Wrapper To compile the applications generated by the EntireX Workbench
component COBOL Wrapper: standard COBOL compiler defined by the
operating system.
-
IDL Extractor for Natural To extract from IBM i, the Natural RPC server must be prepared to
work together with the IDL Extractor for Natural. See Natural RPC Server Configuration for the IDL Extractor for Natural. If extracted from objects, there is no
support of the IDL Extractor for Natural features introduced with EntireX
8.1 SP2 and EntireX 8.2.
|
OpenVMS Prerequisites
Component |
Prerequisites |
Broker Stubs |
|
z/VM Prerequisites
Component |
Prerequisites |
Broker Stubs |
-
Supported z/VM Version z/VM version 6.3.
-
Adabas Version Adabas version 8.1.3 or above and Entire Net-Work 6.1.2 or
above.
Note: Maximum message size with NET transport when using the Broker
stub under z/VM is 32 KB.
-
Virtual Storage The z/VM Broker stub runs within an IBM Language Environment
enclave. This means that if the calling program is not an IBM Language
Environment, program an enclave will be automatically created, invisible to the
application. However, you must allow sufficient virtural storage to allow the
Language Environment enclave to be created. A storage size of 16 MB is
recommended.
-
ESIZE When using SYSETB under z/VM you must allow sufficient ESIZE. We
recommend setting ESIZE=64 KB.
|
Application Server Prerequisites
The Web application components of EntireX (XML/SOAP Listener,
XML/SOAP Runtime, Wrapper for EJB runtime) support J2EE 1.5.
They should therefore run on any Java application server that supports J2EE 1.5.
The EntireX components have been tested on the application server provided with the Software AG Runtime.
Supported LDAP Servers
The following LDAP servers are currently supported by EntireX:
-
IBM Tivoli Directory Server 6
-
Microsoft Active Directory Domain Services
-
Novell eDirectory 8
-
OpenLDAP 2
-
Apache Directory Server 1.5