Version 9.5 SP1
 —  Release Notes  —

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.12 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
  • Transport Options
    • TCP-based communications: IBM TCP Stack

    • SSL-based communications: IBM GSK

    • NET-based communications: Entire Net-Work. See note below.

  • EntireX Security
    SAF-compatible security system for host z/OS compatible Broker kernel:

    • Resource classes/types and profiles as required by the installed security system. This can require a machine IPL in the case of RACF.

    • If you are using the trusted SAF user ID feature with the CICS TP monitor, set ADAGSET macro parameter SAF=YES when installing the Adabas/CICS link module.

CICS RPC Server
Batch RPC Server
IMS RPC Server
Broker Stubs
  • Transport Options
    See Broker prerequisites above.

  • Lowest Supported Applications Environment Versions
    • For CICS applications: CICS TS 3.1

    • For IMS-based applications: IMS 8

    • For Com-plete based applications: Com-plete 6.5; stub COMETB requires APS331 SP5

    • For Natural-based applications: NAT 4.2.6

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 REDEFINEs, 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
  • Transport Options
    • TCP-based communications: IBM TCP Stack

    • NET-based communications: Entire Net-Work. See note below.

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

Top of page

UNIX Prerequisites

Component Prerequisites
EntireX Broker
  • Supported transport methods: SSL and/or TCP/IP.

EntireX Workbench
  • General Prerequisites
    • Eclipse SDK 3.6 or 4.3.

    • Web Services Stack plug-ins version 9 (to install EntireX Workbench in standalone mode).

  • C Wrapper
    • 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 | Windows | 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 REDEFINEs, 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
  • 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)
    • Servlet Engine supporting Java Servlet API 2.2 or higher.

  • XML/SOAP Wrapper Runtime
    • JAXP-capable XML parser. Delivered with Web Services Stack.

  • Micro Focus RPC Server
    • Micro Focus Server 5.1 or compatible COBOL runtime environment.

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 corresponding version of System Management Hub from the webMethods suite.

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

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

Top of page

Windows Prerequisites

Component Prerequisites
EntireX Broker
  • Supported transport methods: SSL and/or TCP/IP.

EntireX Workbench
  • General Prerequisites
    • Java 7 (recommended)

    • Eclipse SDK 3.6 or 4.3.

    • Web Services Stack plug-ins 8.2 (to install EntireX Workbench in standalone mode).

  • 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 | Windows | 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
    • .NET Framework 4.0.

    • C# Compiler from Microsoft Visual Studio 2010.

  • 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 REDEFINEs, 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
  • 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)
    • Servlet Engine supporting Java Servlet API 2.2 or higher.

  • XML/SOAP Wrapper Runtime
    • JAXP-capable XML parser. Delivered with Web Services Stack.

  • Micro Focus RPC Server
    • Micro Focus Server 5.1 or compatible COBOL runtime environment.

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 corresponding version of System Management Hub from the webMethods suite.

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

Top of page

BS2000/OSD Prerequisites

Component Prerequisites
EntireX Broker
  • BS2000/OSD V6.0, V7.0, V8.0, V9.0

  • WAL814 or above

Batch RPC Server
  • BS2000/OSD V6.0, V7.0, V8.0, V9.0

  • WAL814 or above

  • If applicable, see prerequisites for C Wrapper | COBOL Wrapper.

Broker Stubs
  • BS2000/OSD V6.0, V7.0, V8.0, V9.0

  • WAL814 or above

Workbench
  • General Prerequisites
    • EntireX Workbench version 9.0.

    • 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 applications 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 REDEFINEs, 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

Top of page

z/VSE Prerequisites

Component Prerequisites
Broker Kernel Product requirements:
  • z/VSE Version 3.1 or above

  • Adabas SVC 7.4.4 or above

  • If you are using Entire Net-Work, Version 5.9.1 or above

  • If you are using ADASVC transport, Adabas Limited Load libraries (WAL744). These are provided on the installation medium. If you are using Adabas SVC 8.1.x, zap AD744008 is required.

Installation data sets:

  • The installation data sets require 60 MB on a 3390 disk.

System Resource Requirements

  • The minimum partition size for running EntireX Broker is 45 MB, using the parameter values as supplied. Increasing any of the values in the ETBnnn.ATR member e.g. NUM-LONG-BUFFERS, NUM-CONVERSATION will impact the required partition size accordingly. A realistic partition size would be 65 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):

    • POWER

    • VTAM

    • TCP-IP

    • BROKER

Broker Stubs
  • z/VSE Version 3.1 or above

  • Adabas SVC 7.4.4 or above

  • WAL744 (if you are using SVC 8.1.x, zap AD744008 is required)

  • CSI's TCP/IP for z/VSE Version 1.5E

  • If BKIMB or BKIMC is used, IBM Language Environment 1.4.4

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 3.1 or above

  • Adabas SVC 7.4.4 or above

  • WAL744 (if you are using SVC 8.1.x, zap AD744008 is required)

  • CSI's TCP/IP for z/VSE Version 1.5E

  • IBM Language Environment 1.4.4

CICS RPC Server
  • z/VSE Version 3.1 or above

  • CICS TS 1.1.1

  • Adabas SVC 7.4.4 or above

  • WAL744 (if you are using SVC 8.1.x, zap AD744008 is required)

  • CSI's TCP/IP for z/VSE Version 1.5E

  • IBM Language Environment 1.4.4

Relay Manager
  • z/VSE Version 3.1 or above

  • CSI's TCP/IP for z/VSE Version 1.5E

  • IBM Language Environment 1.4.4

Top of page

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.

Top of page

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

Top of page

z/VM Prerequisites

Component Prerequisites
Broker Stubs
  • Supported z/VM Version
    z/VM version 5.4, 6.1.

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

Top of page

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.

Top of page

Supported LDAP Servers

The following LDAP servers are currently supported by EntireX:

Top of page