ASNA Mobile RPG release notes

Version: 10.0.93.0 - Generally Available (for production environments)

Release date: 2024-10-10

Important Notices

See the Software Requirements section below for platform support.

If you are upgrading from an earlier version of AVR, you may be effected by the changes to the ASNA Runtime (see ASNA Runtime Changes below).

Required IBM i SYSVAL and User Profile setting required for Mobile RPG

The following System Values are required:

• QMLTTHDACN: 1 or 2

• ASNA Wings requires the QRMTSIGN IBM i system value to be set to *VERIFY to be able to use the ASNA Browser-based emulator. It is assumed that Mobile RPG will be used with new RPG programs and not need to invoke the ASNA emulator on mobile devices. Therefore, Mobile RPG doesn’t require a given value in QRMTSIGN.

Limitations of IBM Rational Open Access - RPG Edition

• Handler support limited to ILE RPG (RPGIV) only. All other languages are excluded at this time, including CL.
• An Open-Access file cannot be a program-described WORKSTN file.

For more details, please the IBM i Open Access manual with the link below:

IBM i Open Access manual

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.

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.

• For our products that snap into Visual Studio (ie, Visual RPG for .NET Framework, Wings, Mobile RPG, etc.) be sure to install Visual Studio first.

ASNA Runtime Changes

Starting with the version 15.0 of the ASNA family of .NET products two changes were introduced to some ASNA DLLs. If you are upgrading to 15.x or higher from a previous release ASNA family release the following may apply to you.

1. ASNA.VisualRPG.Runtime.DLL expands into three new DLLs

The first change is that ASNA.VisualRPG.Runtime.DLL expands into three new DLLS: * ASNA.Runtime.DLL * ASNA.Runtime.Support.DLL * ASNA.Runtime.Monarch.DLL

This increased granularity was made to better match library improvements and DLL changes to the various ASNA products that use them. The details of this three-way split are shown below in Figure 1.

In Figure 1 above the namespaces each DLL provides are shown prefixed with {}. They are:

• ASNA.Monarch
• ASNA.Monarch.Wings
• ASNA.Runtime
• ASNA.VisualRPG.Runtime

You can see that although ASNA.VisualRPG.Runtime.dll has been split into three DLLs the same namespaces are provided in the new DLLs. The version 15.x DLLs also provided a few new additional namespaces beyond what’s shown in Figure 1.

To maintain backwards compatibility of version 15.0 with previous versions we ship an ASNA.VisualRPG.Runtime.dll library which forwards requests for any of the four original namespaces that where in that DLL to the corresponding new DLL. We will stop shipping the ASNA.VisualRPG.Runtime.dll with the next major version of ASNA .NET products. This forwarding version of this DLL will be available as a separate download.

2. ASNA.VisualRPG.Common.Sgml.dll has been deprecated.

The second change is that ASNA.VisualRPG.Common.Sgml.dll has been deprecated and its code has been moved to ASNA.Runtime.dll. This change mostly affects customers using Mobile RPG and Wings.

Changes you need to make because of these DLL changes

There are no coding changes you need to make in your projects because of these changes. The only changes you need to make is adding and/or deleting references. For new 15.x projects the correct project references will already exist.

• For all project types:
  • Remove references to ASNA.VisualRPG.Common.Sgml.dll

In addition to removing that reference:

• For Visual RPG Windows and Web projects:
  • Remove the reference to ASNA.VisualRPG.Runtime.dll
  • Add a reference to ASNA.Runtime.dll
• For Wings and MobileRPG projects:
  • Remove the reference to ASNA.VisualRPG.Runtime.dll
  • Add a reference to ASNA.Runtime.dll
  • Add a reference to ASNA.Runtime.JobSupport.dll
• For Monarch projects:
  • Remove the reference to ASNA.VisualRPG.Runtime.dll
  • Add a reference to ASNA.Runtime.dll
  • Add a reference to ASNA.Runtime.JobSupport.dll
  • Add a reference to ASNA.Runtime.Monarch.dll

The ASNA.Runtime.* DLLS are located at:

C:\Program Files (x86)\Common Files\ASNA Shared\Client\xx

where xx is the ASNA Visual RPG version number.

For more details on the runtime changes click here. ## Visual Studio 2022 Editions

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

Visual Studio 2022 treats local (offline) as an optional component. As such installing it requires some additional steps:

When installing Visual Studio 2019:

1. Under the Individual Components tab.
2. On the Code Tools section.
3. Enable the Help Viewer component.

To verify the Help Viewer is installed, look at the top of the Help Menu in Visual Studio. The following three options should be visible at the top of the menu:

1. View Help
2. Add and Remove Help Content
3. Set Help Preferences ## Supported Web browsers, smartphones, and tablets

Please see this asna.com article for ASNA’s browser and mobile client support.

Downloading with Microsoft Edge

If this software is downloaded via Edge you may receive a message stating that this file “is not commonly downloaded” when attempting to install it. In this event click the View Downloads button, select the ASNA product to install from that list, and confirm that you’d like to install it.

Similarly, attempting to install the software directly through Microsoft Windows may cause a “Windows protected your PC” message to appear. In this event click the small More Info prompt on the left, and click Run Anyway on the following window. ## IBM i Open Access Handlers

DataGate for IBM i installs the following Open Access handlers:

• BTerm
• Mobile RPG
• WingsRPG
• Wings Ext

Each handler is licensed separately. Talk to your ASNA sales representative for licensing details.

Changes Since Version: 10.0.89.0

• Case 21614. Uninstall of AVR 16.0 fails if VS 2019 has already been uninstalled.

• Case 21632. Creating a Physical File with Field Type DBCS-open creates field with Length half of definition.
• Case 21664. Don't leak I/O completion waiter threads.

• Case 21653. Test Connection command should provide better error info.

• Case 21653. Test Connection command should provide better error info.