Visual Studio — Microsoft Visual Studio.

• Markdown is simple to write and simple to read. It is commonly used for Github repositories to create ReadMe.md files that provide visitors with insight int.
• This article contains the Microsoft Visual Studio 2005 Express Edition Setup issues Readme file.
• Select Microsoft Visual Studio 2019 plugin during installation. If a pre 10.0.0 version of AppScan Source has been installed into the target instance of Visual Studio 2019, uninstall it as follows: Start the target Visual Studio 2019 instance. Open to Visual Studio Extensions Manage Extensions.
• The Visual Studio 2019 Blog is the official source of product insight from the Visual Studio Engineering Team. You can find in-depth information about the Visual Studio 2019 releases in the following posts: Available Today! Visual Studio 2019 v16.9 and v16.10 Preview 1; Visual Studio 2019 v16.9 Preview 3 is Available Today!

Product Issues
Fixes in this Release
New Features
Getting Started
Components You Will Need
System Requirements
Installation Issues
Installing Visual RPG
Licensing ASNA Products
Uninstalling Visual RPG
Using Visual RPG
Starting Visual RPG and DataGate
Additional Resources
ASNA Developer Network (DevNet)
DataGate Studio Readme
Monarch Readme

Product Issues

Fixes in this Release

Please refer to the list of fixes in this release in the Release Notes on the Downloads page at https://docs.asna.com/downloads/Pages/ASNAVisualRPG140forVisualStudio2015.aspx

Getting Started

To run Visual RPG 14.0 for Visual Studio, you will need the following components on your system:

1. Visual Studio 2015 or the Visual Studio Shell (Microsoft .NET 4.0 Framework)
   Visual Studio 2015 uses the .NET 4.0 Framework.

2. Visual RPG 14.0
   ASNA Visual RPG is an RPG compiler that �snaps� into Microsoft�s Visual Studio 2015.

3. ASNA DataGate® for IBM i
   If you are going to access the data on your IBM i, ASNA DataGate for IBM i will need to be installed and running on your system. You will need to be sure that your IBM i is at at least V5r1 or greater to install DataGate for IBM i.

4. IIS
   All necessary components are automatically part of the operating system. However, you may still need to 'Add' the components.
   To verify if you have IIS installed on your system, click the Windows Icon/Start Button - Control Panel - Programs - Turn Windows Features on or off - Internet Information Services.

   • If Internet Information Services is checked, IIS has been installed and added.
   • If Internet Information Services is not checked, you will need to install IIS. (basic instructions)
     1. Click the check box next to Internet Information Services to place a check in it, then click OK.
     2. A wizard will run installing Internet Information Services and its components.

5. Administrative Privileges
   When installing Visual RPG on Windows 7 or 8 (Pro) you should be signed on with Administrative Privileges to start the DataGate Service

   If you are not signed on with Administrative Privileges, a Warning will display � stating that you need to have Administrative privileges to start the DataGate Service.

   Therefore, you may want to check with your Network Administrator prior to installing to ensure you have Administrative privileges. Note that even if you do not, you can still install Visual RPG; you just cannot start the DataGate Service until you do.

6. Licensing Requirements
   A new installation of Visual RPG 14.0 comes with the following trial licenses, allowing you to receive all the licenses you need to develop windows or web applications (for 30 days)
   • Visual RPG 14.0 for Visual Studio 30-day temporary license. This allows you to access the IDE and create your AVR for .NET applications.
   • DataGate 14.0 for Windows Servers and Desktops � a 5 user, 30-day trial license. This allows you to create databases that run on Windows NT and XP operatingsystems.
   • DataGate 14.0 WebPak � a 1 processor, 30-day temporary license. This allows you to develop and deploy web applications.

   Once your 30-day trial license is expired, you will need a new trial or permanent license from ASNA to continue using the product.
   Uninstalling and reinstalling the product will not generate a new trial license.

Since Visual Studio and DataGate have already been installed, the initial system requirements to run Visual Studio have probably already been met on your system. Please refer to the system requirements as required by Visual Studio.
For more information on Windows 7 System Requirements, see http://windows.microsoft.com/en-US/windows7/products/system-requirements

Visual Studio 2015 minimum requirements:
Professional: http://www.microsoft.com/visualstudio/eng/products/visual-studio-professional-2015#product-edition-professional-requirements
Ultimate: http://www.microsoft.com/visualstudio/eng/products/visual-studio-ultimate-2015#product-edition-ultimate-requirements

Installation Issues

Readme.md Visual Studio

After Visual Studio has been installed, you need to install Visual RPG for the first time, or to install a newer version of Visual RPG. You can install Visual RPG from the Downloads page on ASNA�s Developer Network web site https://docs.asna.com.
Installing Visual RPG will also automatically install Release 14.0 of DataGate for Windows Servers and Desktops.

Note that the installation procedures are the same regardless of which operating system you use, except for the note below:

Installing Windows 7, Windows 8 Pro, or Windows 10:

When installing Visual RPG on Windows, you should be signed on with Administrative Privileges to start the DataGate Service. If you are not signed on with Administrative Privileges, a Warning will display � stating that you need to have Administrative privileges to start the DataGate Service.

Therefore, you may want to check with your Network Administrator prior to installing to ensure you have Administrative privileges. Note that even if you do not, you can still install Visual RPG, you just cannot start the DataGate Service until you do.

To Install from ASNA Developer Network (DevNet.asna.com)

1. Go to https://docs.asna.com
2. Click on Sign In link on the top right corner and sign in to your DevNet account, or select Create an Account on the left to create a new account.
3. Once you are signed in, click on the Downloads link at the top.
4. Scroll down and select the product and version you wish to download.
5. On the next screen, the list of products in the product suite selected will display for you to select from.
6. Select the product to install. The Release Notes for that product will display. In the right hand corner 'Downloads' window, you will see the list of products available based on your sign in. Select the icon of the product to install. The installation exe will display for you to Run now, or Save to your system and install later.

Continue with the steps below to license the Components and start Visual Studio and Visual RPG.

Silent Installation

Note: Like other installations, Silent Installations require that the user performing them have Administrator-level privileges.

To set up a silent installation, you must download the AVR package as listed above, or otherwise have them available on your Windows machine or network.

Then, in a command prompt, enter the path to the folder where the AVR installation package is saved followed by Setup.exe, using the following syntax:

The following options are required for silent installation:

Other available installation options are:

Note: Multiple installation options may be used.

To repair an installation from the command line:

To uninstall from the command line:

A new installation of Visual RPG comes with the following trial licenses, allowing you to receive all the licenses you need to develop Windows or Web applications (for 30 days).

• AVR 14.0 for Visual Studio � 30-day temporary license. This allows you to access the IDE and create your Visual RPG 14.0 applications.
• DataGate 14.0 for Windows Servers and Desktops � a 5 user, 30-day trial license. This allows you to create databases that run on your system.
• DataGate 14.0 WebPak � an 8 processor, 30-day temporary license. This allows you to develop and deploy web applications.

Once your 30-day trial license is expired, you will need a new trial or permanent license from ASNA to continue using the product. Uninstalling and reinstalling the product will not generate a new trial license.

The steps below will describe how to use ASNA Registration Assistant to register Visual RPG, DataGate for Windows Servers and Desktops, and DataGate WebPak. Please refer to the appropriate Readme for instructions on licensing other ASNA products.

If you purchased licenses for each product described above, you will need to repeat these steps for each product you�re licensing. For example, you would perform these steps for entering a license key for Visual RPG 14.0 for Visual Studio , then again for DataGate 14.0 for Windows Servers and Desktops, then again for DataGate 14.0 WebPak; entering the appropriate license key for each product.

1. Before the expiration of your temporary license, if applicable, contact ASNA to obtain a License Key(s) for the desired component(s) as described above.
2. Once you are given the License Key(s), enter the License Key(s) within ASNA Registration Assistant. Start ASNA Registration Assistant by selecting Start - ASNA Product Suite for Visual Studio - ASNA Registration Assistant.
   You can also select ASNA Registration Assistant.exe from the ..Program FilesCommon FilesAsna Shared folder.
   
3. Select the Product on the left that you are licensing.
4. Enter the appropriate License Key (for the product you are currently licensing) that you received from ASNA, along with the other pertinent information; such as Name, Company, Users, and License Period.
5. Select the Register Product button to accept the information, the Exit button to close Registration Assistant, or the Help button to get help on ASNA Registration Assistant.
6. Continue with these steps for each ASNA product you are licensing.

When uninstalling Visual RPG 14.0, you only need to uninstall Visual RPG 14.0 for Visual Studio, which will also remove the DataGate for Windows and/or DataGate Web Server (if installed).
See Uninstalling Visual RPG 14.0 for Visual Studio for the instructions to remove Visual RPG
If you are removing all Visual RPG and Visual Studio components from a system, it is important that you uninstall them in a particular order. You remove the products in the reverse order in which they were installed. For example, you would first uninstall Visual RPG 14.0 then MSDN (if installed), Visual Studio, and lastly, the Microsoft .NET Framework.
Follow the steps below to remove Visual RPG. Use the same steps to remove MSDN, Visual Studio and the Microsoft .NET Framework 4.0, or refer to your Microsoft documentation.

Using Visual RPG

After you have completed the installation procedure, you can start Visual RPG at any time.
To Start Visual RPG

Visual Studio Add Readme

1. Start ASNA Visual RPG by selecting Start � Programs - ASNA Product Suite for Visual Studio 2015 - ASNA Visual RPG 14.0 - ASNA Visual RPG 14.0
2. The default start page in Visual Studio will display.
   For help on using Visual Studio and Visual RPG .NET, select either Contents, Index or Search from the Help menu to display the help files for the installed Visual Studio products.

You can also open Visual Studio and create a new Visual RPG project by selecting File � New � Project � Visual RPG Projects.

After you have completed the installation procedure, you can start any of the products included with DataGate at any time.