Prerequisites

This document covers the following topics:


General Prerequisites

  • Java 7 or Java 8 for all Java-based components. See Support of Java 8.

  • For other Software AG products if not stated otherwise: the versions that are still supported and that were available when this version of EntireX was released.

  • 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:
The supported versions of CICS and IMS are listed under Product Compatibility for IBM Platforms on the Software AG Corporate Website.

Component Prerequisites
COBOL RPC Client and Server
  • 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.

PL/I RPC Client and Server
  • To compile the sources generated by the EntireX Workbench component PL/I Wrapper:
    Compiler supported by the PL/I Wrapper, for example Enterprise PL/I for z/OS.

WebSphere MQ RPC Server and Listener
  • 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, 7.5 or 8.0 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.

Application Monitoring
  • As a general prerequisite: EntireX components of version 9.0 or above.

  • Natural RPC supports application monitoring with Natural Version 8.2.4 or above in all supported Natural environments. To enable application monitoring for Natural RPC with Natural Version 8.2.3, install the required load fix for the appropriate Natural version: Natural Version 8.2.3 for Mainframes with Zap NA93143 and with Natural RPC Version 8.2.3.2 as delivered with Natural Version 8.2.3 L002 for Mainframes.

UNIX Prerequisites

Component Prerequisites
Micro Focus COBOL
  • Micro Focus Server Express 5.1 and Net Express 5.1 or compatible development environment.

WebSphere MQ RPC Server and Listener
  • 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, 7.5 or 8.0 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.

Application Monitoring
  • As a general prerequisite: EntireX components of version 9.0 or above.

  • Natural RPC supports application monitoring with Natural Version 6.3.14 or above. To enable application monitoring for Natural RPC, install the appropriate Natural version.

Windows Prerequisites

Component Prerequisites
C Wrapper
  • For target platform Windows, Microsoft Visual Studio 2010.

DCOM Wrapper
  • C++ Compiler from Microsoft Visual Studio 2010.

  • For generated interface objects: Microsoft Visual Studio .NET 2010 C/C++ runtime environment.

.NET Wrapper
  • .NET Framework 4.0 or 4.5.x.

  • C# Compiler from Microsoft Visual Studio 2010.

Micro Focus COBOL
  • Micro Focus Server Express 5.1 and Net Express 5.1 or compatible development environment.

Microsoft Visual Studio Add-ins
  • DCOM Wrapper and .NET Wrapper add-ins for Microsoft Visual Studio:
    Microsoft Visual Studio 2010.

WebSphere MQ RPC Server and Listener
  • 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, 7.5 or 8.0 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.

Application Monitoring
  • As a general prerequisite: EntireX components of version 9.0 or above.

  • Natural RPC supports application monitoring with Natural Version 6.3.14 or above. To enable application monitoring for Natural RPC, install the appropriate Natural version.

BS2000/OSD Prerequisites

Component Prerequisites
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.

z/VSE Prerequisites

Note:
The supported versions of CICS are listed under Product Compatibility for IBM Platforms on the Software AG Corporate Website.

Component Prerequisites
Broker Kernel
  • The installation data sets require 60 MB on a 3390 disk.

  • 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.

  • 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.

Broker Stubs and RPC Servers
  • 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
  • IBM Basic Security Manager must be enabled.

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.

Application Monitoring
  • As a general prerequisite: EntireX components of version 9.0 or above.

  • Natural RPC supports application monitoring with Natural Version 8.2.4 or above in all supported Natural environments. To enable application monitoring for Natural RPC with Natural Version 8.2.3, install the required load fix for the appropriate Natural version: Natural Version 8.2.3 for Mainframes with Zap NA93143 and with Natural RPC Version 8.2.3.2 as delivered with Natural Version 8.2.3 L002 for Mainframes.

IBM i Prerequisites

Component Prerequisites
Broker Stubs
  • Controller that supports TCP/IP protocol.

  • Any IBM i ILE-enabled programming language.

  • TCP/IP connection to an EntireX Broker kernel on a z/OS, UNIX or Windows 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.

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 for the following features:

    • Optional replacement of special characters ('#', '$', '&', '/','§') in parameter names by underscore for source or object extraction. See Step 5: Select Natural Subprograms from RPC Environment under Using the Software AG IDL Extractor for Natural

    • Extracting an IDL from sources and objects 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 now supported. They are mapped to IDL unbound end arrays.

OpenVMS Prerequisites

Component Prerequisites
Broker Stubs
  • HP Integrity Server

  • OpenVMS 8.3-1H1, Update V8.0

  • OpenVMS 8.4, Update V6.0

  • HP TCP/IP Services for OpenVMS

  • HP SSL V1.4-334

z/VM Prerequisites

Component Prerequisites
Broker Stubs
  • 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 virtual 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) support J2EE 1.7 and 1.8. They should therefore run on any Java application server that supports J2EE 1.7 or 1.8.

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 Security Directory Server 6.4

  • Microsoft Active Directory Domain Services

  • Novell eDirectory 8.8

  • OpenLDAP 2.4

  • Apache Directory Server 2.0

EntireX Adapter Prerequisites

Supported Versions of Integration Server and EntireX Workbench

The EntireX Adapter supports Integration Server version 9.7, 9.8 and 9.9. For operating systems supported by the Integration Server, see https://empower.softwareag.com/Products/Documentation/default.asp under "webMethods Product Suite" > "Integration Server" > "System Requirements" (pdf). For design time, Software AG Designer version 9.7, 9.8 or 9.9 must be installed. This includes the latest version of the EntireX Workbench.

Supported Platforms

EntireX Adapter supports all platforms supported by the respective version of the Integration Server with the exception of the Mac OS platform. See https://empower.softwareag.com/Products/Documentation/default.asp under "webMethods Product Suite" > "Integration Server" > "System Requirements" (pdf).