Version: 10.0.96.0 - Beta
Release date: 2025-05-01
Note for Wings 10.0 users: Wings 10.0 requires DataGate WebPak 16.0 and, if you're using Wings with Visual RPG, Visual RPG for .NET Framework 16.0.
If you are upgrading from an earlier version of Wings, you may be effected by the changes to the ASNA Runtime (see ASNA Runtime Changes below).
Be sure to read about the IBM i System Value requirements below.
Ensure neither Visual Studio, its installation, nor any Visual Studio update is running at the time of Wings installation, as it may cause conflicts.
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.
ASNA Wings 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 IBM 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 WDA, Monarch Collector and WebPak. The downloadable package for DataGate 16.0 for IBM i can be found here.
Wings supports silent installations. See the Installation section of the Readme file for more detail.
ASNA Wings requires license keys on the Windows and IBM i machines.
On the developer Windows machine apply these license keys (Using the Registration Assistant):
On the IBM i, use the following commands to apply these license keys:
<DataGate_installation_library>/REGISTER LICENSE(*SRVR)<DataGate_installation_library>/REGISTER LICENSE(*WNGS)This version of Wings has the following limitations:
All ASNA .NET Framework products need .NET 4.8x.
For Visual RPG, Wings, Mobile RPG, etc, you'll need Visual Studio 2019 Professional Edition or Enterprise Edition. The Visual Studio Community Edition no longer works with ASNA products.
Also, please make sure your target machine is current with Windows updates.
16-10-client-requirements.md
There are several display file features that are handled differently in Wings than on the IBM i with respect to the layout of certain fields in record formats, this differences cause the Format Level Identifiers used in Level Checks to be different for files exported by Wings and those created directly from pure DDS. The normal development cycle for Wings ensures that these differences do not cause any problems. This cycle follows these steps:
Some of the DDS features that cause Wings to generate different Format Level Identifiers are:
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.0 on a PC on which ASNA Visual RPG for .NET 16.0 is installed.
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.
platform-support.md
ASNA Wings and ASNA Mobile RPG requires the IBM i program feature, IBM i Open Access.
For more details, please the IBM i Open Access manual with the link below:
IBM i Open Access manual > IBM i Open Access manual > IBM i Open Access manual
DataGate for IBM i installs the following Open Access handlers:
Each handler is licensed separately. Talk to your ASNA sales representative for licensing details.
All ASNA .NET Framework products need .NET 4.8x.
For Visual RPG, Wings, Mobile RPG, etc, you'll need Visual Studio 2019 Professional Edition or Enterprise Edition. The Visual Studio Community Edition no longer works with ASNA products.
Also, please make sure your target machine is current with Windows updates.
16-10-client-requirements.md
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.
The first change is that ASNA.VisualRPG.Runtime.DLL expands into three new DLLS:
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:
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.dlllibrary 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.dllwith 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.dllIn addition to removing that reference:
For Visual RPG Windows and Web projects:
ASNA.VisualRPG.Runtime.dllASNA.Runtime.dllFor Wings and MobileRPG projects:
ASNA.VisualRPG.Runtime.dllASNA.Runtime.dllASNA.Runtime.JobSupport.dllFor Monarch projects:
ASNA.VisualRPG.Runtime.dllASNA.Runtime.dllASNA.Runtime.JobSupport.dllASNA.Runtime.Monarch.dllThe 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.
avr-runtime-changes.md
Visual Studio treats local (offline) as an optional component. As such installing it requires some additional steps:
The note above applies to any version of Visual Studio.
When installing Visual Studio:
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:
Please see this asna.com article for ASNA's browser and mobile client support.
browser-support.md
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.
ms-edge-warning.md