ASNA Release Notes

Release Notes
Encore
Version: 4.1.19.0
Release date: 2024-08-15

Papa family for .NET

.NET 8 support

ASNA Encore 4.1.8.0+ and ASNA Monarch 11.4.34.0+ provide .NET 8 support.

Minimum .NET version: .NET 6
Minimum Visual Studio: Visual Studio 2022 build: 17.8

Updating Monarch Base NuGet packages

The QSys runtime libraries currently bundled with the Encore SDK are no longer supported. While they may work (for a while!) they are known to cause edge-case problems. For best results, it's important to update those runtime libraries by installing the latest ASNA Monarch Base NuGet packages.

See this page for NuGet package update instructions

It only takes a minute or so to update the packages.

After updating the NuGet packages the project file's UseEncoreSdkRuntimeReferences key value is false.

<Project Sdk="ASNA.EncoreRPG.MSBuild.Sdk">
    <PropertyGroup>
        <TargetFramework>net6.0</TargetFramework>
        <RootNamespace>ACME.ERP</RootNamespace>
         ...
        <AssemblyName>ACME.ERP.RUNCI</AssemblyName>
        <UseEncoreSdkRuntimeReferences>False</UseEncoreSdkRuntimeReferences>
    </PropertyGroup>
    <ItemGroup>
        <PackageReference Include="ASNA.QSys.Runtime" Version="5.0.24" />
    </ItemGroup>

    ...
</Project>

If you don't upgrade the Nuget packages, when Encore RPG encounters a project which using the older packages it issues this warning to update the packages:

C:\Program Files\ASNA\Encore RPG\4.1\ASNA.EncoreRPG.MSBuild.Sdk\Sdk\Sdk.targets(58,5): warning ESDK0001: QSys runtime
libraries bundled with Encore SDK are no longer supported, and will be removed in a future Encore SDK update. 
Please add a NuGet package reference to "ASNA.QSys.Runtime". Then, to remove this warning, add the
False MSBuild property to the project.

For the best results, we strongly recommend you upgrade the NuGet packages ASAP.

Software Requirements

Platform support

See the ASNA Version Policy for full requirements

You can only install one version of an ASNA Windows product on a single PC. For example, you can't install ASNA Visual RPG for .NET 17.x on a PC on which ASNA Visual RPG for .NET 16.x is installed.

ASNA Monarch Cocoon also requires:

ASNA Monarch Collector version 10.x - Installation instructions for Monarch Collector can be found here.

General installation tips

We strongly recommend you apply all pending Windows updates before installing any of our Windows products.
Don't install any ASNA Windows products while Visual Studio is running.

Visual Studio 2022 Editions

Visual Studio 2022 17.4 or higher Professional or Enterprise edition is required with the Papa family.

Changes Since Version: 4.1.11.0

Clients - DataGate Controls

Case 21738. Import Database Names Command does not overwrite existing names.

Clients - DataGate Explorer

Case 21741. "Connections" Node Serialization Errors Are Not Displayed.

Clients - DataGate Monitor

Case 21737. Import Database Names Command Fails.

QSys - DataGate.Client 5.0.14 - Changes since version 5.0.5

Nullable tests.
Use Nestable Transaction when resolving library list.
Fixed issues when renaming members of multi-member capable files.
Fix apxClassID array allocation size issue for print fields.
Recognize print fields with no data type (like Labels and Shapes).
Generate default XML docs file so it packs.
Implement CheckFormatID Override for Print Files.
Delay Checking Print File Format IDs.

QSys - Expo 5.0.21 - Changes since version 5.0.9

Move position of '@' symbols.
Reuse socket connections between Expo and MonaServer.
Exchange Protocol Versions in Handshake with MonaServer.
Fix Case 21683: Set on all records file-level AID Key Response Indicator.
Fix file-level function key enabled with Indicator=*NONE.
Summary text included a bad link causing 404 on the docs.

QSys - Runtime 5.0.24 - Changes since version 5.0.8

Solved compilation warnigns due to: base calls to obsolete members, missing /// from obsolete members, using Windows-only APIs.
Resolve DatabaseName for Connection.
Set Logical Member Text after member has been created.
Fix testing of existence of Output Queue.
Synchronize socketStream access.
Reuse socket connections between Expo and MonaServer.
Fix build break, reduce dependencies.
Update lock file for pull check.
Fix Case 21661 and Implement Copy Spooled File.
Generate default XML docs file so it packs.
Add Initialize method to arrays of non fixed-size elements (e.g. integers).
Implement CheckFormatID Override for PrintFiles.

RnD - Encore Compiler 4.1.18 - Changes since version 4.1.10

Fixed bug in generating initializing expression for a multidimensional RANK array.
Re-implementation of MODS support.
Use EncoreSdk lex/yac targets.
Make Workstation file paths relative in both XFD and XFU.
Removed unnecessary 'CycleFile' designation in XFU files. Ensure a print file also used for DS is recorded as a print file in the XFU. Updated package version numbers yp 5.0.* in migrated project file.
Remove BegPrintAttr/EndPrintAttr.
Removed old DetailSpec, HeadingSpec, TotalSpec used for print files in the early years of Monarch. Added missing HeadingDiskSpec.
Fixed bug in using properties in *ASFLD expressions.
Update submodule for QSys runtime mods.
Refine error handling and namespace logic.
Don't continue method matching when there's an error in parameters.
Enhanced type conversion and error reporting (MethodOverloading test).
Remove BEEP command from the pool.
Issue compilation error is ASNA.QSys.Runtime is not referenced, otherwise C# compilation fails.
Fix Math commands not reporting errors. Fix parser to only accept *INxx in uppercase (was failing for *INOF and others).
Fixed bug initializing arrays of integers. Fixed error message for WITH command when using DS fields.
Ensure proper types and definitions for temp variables used in WITH.
Fixed init expression for hex fields.
Ensure MessageFileCompiler is built.
Run GenerateParser before *compile* target.
Fixed 'errors not detected in TESTBITS' bug.
Don't generate temp fields if they are not used.
Static fields were not being initialized.

RnD - Encore IDE 4.1.18 - Changes since version 4.1.9

Support DclProp in editor language services.
Language service fixes, enhancements.
Support GOTO/TAG Intellisense features.
Reimplement block comment classification. Fix decimal literal parsing.
Access lex&yacc products from the project.
Compare and branch feature.
Fix bug in project loading.
Fix multi-project bug.
Fix method argument completion bug.
Support <mods>.<field> in the debugger.
Method signature help provider, completion enhancements, better array support.
Nested type completion.
Fix performance bug in member parsing, regression in StarType expression handling.
Min. support for BegCycleOutput construct, fixes.
Support DclPrintFile, fix *Global issues, support complex qualifier expressions, numerous fixes.
Fix bug in parsing FOREACH statements.
Remove UseEncoreSdkRuntimeReferences check box.
VS 17.8 required.
Ensure ICSharpCode.Decompiler package is loaded at run-time.

RnD - Encore SDK 4.1.21 - Changes since version 4.1.11

Access lex&yacc products from the project.
Mods to support older version of gppg tool.
Lex yacc unification.
Pick up command pool change for upstream.
Fix missing Encore runtime assembly issue.
Runtime deps fix.
Ensure EncoreSdk-dev solution builds after recent SDK changes.
Opt out of central package management.
Fix per-project builds.
Simplify build props and remove obsolete projects.

Serengeti - Code Generator Tools

Case 21726. Nomad tools for refreshing file info generate bad workstation file paths.