EntireX Version 9.7
 —  Release Notes  —

What's New

This document describes the new functionality in EntireX version 9.7 and also significant changes and enhancements provided in fixes since the original release.


Installation to C:\Program Files

Under Windows, Software AG Designer and plugins can now be installed to directory C:\Program Files.

Top of page

Increased Platform Support

Red Hat Enterprise Linux AS 7 is now supported on 64-bit platforms.

Top of page

Support of Java 8

EntireX version 9.7 now supports Java 8. The following components are affected:

[Provided with EXX_9.7.0_Fix2.]

Java Wrapper

When generating Java RPC clients (Bean-compliant) with the Java Wrapper, the name generation rules have changed slightly to ensure greater consistency. This means a name used for more than one IDL group parameter with different content is always changed. See example below.

Sample IDL file:

LIBRARY 'example' is
      PROGRAM 'progA' is
         DEFINE DATA PARAMETER
            1 groupparm IN
               2 parm (A10)
         END-DEFINE

      PROGRAM 'progB' is
         DEFINE DATA PARAMETER
            1 groupparm OUT
               2 parm (I4)
         END-DEFINE

Generated Java sources with new generation rules:

Generated Java sources with old generation rules:

  • Example.java

  • Groupparm.java

  • Progbgroupparm.java

or
  • Example.java

  • Groupparm.java

  • Progagroupparm.java

Start of instruction setTo migrate an application that needs to be regenerated

IDL Extractor for WSDL

Prefix name assigning has been enhanced to ensure consistent generation of XML mapping files. If more than one prefix is associated with a URL, the last prefix (in alphabetical order) is used. For example, the WSDL contains following namespace definition:

xml:sampleNamespace="http://sample.org"

and

xml:anotherNamespace="http://sample.org"

In this case, prefix sampleNamespace is used (comes after anotherNamespace in alphabetical order).

This has no influence on the namespace used in the XML/SOAP document. If application has such a case and the receiving web service expected an specific prefix name (because it does not check the namespace), open the XML Mapping Editor and change the prefix on affected elements and attributes.

Top of page

COBOL Support

Using Data Length to Process a Variable Number of Array Elements

The EntireX Workbench, together with the CICS RPC Server, EntireX Adapter with IMS Connect connections and the IMS Connect RPC Server support COBOL server programs that use the data length of its interface to process a variable number of array elements in a fixed-size COBOL table. For more information see the example COBOL Server Using Data Length to Process a Variable Number of Array Elements provided for the interface types

Note:
COBOL server programs use either the same data structure on input and output, or overlay the input data structure with a different output data structure. See COBOL Mapping Editor.

[Provided with EXX_9.7.0_Fix3.]

Server Mapping Files for COBOL

If a COBOL server is wrapped with the COBOL Wrapper or extracted with the IDL Extractor for COBOL, a server mapping file is automatically created if required. Previous versions of EntireX support server-side mapping files (extension .svm) for COBOL only. These files need to be deployed to the target RPC server. This version supports client-side mapping files (extension .cvm) as an alternative. This simplifies the handling of server mapping files. This can be an important criterion, for example if the RPC server is hosted in a mainframe environment and you do not have access to mainframe development resources. The following tasks are not required:

Server-side mapping files can be migrated to client-side mapping files, see Migrating Server Mapping Files. Please note that client-side mapping files are not supported by RPC clients generated with the DCOM Wrapper and COBOL Wrapper. For more information on server mapping files, see Server Mapping Files for COBOL.

Top of page

RPC Server/Listener Changes and Enhancements

Top of page

z/OS Broker in 64-bit Addressing Mode

EntireX Broker under z/OS now runs in 64-bit addressing mode (AMODE). Earlier versions ran in 31-bit mode, which meant you could address up to 2 GB of storage locations. This limit is referred to as "the bar". 64-bit mode takes EntireX Broker above the bar and means that up to 16 EB (exabytes) can be addressed. This increase in capacity makes it possible to send and receive an almost unlimited amount of messages. The maximum size of a single message is still limited to 2 GB.

The attribute file does not need to be changed for the 64-bit Broker. The one exception here is PSTORE-VERSION. See PSTORE-VERSION for Persistent Store of Type DIV under Other Changes and Enhancements below.

All user exits for conversion and translation run unchanged in 31-bit mode. However, if you have written your own security exits, these need to be 64-bit-enabled.

Top of page

Application Monitoring

Application Monitoring is an EntireX feature that enables you to monitor the response times in your distributed applications, and it also enables you to monitor certain error situations. The EntireX Application Monitoring Data Collector collects the response time data of each involved software component of selected synchronous EntireX RPC services. The Application Monitoring Data Collector stores the KPI values in CSV (comma-separated values) files. The files can be processed by any tool that supports CSV files. A sample MashApp is also provided.

Application Monitoring was previously offered as part of the Software AG product Optimize for Infrastructure.

See Application Monitoring.

Top of page

Support of Long N/NU/P/PU Data Types

The maximum number of digits for IDL data types N, NU, P and PU has been increased from 29 to 99, and the restriction of 7 digits after the decimal point no longer applies. See IDL Data Types.

Depending on your target programming language (endpoint) the supported number of digits is more restricted. If you connect two endpoints, the total number of digits used must be lower than or equal to the maxima of both endpoints. For the supported total number of digits for endpoints, see the notes under data types N, NU, P and PU under Mapping IDL Data Types to target language environment C | CL | COBOL | DCOM | .NET | Java | Natural | PL/I | RPG | XML.

New .NET Wrapper class BigNumeric is provided. This is an implementation of decimal values without upper and lower limit and a default number of 99 digits after the decimal sign. See BigNumeric under .NET Wrapper Reference.

Top of page

ETBINFO Enhancements

Command-line Enhancements

Multiple enhancements have been made to the command-line utility etbinfo under UNIX and Windows:

See also etbinfo in section Broker Command-line Utilities under UNIX | Windows.

Timestamp

With new profile parameters %DATE and %TIME you can put a timestamp on your etbinfo output. See Profile in section Command-line Parameters under z/OS | UNIX | Windows.

Top of page

Monitoring EntireX with Command-line Scripts

EntireX provides a set of command-line scripts for common administration tasks:

You can select the scripts from the EntireX Command-line Scripts Menu or call the individual scripts from the command line. See Monitoring EntireX with Command-line Scripts.

Top of page

Workbench Enhancements

Mapping Arrays (Fixed <-> Unbounded) with the IDL Extractor for COBOL

With the context menu of the IDL Extractor for COBOL you can map a fixed-size COBOL table to a fixed-size or unbounded IDL array.

See for example Set Arrays (Fixed <-> Unbounded) under CICS with DFHCOMMAREA Large Buffer Interface - In different to Out in the IDL Extractor for COBOL documentation.

This is needed to support COBOL server programs that use the data length of their interface to process a variable number of array elements in a fixed-size COBOL table. See Using Data Length to Process a Variable Number of Array Elements under COBOL Support.

[Provided with EXX_9.7.0_Fix6]

Enhanced Null Value Suppression

A new button in the XML Mapping Editor Overview Page enables you to set the current null value suppression settings to all mappings. See Overview Page under Using the XML Mapping Editor.

[Provided with EXX_9.7.0_Fix2.]

COBOL Mapping Editor

The COBOL Mapping Editor has been redesigned with a workflow-oriented user interface and the look-and-feel of the Natural Mapping Editor. Extracting the COBOL interface and designing a single or multiple IDL interfaces is now on one screen. This means you keep control of both sides of the extraction (COBOL side and IDL side) at any time. With the new functions COBOL > Modify Interface and COBOL > Extract further Interface in the extended context menu of the IDL file you can refine the extractions any time, allowing you to pause your work and continue later. Many other details (e.g. combo-box to switch COBOL program, find text in COBOL source, set constants for level-88 fields, IDL name prefix for FILLER etc.) have been improved.

See COBOL Mapping Editor in the IDL Extractor for COBOL documentation.

Context Menu for IDL Files

The context menu for IDL files in the EntireX Workbench has been simplified. It is now more compact with the most commonly used target environments - COBOL, Integration Server, Natural and Web Services - on the first menu level. Under Other you can select additional supported targets such as C or Java, start the IDL Tester or refactor the IDL file.

See sample Context Menu under Software AG IDL File in the IDL Editor documentation.

IDL Extractor for Integration Server

The data type mapping from Integration Server data types to IDL data types has been enhanced. This includes a changed handling of content types. See IDL Extraction from Integration Server in the webMethods EntireX Adapter documentation.

Extracting an IDL file for specific Integration Server services now possible. The IDL Extractor for Integration Server extracts an IDL file for all services of an Integration Server package. To extract an IDL file only for some specific Integration Server services, a new built-in service is available in the WmEntireX package. See IDL Extraction from Integration Server in the webMethods EntireX Adapter documentation.

Top of page

Brainstorm Ideas

Brainstorm is a one-stop portal for all Software AG customers to submit feature requests, vote on ideas that have been posted by other customers and get your voice heard. All product categories are moderated by product managers, and ideas get responded to and updated on a regular basis. The number in square brackets is the Brainstorm ID.

Top of page

Documentation Enhancements

Top of page

Other Changes and Enhancements

Top of page