ASNA Visual RPG® 15.0 for Microsoft Visual Studio   Readme


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/ASNAVisualRPG150forVisualStudio2017.aspx

Back to Top

Getting Started

Components You Will Need

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

  1. Visual Studio 2017 (Microsoft .NET 4.5 Framework)
    Visual Studio 2017 uses the .NET 4.5 Framework.

  2. Visual RPG 15.0
    ASNA Visual RPG is an RPG compiler that �snaps� into Microsoft�s Visual Studio 2017.

  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 (preferrably higher) 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.

  5. Administrative Privileges
    When installing Visual RPG on Windows 8 or 10 (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.

Back to Top

System Requirements to run Visual RPG 15.0

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 10 System Requirements, see http://windows.microsoft.com/en-US/windows10/products/system-requirements

Minimum Requirements

Processor

For Development (all operating systems):

   Minimum
    – 1.6 GHz or faster processor
  Recommended
    � 1.6 GHz or faster quad core processor

For Deployment:

    – 1 GHz (x86 Processor) or 1.4 GHz (x64 processor)

Operating System

Visual RPG 15.0 can be installed and deployed onto any of the following systems

- Windows Server 2012 (x64)
- Windows Server 2012 R2(x64)

- Windows Server 2016 (x64)

- Windows 8 Pro (x86 or x64)

- Windows 10 Pro (x86 or x64)

*Memory
(Please see note above)

Windows Server 2012
      Minimum:  2 GB of RAM
      Recommended:  4 GB of RAM

Windows Server 2016
      Minimum:  2 GB of RAM
      Recommended:  4 GB of RAM

Windows 8
    32 bits:
      – Minimum:  1 GB of RAM
      – Recommended:  2 GB of RAM
    64 bits:
      – Minimum:  2 GB of RAM
      – Recommended:  4 GB of RAM

Windows 10
    32 bits:
      – Minimum:  1 GB of RAM
      – Recommended:  2 GB of RAM
    64 bits:
      – Minimum:  2 GB of RAM
      – Recommended:  4 GB of RAM

Hard Disk

Minimum:  20 GB hard drive, 5400 RPM with at least 15 GB of available space
Recommended:  40 GB hard drive, 5400 RPM with at least 15 GB of available space

Graphics

Minimum:  Support for DirectX9 graphics with:

Drive

Minimum: CD-ROM

Recommended: DVD-ROM drive

Display

1024 x 768 or higher-resolution display.

Service Packs

15.0 is optimized for the latest service packs available for all Operating Systems and Visual Studio.

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

Back to Top

Installation Issues

Installing Visual RPG

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 15.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 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:

ASNA.Setup.exe [options] 

The following options are required for silent installation:

-s       Run the installation with no user interface.
-a       Accept the ASNA Software License Agreement (required to run in silent mode)

Other available installation options are:

-?        Displays the command line usage dialog.
-f        Full: Install all components.

-c        Core: Install required components.
-o        Optional: Install required and optional components.
-h        Help: Install required and help components.
-netfx35  .NET Fx 3.5: Install .NET Framework 3.5 Support if present on machine.
-np       Do not prompt the user to reboot if Reboot is required.

Note: Multiple installation options may be used.

Ex. \"ASNA.Setup.exe -s -a -o -netfx35\" will install the required components, optional components, and .NET 3.5 Support.

To repair an installation from the command line:

-r       Repair the installation.
Will repair all features that are installed and have not previously been upgraded by another product.

To uninstall from the command line:

-u       Uninstall the product.
Will remove all features that are part of the product package, are not permanent, and are not shared with other ASNA products that are currently installed on the machine.

Back to Top

Licensing ASNA Products

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).

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

To license ASNA Products

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 15.0 for Visual Studio, then again for DataGate 15.0 for Windows Servers and Desktops, then again for DataGate 15.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 Files\Common Files\Asna 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.

Back to Top

Uninstalling Visual RPG 15.0 for Visual Studio or other Components

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

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 15.0 then MSDN (if installed), Visual Studio, and lastly, the Microsoft .NET Framework.

Back to Top

Using Visual RPG

Starting Visual RPG and DataGate Studio

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

To Start Visual RPG

  1. Start ASNA Visual RPG by selecting Start � Programs - ASNA Product Suite for Visual Studio 2017 - ASNA Visual RPG 15.0 - ASNA Visual RPG 15.0
  2. The default start page in Visual Studio will display.
    For help using Visual Studio and Visual RPG .NET, select Help and ensure that Use Local Help is selected; 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

   June 9, 2017       � 2007-2017.   ASNA . All rights reserved.