ASNA Visual RPG® 10.2 for Microsoft® Visual Studio® 

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

Back to Top

Getting Started

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

1. Visual Studio 2010 or Visual Studio Shell (Microsoft .NET 3.5 Framework)
   Visual Studio 2010 uses the .NET 3.5 Framework.

2. Visual RPG 10.2 for Visual Studio
   ASNA Visual RPG 10.2 for Visual Studio is an RPG compiler that “snaps” into Microsoft’s Visual Studio 2010.

3. ASNA DataGate® for IBM i
   If you are going to access the data on your AS/400 (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 OS/400 is at 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, select Start - Settings - Control Panel - Administrative Tools - Internet Information Services

   • If Internet Information Services is there, IIS has been installed and added.
   • If Internet Information Services is not there, you will need to install IIS. (basic instructions)
     1. From the Start menu, select Control Panel, and then click Add or Remove Programs.
     2. Select Add/Remove Windows Components (last icon on the left). The following screen will display.
     3. Scroll down just a little, and select the Internet Information Services (IIS)option.

5. Aministrative Privileges
   When installing Visual RPG on Windows 2000, XP, Vista, or 7 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 10.2 for Visual Studio 2010; you just cannot start the DataGate Service until you do.

6. Licensing Requirements
   A new installation of Visual RPG 10.2 for Visual Studio 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 10.2 for Visual Studio 30-day temporary license. This allows you to access the IDE and create your AVR for .NET applications.
   • DataGate 10x 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 10x 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.

Back to Top

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 Vista Machines:
To ensure your system is Vista-ready, Microsoft provides a software tool called Windows Vista Upgrade Advisor that checks your system and lets you know if your Windows XP-based PC can run Windows Vista. This small tool will scan your computer and create an easy-to-understand report of all known system, device, and program compatibility issues, and recommend ways to resolve them.

Download the Upgrade Advisor at: http://www.microsoft.com/windows/products/windowsvista/buyorupgrade/upgradeadvisor.mspx?wt_svl=20409a&mg_id=20409b

For more information of Vista System Requirements, see http://www.microsoft.com/windows/products/windowsvista/editions/systemrequirements.mspx

Back to Top

IInstallation Issues

After the Visual Studio  Professional Edition has been installed, you only need to install the stand-alone version of Visual RPG 10.2 to install Visual RPG 10.2 for the first time, or to install a newer version of Visual RPG 10.2. You can install Visual RPG 10.2 from either the ASNA Product CD, or from the Downloads page on ASNA’s Developer Network web site http://devnet.asna.com Installing from the CD is an easy option: Install by selecting the appropriate options from the CD Browser which will automatically display when the ASNA Product Suite CD is inserted in the CD-Rom drive, as described below.

Installing Visual RPG 10.2 for Visual Studio will also automatically install Release 10.2 of the DataGate for Windows Servers and Desktops.

Installing on Windows 2000, Windows XP, Windows Vista, or Windows 7:

When installing Visual RPG 10.2 for Visual Studio 2010 on Windows 2000 or Windows XP, 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.

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

1. Go to http://devnet.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.

To Install from ASNA Product Suite CD

1. Insert the ASNA Product Suite CD into your CD drive
   • If your CD drive has AutoPlay, a screen will automatically appear.
   • Select the options below to install AVR.
   • If you do not have AutoPlay installed on your CD drive, start Microsoft Windows and from the Start Menu, select Run, and enter the path: E:\ Setup.EXE, where ‘E’ is the CD-Rom drive. Then select the options below to install AVR.

2. Select the Select the INSTALL button.
   
   You can also view the Readme file by clicking the READ ME button.
   
   Note:  On Windows Vista systems, you will be prompted to Allow the software to run.  Select Allow to Continue.

3. After the setup file is located, the Welcome screen will display.  Select Next to continue.
4. The installation process will automatically begin, and the component being installed will display in the title bar. Visual RPG 10.2 for Visual Studio will install, as well as ASNA Client for .NET, Examples and Visual RPG 10.2 for Visual Studio Help. Please note that the installation process will take a while, up to approximately 10 minutes.
5. When the installation has completed, you will be prompted to restart your computer now. Select omputer now. Select No if you will restart your computer later. Select the Finish button to close the installation.
6. All installation dialogs will close, and you will not be taken back to the Visual RPG 10.2 for Visual Studio  Setup menu. The installation process to install Visual RPG has been completed.

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

Back to Top

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

• RPG 10.2 for Visual Studio –30-day temporary license. This allows you to access the IDE and create your Visual RPG 10.2 applications. ications.
• DataGate 10x for Windows Servers and Desktops – a 5 user, 30-day trial license. Thisallows you to create databases that run on your system.
• DataGate 10x 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.

Back to Top

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

Back to Top

When uninstalling Visual RPG 10.2, you only need to uninstall Visual RPG 10.2 for Visual Studio, which will also remove the DataGate for Windows Servers and Desktops and/or DataGate Web Server (if installed).

See Uninstalling Visual RPG 10.2 for Visual Studio for the instructions to remove Visual RPG 10.2 for Visual Studio

If you are removing all Visual RPG 10.2 for Visual Studio 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 10.2 for Visual Studio, 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 3.5, or refer to your Microsoft documentation.

Back to Top

Using Visual RPG

After you have completed the installation procedure, you can start Visual RPG 10.2 for Visual Studio at any time.

To Start Visual RPG

1. Start ASNA Visual RPG by selecting Start – Programs - ASNA Product Suite for Visual Studio 2010 - ASNA Visual RPG 10.2 - ASNA Visual RPG 10.2
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.

Back to Top