New Features in Enterprise Developer 2.3

This release ships with Eclipse version 4.4.2.

Support for Eclipse versions 3.7 and 3.8 has been deprecated. This affects any applications that were created using an earlier version of Enterprise Developer that have a JVM COBOL part. Such applications must be rebuilt using Enterprise Developer 2.3 to avoid receiving errors during compilation or execution.

In addition, when Enterprise Developer is installed, you can optionally install the Enterprise Developer plugin in other instances of Eclipse installed on your machine (supported versions of Eclipse are 4.2, 4.3 and 4.4 for the 32-bit IDE).

• The Variables view now shows the file status of an internal file name.
• The Find All References and Go To Definition commands are now supported for JVM COBOL applications.
• Support is provided for the SOCKS5 proxy server for debugger communication over SSL.

To minimize the number of modules to compile when building JVM COBOL projects, Enterprise Developer now enables you to configure your projects so that they are built incrementally - the IDE only rebuilds the files that have changed.

To enable incremental builds for JVM COBOL applications that contain namespaces, check the Use incremental build (Technical preview feature) option on the project build configuration tab in the project's properties.

For JVM COBOL applications that do not contain namespaces, you can use the Use dynamic calls option available on the build configuration tab in the project's properties. When the project is built with this setting, calls to modules are resolved at run time rather than during compilation. This has the effect of not requiring every module to be compiled when rebuilding the application.

Content Assist support for COBOL includes various enhancements and is now also available in JVM COBOL:

• Context sensitive proposal - Content Assist only shows proposal that are relevant for the position of the cursor in the code or for the type of project
• Enhanced proposal lists - lists include any relevant COBOL verbs, clauses and words, copybooks, code templates, data items and section and paragraph names
• Intelligent assistance with completing statements - when you have entered a COBOL verb, Content Assist shows proposals for the relevant clauses and identifiers that you can use to complete the statement.
• Automatic completion for items - Content Assist automatically inserts single suggestions in the code.
• Qualifying non-unique names - Content Assist qualifies data items whose names are not unique.
• Configuration preferences for Content Assist - enable you to configure what suggestions appear in the completion lists, whether suggestions are added in insert or overwrite mode, and the case of the inserted words.
• Code templates - code templates are now included in the Content Assist proposals.

Enterprise Server has been extended to provide a CICS Web Services capability compatible with the mainframe.

A new CICS Web Service wizard enables you to generate CICS Web service providers and requesters using either a CICS COBOL application or a WSDL file as input. This enables you to develop and test, including end-to-end testing, CICS Web Services for deployment to the mainframe.

Enterprise Developer now offers more advanced code analysis features and enables you to run various analysis queries (rules and groups of rules called rule sets) against your code to ensure adherence to standards such as standards for coding or performance.

You can run analysis rules against programs in a project in the IDE at user request or you can run analysis rules at the end of a project's build.

Enterprise Developer now provides support for code coverage of native COBOL applications directly from within the IDE where code coverage uses the Test Coverage functionality. You can produce code coverage reports for applications running in the COBOL run-time and for applications that run in Enterprise Server.

To produce reports, you need to enable code coverage in a project's, a build configuration's, or a file's properties, compile your application and then run your application with code coverage to produce the relevant reports. For applications that require an Enterprise Server instance, you start the enterprise server with code coverage.

When using the cbllink command to compile and link, there is a new -y option. Use this option to create an executable that includes support to be able to run on Windows XP and Windows Server 2003.

The following Compiler directives contain new parameters in this release:

DBSPACE

The new parameter 'MIXED' extends the DBSPACE directive to be able to evaluate data items in programs that contain a mix of single-byte and double-byte strings.

The Data File Structure Command Line (DFSTRCL) utility is a DOS-based command line utility that enables you to create record layout (.str) files from COBOL debug information (.idy) files. You can use the utility to process a single .idy file or batch process up to 100 .idy files.

The Data File Tools (Technology Preview) is a new standalone text editor in which you can create and edit data files. By nature of it being a 'technology preview' product, it does not currently include all the functionality that was available in the previous version of Data File Tools - now referred to as Classic Data File Tools. If you require any of the functionality not provided in this version, you can still use the classic version by accessing it in the usual way.

To run Data File Tools (Technology Preview), type mfdatatools2 from Enterprise Developer's command prompt (Windows) or a terminal (UNIX).

To use the new editor directly from the Eclipse IDE, use the Open with option on the shortcut menu when selecting a data file or structure file, and select Data File Tools. Eclipse remembers the last tool used for a particular file type, and so will use Data File Tools (Technology Preview) until you select a different editor.

The following new environment variables are available:

MFJ_REPRO_EMPTY

Enables or disables the ability for the IDCAMS REPRO action to copy from a pristine VSAM file. Permissible values: Y or N.

ES_JESYSMSG_RESTRICTED

When system message spool files are being routed directly to the Output queue, by using ES_JESYSMSG_OUTPUT, you can hold back spool files based on their class, by using ES_JESYSMSG_RESTRICTED. Permissible values: class names or numbers entered as a continuous string; for example, ES_JESYSMSG_RESTRICTED=ABC123.

This release contains the following new configuration options:

ACUFH

Enables or disables the use of the ACU file handler (ACUFH), which is required to handle Vision and RM/COBOL indexed files.

ESACUFH

Enables or disables the use of the ACU file handler (ACUFH) for file handling operations running under Enterprise Server. ACUFH must also be enabled for this option to take effect.

In versions prior to Enterprise Developer 2.3, the semantics of the sharing phrase specified in an OPEN statement or used within a call to CBL_OPEN_FILE were not correctly applied in some cases on UNIX and Linux platforms. From version 2.3 onwards, the sharing phrase is correctly honored when the tunable strict_file_locking=true is set, which is the default setting.

Example of potential changes in behavior:

• Process-A opens a file with read-only access and a sharing mode that denies other processes write access (SHARING WITH READ ONLY).
• Process-B then attempts to open the file with read-only access and a sharing mode that denies other processes read access (SHARING WITH NO OTHER).

With strict_file_locking=true, Process-B is unable to open the file, because Process-A has successfully opened the file allowing only read access.

With strict_file_locking=false, Process-B successfully opens the file.

If your application encounters unexpected OPEN conditions or fails to open files, it might be as a result of the new file locking behavior. In such circumstances, we recommend that you review the file locking and sharing requirements of your application and refactor your source code to work with the default setting. The original file locking and sharing behavior can be restored by setting strict_file_locking=false.

You can configure iFileshare to offer enhanced availability for mission critical files by configuring a high availability group, consisting of a primary iFileshare server and a number of stand-by servers. (Currently, this type of configuration only supports having one stand-by server)

Files that are critical to your application can be replicated from a primary server onto the stand-by servers. Should the primary server fail, you have up-to-date data (minus any in-flight transactions) available.

To reduce the complexity and to increase the stability of an iFileshare high availability group, it is recommended that each region is configured as a dedicated iFileshare server. If other Enterprise Server work is hosted within the group, the setup must be consistent on each server so that in the event of a fail-over, the non-Fileshare work can be continued on the new primary server.

A new parsing JCL editor provides assistance with writing JCL code to users who are not experienced mainframe programmers. This is especially useful when using the Enterprise Developer Connect to edit source files on a remote mainframe machine. Features include:

• Block selection - use the button from the toolbar to toggle the mode.
• Content assist for JCL constructs.
• Configurable background syntax parsing
• Configuration settings for the editor - you can hide or show the horizontal ruler, turn on or off visible lines for the margins, and configure the syntax coloring and the smart edit mode.
• Folding support - enables you to collapse and expand blocks of code.
• Horizontal ruler
• Locate definitions
• Margins
• Outline view - shows a structure of the procedure and structure declarations within a program. Clicking on an item in the Outline view positions the cursor on that item in the code and vice versa.
• Renumber and Unnumber - support for renumbering and unnumbering lines of code.
• Submit JCL command directly from the editor.
• Smart edit mode - defines the word wrapping behavior when breaking lines or around margins, moving the cursor using the Home and End keys.
• Syntax colorization
• Syntax error reporting - uses red squiggles to denote errors in the code.
• Task creation - inserting a TODO or a FIXME in a comment in the code automatically creates a task that appears in the Task view.
• Templates for the most common JCL constructs.

The following library routines are new in this release:

CBL_MANAGED_SESSION_GET_USERDATA

Retrieves user data saved in the current RunUnit.

CBL_MANAGED_SESSION_SET_USERDATA

Sets user data in the current RunUnit.

The following library routines contain new parameters in this release:

CBL_LOCATE_FILE

You can now specify a file name that is a null-terminating string, which has resulted in three new values available for the user-mode parameter.

• IMS DBCS - Enterprise Server IMS support has been expanded to include applications that use double-byte character sets (DBCS). MFS EATTR=ECGS (full DBCS string without SOSI) is now supported.
• Implement /DIS USER DEQUEUE - the /DEQUEUE USER command is now available to remove messages from the message queue to provide you with greater flexibility when managing IMS systems.

A new utility, Micro Focus FTP (MFFTP), provides FTP support for JCL-enabled enterprise servers within Micro Focus Enterprise Server. The MFFTP utility provides a support mechanism for batch processes that takes advantage of FTP from JCL on the mainframe.

Micro Focus Rumba version 9.4 is now supplied with the Enterprise Developer 2.3 setup file. The license for Enterprise Developer will license all components of Rumba.

The Micro Focus Unit Testing Framework is an xUnit style testing framework, available from the command line, for procedural COBOL applications.

It includes much of the architecture you would expect in an xUnit framework. The test runner is a 32- or 64-bit executable that you run from an Enterprise Developer command or shell prompt. A test fixture or suite is a COBOL program compiled to .dll (Windows) or .so (UNIX) that can include the setup, the test case code, and the teardown associated with the test case.

Test results are available in a number of formats. By default, results are displayed to screen and to a .txt file, but you can use additional parameters on the command line to produce reports in JUnit format.

This release provides the following enhancements to PL/I support in Enterprise Developer:

• 64-bit support - Enterprise Developer provides a full 64-bit environment for developing PL/I applications on Windows, Solaris(SPARC), Red Hat Linux, and SUSE Linux to enable you to take advantage of any 64-bit features such as 64-bit address space or interact with 64-bit relational databases when modernizing your applications.
• Data types - support has been added for GRAPHIC data type, including GRAPHIC, GRAPHIC VARYING, GRAPHIC VARYING BIGENDIAN, Gx and G constants. This enables you use GRAPHIC data within your applications to migrate to Open PL/I running under Enterprise Server.
• PL/I debugger:
  • The cwgui debugger is no longer available. You can now use the cw_java debugger which provides a richer graphical debugging experience.
  • The debugger has been enhanced to support the evaluation of the following built-in functions: CENTER, CENTERLEFT, CENTERRIGHT, HEX, LEFT, LOWERCASE, MAXLENGTH, PACKAGENAME, RIGHT, REVERSE, ROUND, SEARCH, SEARCHR, TALLY, and UPPERCASE.
• New -systemmvs, -systemims, and -systemcics link options - the mfplx and linker logic has been enhanced to decouple the -cics, -ims, and -mvs flags from the link options. If you have PL/I CICS EXCI applications, this enables you to compile and link your applications more easily to run under the control of JCL or IMS.

  In addition, the macro preprocessor SYSTEM() built-in function will now correctly return the value of the "SYSTEM" in effect (for example: IMS, CICS or MVS).

• The Open PL/I macro preprocessor now supports the following:
  • The Open PL/I macro statement ANSWER. This enables the migration of PL/I code which uses ANSWER in its PL/I macros.
  • The use of arrays of FIXED and CHAR macro variables. This simplifies the migration and maintenance of PL/I Macro preprocessor code that uses variable arrays.
• IBM Structure Alignment (-zalign) - the Open PL/I compiler has been enhanced to provide an option which causes ALIGNED structures to map data elements at the same offsets as IBM's compiler. This facilitates the migration of applications and data to Open PL/I running under the control of Enterprise Server.

Support has been added in the IDE for enabling and using multiple preprocessors with your projects.

A new page, Additional Preprocessors, has been added to the project's and the files' properties of native COBOL applications to enable you to choose one or more preprocessors to use when building your application and to specify their order of execution.

New reporting capability is now available for user preprocessors: resp-main code 18 indicates that a buffer contains a data name to be marked as modified by the immediately preceding preprocessed line. The data name may be qualified and resp-more contains the column information for the reference.

Enterprise Developer now provides support for Profiler for native COBOL applications directly from within the IDE. To produce reports, you need to:

1. Enable Profiler in the COBOL property page for a project, a build configuration, or a file.
2. Compile your application to apply the changes.
3. Create a run configuration that has Profiler enabled.
4. Run your application with Profiler to produce the relevant reports.

This release provides the following enhancements:

• An improved diagnostic tooling to help determine connection problems - enhancements are available for both the client and the server installations.
• It is now possible to specify the Remote System Explorer (RSE) type of connections to create remote mainframe COBOL and PL/I projects. This is to cater for scenarios when it is not possible to use SAMBA or NFS connections within your environment.
  Note: The following features and utilities are not supported when remote projects use the RSE connection type:

  • The file layout editor and the file editor in the Classic Data File Tools and Data File Tools (Technology Preview) utilities.
  • The BMS compiler and painter.
  • The IMS layout editor and the IMS database editor.
  • Mainframe Assembler.
• Changing the type of a remote connection - it is now possible to change the type of the remote connection from RSE to NFS and vice versa using the Remote Settings for remote projects.

Support is provided in Eclipse for editing, compiling and debugging of 32-bit and 64-bit PL/I applications running on remote UNIX and Linux machines.

All PL/I editor features available for local projects are present in the editor for remote PL/I applications. Improvements have been made to the syntax recognition of the PL/I editor parser.

RESTful service interfaces utilizing JSON as the media type in request and response messages are now supported using the Interface Mapping Toolkit. This enables you to extend COBOL applications using modern transport payloads and protocols.

In addition to its proprietary installer for installing Enterprise Developer on UNIX and Linux, Micro Focus provides a standard RPM installer for installing Enterprise Developer on Linux. RPM Package Manager (RPM) is a technology available on all Linux operating systems for managing the installation of products.

The RPM installer for Enterprise Developer supports all the RPM functionality.

For instructions on how to install using the RPM installer, refer to the Installation section in your product help.

The recommended way to work with files within Enterprise Developer is to include them in a project. For situations where you might want to quickly open edit a single file, Enterprise Developer now provides support for native COBOL files in the IDE when the file is not opened as part of a project. There is limited support for the IDE editing, compiling and debugging features as full support requires a project file.

A new spooler housekeeping utility has been introduced (MVSSPLHK). It offers additional archiving functionality compared to the previous spooler housekeeping utility (MVSP0027), and can also be configured to run directly from a JCL job.

Transaction class (TRANCLASS) support is no longer a technology preview feature, and is now a full release feature.

This release of Enterprise Developer contains the following new tunables:

putenv_interface

Provides backward compatibility for UNIX systems in which the operating system's putenv() function is required when setting environment variables.

strict_file_locking

Enables a new, more reliable method of file locking for UNIX systems. See File Locking for more information.

Enterprise Server has been updated to provide an execution environment capable of running applications that were each built using different development products. A consequence of this is that If your application has a main COBOL executable (.exe) that was built with a previous version of Enterprise Developer, you should ensure that the executable is rebuilt and packaged with the new run-time system. This does not affect mainframe subsystem projects deployed to Enterprise Developer. You can rebuild from the IDE or the command line.

Other COBOL subprograms built with previous versions of Enterprise Developer are not required to be rebuilt.

• XML configuration files - a single XML configuration file replaces the five separate configuration files that were used in previous releases. This helps reduce the complexity of the z/Server installation and configuration. An XML schema is supplied and enforced. The input parameter values for type and range are checked at execution time and can also be externally verified using standard or custom tooling before they are applied.
• z/Server Configuration Utility (Technical Preview only) - this release provides a technical preview of a new web-based z/Server Configuration Utility.
  Note: This is a technology preview feature only. It is being made available to allow you to test and provide feedback on this new capability; however, this feature is not intended for production use and it is not supported as such. Furthermore, Micro Focus does not guarantee that this feature will be delivered at a GA level and if it is, then the functionality provided might differ considerably from this technology preview.
• The Application Workflow Manager now requires that you have both z/Server and Mainframe Access Server (MFA) installed.