Release Notes
ASNA Mobile RPG®
Version: 9.0.101.0
Release date: 2021-10-20
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).
If you've upgraded to Visual Studio 15.6.x or beyond, the Web Project Templates for C# and Visual Basic are in a new location, Language > Web > Previous Versions
The Empty Print File Definition item template is not functional at this time; we are working to correct the issue.
Be sure to read about the IBM i System Value requirements below.
Visual Studio 2017. Mobile RPG 9.0 is optimized for Microsoft Visual Studio 2017® Version 15.3 and later.
Secure Socket Layer Integration. ASNA DataGate 15.0 includes integrated support for SSL, allowing smoother, more effective security solutions for your MobileRPG applications. If both DataGate Client and DataGate Server 15.0 are installed, SSL will be used by default. (See DataGate SLL Integration.)
Improved DSPATR Support. The handling of Display Attributes has been greatly improved, with DSPATR:UL, RI, and HI supported.
Spooled File Viewer. ASNA has introduced a new Spooled File Viewer that allows users to view spooled files either as a list or in .pdf form.
New DdsIcon Control: The new DdsIcon control allows developers to add simple, non-interactive icons to Monarch display files.
DdsTable Improvement: DdsTables can now be configured to allow users to edit the data in some or all of the columns.
DdsBar Improvement: The HideWhenEmpty property allows navigation bars to be dynamically concealed when they have no contents.
Only one installation of Visual RPG, Windows Deployment, or DataGate WebPak may be installed on a single machine. The Windows Deployment and WebPak components are subsets of what is contained in the AVR installation package. Attempting to install Mobile RPG (the development package) onto a machine where the Deployment package is already installed (or vice-versa) will result in neither package working. If you have one of these products installed currently on your machine, please uninstall it before installing another.
ASNA Mobile RPG is composed of several items, some of them are used exclusively at design time, others at design and run time, there are items installed on the Windows machines and there are others installed on the System i.
These are the ASNA components used at design time:
For run time, the ASNA components needed are:
The download packages on this page include the components for MDA, Monarch Collector and WebPak. The downloadable package for DataGate 15.0 for IBM i can be found here.
If this software is downloaded via Microsoft Internet Explorer or 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.
Silent Installation Process
Wings now supports silent installations. See the Installation section of the Readme file for more detail.
Local Help Support
Visual Studio 2017 treats local (offline) as an optional component. As such installing it requires some additional steps:
When installing Visual Studio 2017:
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:
The version 15.0 of the ASNA family of .NET products introduces two changes in some ASNA 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.
Figure 1. Version 15.0's new DLL structure
In Figure 1 above the namespaces each DLL provides is shown prefixed with {}. 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 theASNA.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.
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.
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.
ASNA.VisualRPG.Common.Sgml.dll
In addition to removing that reference:
For Visual RPG Windows and Web projects:
ASNA.VisualRPG.Runtime.dll
ASNA.Runtime.dll
For Wings and MobileRPG projects:
ASNA.VisualRPG.Runtime.dll
ASNA.Runtime.dll
ASNA.Runtime.JobSupport.dll
For Monarch projects:
ASNA.VisualRPG.Runtime.dll
ASNA.Runtime.dll
ASNA.Runtime.JobSupport.dll
ASNA.Runtime.Monarch.dll
The ASNA.Runtime.* DLLS are located at:
C:\Program Files (x86)\Common Files\ASNA Shared\Client\15
For more details on the runtime changes click here.
Installing Microsoft's latest service packs, high priority and optional software updates for Windows, the .NET Framework, and Visual Studio 2015 is highly recommended.
Windows optional update KB3118401 is required for correct operation of version 15.0. See https://support.microsoft.com/en-us/kb/3118401 for more detail.
MDA has been tested on the following operating systems:
Caution: Ensure neither Visual Studio, its installation, nor any Visual Studio update is running at the time of Mobile RPG installation, as it may cause conflicts.
Before installing MDA, please ensure the Windows machine is equipped with the following:
On the IBM i, you will need the following:
Please see this asna.com article for ASNA's browser and mobile client support.
ASNA Mobile RPG requires license keys on the Windows and IBM i machines.
On the development Windows machine apply these license keys (Using the Registration Assistant):
On the IBM i apply these license keys:
This build (9.0) of Mobile RPG has the following limitations:
The following System Values are required:
QMLTTHDACN
: 1 or 2ASNA 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 inQRMTSIGN
.
For more details, please see Chapter 6 in the document link below:
Clients - DataGate
Clients - DataGate Controls
Clients - DataGate Explorer
Clients - DataGate Monitor
DataGate Server
DataGate Studio
Monarch WebControls