Features Added in Enterprise Developer 2.3

This release provides a new Enterprise Developer flavor that takes advantage of the new features of Visual Studio 2015, including:

Light Bulbs

You can use the light bulb feature () to quickly implement unimplemented interfaces or to resolve unknown types.

Compatibility (Project Round-Tripping)

Enterprise Developer supports the Visual Studio project round-tripping feature which enables you to work with COBOL projects in Visual Studio 2012, Visual Studio 2013 or in Visual Studio 2015 without the need to upgrade the project file.

.NET Framework 4.6 Compatibility

Provides support for creating managed COBOL applications that target version 4.6 of the .NET Framework.

Microsoft Help Viewer 2.2

Provides support for the Micro Focus Help in Microsoft Help Viewer 2.2.

• Menu items - the following Micro Focus utilities were previously available under the Tools > Micro Focus menu and have been moved as follows:
  • ADO.NET Connection Editor - now accessed from View > Micro Focus SQL Tools.
  • MFA Compare and Synchronization Monitor - now available directly under the Tools menu.
  • MFA Server Access Configuration - now available directly under the Tools menu.
  • OpenESQL Assistant - now accessed from View > Micro Focus SQL Tools.
  • OpenESQL Configuration Utility - now accessed from View > Micro Focus SQL Tools.
  • Web Service Client - now accessed by creating a new project of type "Web Service Client Application from JSON/REST" - click File > New > Project > COBOL > Native > Web Service Client Application from JSON/REST.
• Managed COBOL project properties - a new setting, Expose group linkage items to managed code, is now available on the COBOL tab in the properties of managed COBOL projects. Checking this sets the ILSMARTLINKAGE directive that specifies that group linkage items in your code are to be exposed as properties of a class. A related button, Options, enables you to also specify whether to remove specific prefixes from the names of COBOL data items, whether to make the new classes serializable, expose Linkage Section items as nested classes of the program class or to limit the property generation to non-redefining elementary items.
• PL/I project properties - there is now a new page, Assembler, in the project properties of PL/I Mainframe Subsystem Projects that enables you to set properties for configuring PL/I Assembler applications.
• Resetting the file properties - a new button, Use Project Defaults, on the file property pages of COBOL files in native projects now enables you to reset the file properties of COBOL files in native COBOL projects.

Enterprise Developer now supports Visual Studio's parallel builds for COBOL projects. Parallel building enables you to build multiple projects faster on multi-CPU machines. Following this change, in order for your multi-project solutions to build in parallel successfully, ensure that the project dependencies and build order are set correctly for your solution using Project > Project Dependencies. For more information about parallel building, see Tips on Building COBOL in your product help and your product Release Notes.

The COBOL editor includes the following enhancements and new features:

• Improved Intellisense writing assistance for COBOL in both native and managed COBOL:
  • Context sensitive suggestions - IntelliSense only shows suggestions that are relevant for the position of the cursor in the code or for the type of project.
  • Enhanced completion 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, IntelliSense shows suggestions for the relevant clauses and identifiers that you can use to complete the statement.
  • Automatic completion for single items - IntelliSense automatically inserts single suggestions in the code.
  • Qualifying non-unique names - IntelliSense qualifies data items whose names are not unique.
  • Configuration preferences for IntelliSense - 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.
  • Snippets - code snippets are now included in the IntelliSense suggestions.
• $IF-$ELSE-$END statement colorization - parts of a $IF Compiler-control statement that are not executed are now colored in grey.
• $REGION statement - support is provided for the $REGION Compiler-control statement. You can use $REGION - $END-REGION to surround blocks of code that you want to folded or expand in the editor.
• Copybook glyphs () in the left-hand margin on a copy line - indicate that a copybook can be expanded inline.
• Creating copybooks from selection of code - a new context menu command, Extract to Copybook in the editor enables you to move a selection of COBOL code into a new copybook file. The file is added to the project and the code in the original program is replaced with a COPY statement that refers the new copybook.
• Expanded copybook view - provides indicators for read-only copybooks
• Outlining - outlining is now available on comment blocks, paragraphs and on $REGION and $IF statements.
• Task List comments - the COBOL editor now provides support for Visual Studio-style Task List comments in COBOL. Typing TODO, HACK or UNDONE in the code immediately after the declaration of the COBOL comment (*>, *>> or * in column 7) creates a task that appears in the Task List window.

The PL/I editor has the following enhancements:

• Support for opening include files from within the editor
• Comment and uncomment toolbar buttons
• Initial support for IntelliSense
• Red squiggles
• Margins

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 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 Update Project Properties utility allows you to convert additional directives in your project to project properties. This option is presented on opening a project. You can select to not show this dialog again by unchecking Check Additional Directives for project properties in Tools > Options > Micro Focus > General.

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 or a terminal.

This release provides enhancements in the following areas:

• CICS class library - the public API has been enhanced to contain types that can be used from applications that are running specifically under the control of CICS. This enables you to call CICS functions from within your CICS applications.
• IDE support:
  • Integration with Micro Focus Rumba
  • Support for submitting JCL files from within the IDE
  • Character-set support
  • Configuring the dynamic debugging setting from the IDE
  • Starting a server when debugging starts
  • Stopping running servers on when closing the solution or the IDE
  • Viewing the console log from within the IDE
  • Creating or activating a listener if no listener is running
  • Server Explorer view of the available servers
  • Start, restart and stop commands for servers in Server Explorer
  • Command for associating a server with your project
• Dynamic listener configuration - it is now possible to configure a listener both from the command line tool and from within the Administration tool. Enables you to dynamically configure some aspects of a listener's behavior such as to enable, disable, add or remove ports, or do disconnect sessions.
• EBCDIC support - CICS regions now support applications that use EBCDIC.
• EZASOKET - limited support is provided for EZASOKET to enable you to run applications that use IBM's EZA functionality. Support is provided for the basic open, close, read and write statements and for some control functionality for IBM's EZACICAL and EZASOKET APIs.

  See the Enterprise Server for .NET product help for details about the supported functionality and the current limitations.

• JES REST API - support is provided for JES control using the HTTP REST interface. This enables you to use HTTP REST requests to perform JES functions. For example, you can use HTTP REST requests to add initiators and printers, change a job class or to release jobs.
• Historical Statistics Facility (HFS) - when HSF is enabled for an Enterprise Server for .NET CICS region, event records are created in the region database at run-time for transactions. These records can be subsequently processed to provide detailed information of their execution. A GUI and a command line tool are provided to analyze these statistics.
  Note: HFS is available only in CICS regions. SQL API calls are not supported.
• Minidump support - you can now configure a region to automatically produce a minidump when an exception occurs. This enables you to diagnose your system and trace any application faults.
• Importing and exporting resource definitions - you can now use the command line tool to export resource definition information Enterprise Server for .NET into the Enterprise Server format. This enables you to move your resource definitions between Enterprise Server for .NET and native enterprise servers instances within Enterprise Server.

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.

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.

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 prompt. A test fixture or suite is a COBOL program compiled to .dll 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.

Enterprise Developer support for Microsoft Azure has been updated to version 2.6 of the Microsoft Azure SDK.

Support has been added to the product for making any future versions of the Microsoft Azure SDK available before the next major release of Enterprise Developer. Micro Focus will deliver support for these only upon customers' requests.

The Micro Focus Infocenter Web site (http://documentation.microfocus.com) has been upgraded and now includes the following improvements:

• Scope being persisted when you select a product documentation in the Product Documentation section on the Micro Focus SupportLine Web site and choose to view the documentation in the Micro Focus Infocenter.
• Updated Scope settings - provides the ability to nest four levels deep when setting a scope.
• Scope being persisted between browser sessions once it has been set.
• Creating automatic scopes using the Search Topics icon, .
• A link to change the scope from the search results when there are too many results.
• Improved Boolean search expressions.
• Details included with the search results.
• Help on how to use the Infocenter and how to construct search expressions - available using the Infocenter Help button, .

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, 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.
2. Compile your application to apply the changes.
3. Run your application with Profiler to produce the relevant reports.

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.

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.

To enable full IDE support for single files, Enterprise Developer provides a path for creating projects from them - right-click such files in the editor, and click Create COBOL Project.

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.

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.