Features Added in Visual COBOL 2.3

This release provides a new Visual COBOL 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)

Visual COBOL 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.
  • OpenESQL Assistant - now accessed from View > Micro Focus SQL Tools.
  • OpenESQL Configuration Utility - now accessed from View > Micro Focus SQL Tools.
• 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.
• 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.

Visual COBOL 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.

Visual COBOL 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.

Visual COBOL 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 Visual COBOL'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.

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.

Micro Focus Rumba version 9.4 is now supplied with the Visual COBOL 2.3 setup file. The license for Visual COBOL 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 a Visual COBOL 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.

Visual COBOL 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 Visual COBOL. 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, .

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.

Visual COBOL 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 Visual COBOL is to include them in a project. For situations where you might want to quickly open edit a single file, Visual COBOL 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, Visual COBOL provides a path for creating projects from them - right-click such files in the editor, and click Create COBOL Project.

COBOL 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 Visual COBOL, you should ensure that the executable is rebuilt and packaged with the new run-time system. You can rebuild from the IDE or the command line.

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