ASNA Visual RPG® 8.1
for Microsoft® Visual Studio® 2005
Installation Notes
Release Notes
Installation Notes
To run Visual RPG 8.1 for Visual Studio 2005, you will need the following
components on your system:
1.
Microsoft
.NET 2.0 Framework and Visual Studio 2005
Visual RPG 8.1 for Visual
Studio 2005 uses the .NET Framework and Visual Studio 2005.
Note: The .NET
3.0 Framework is part of the Windows Vista operating system. Therefore, you
do not need to install the Microsoft .NET 3.0 Framework onto a system in which
Windows Vista has been installed.
2.
Visual RPG
8.1 for Visual Studio 2005
ASNA Visual RPG 8.1 for
Visual Studio 2005 is an RPG compiler that “snaps” into Microsoft’s Visual
Studio 2005.
3.
ASNA DataGate® for
System i
If
you are going to access the data on your AS/400 (System i), ASNA DataGate for
IBM System 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 System 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 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.
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 8.1 for Visual Studio 2005; you just cannot start the
DataGate Service until you do.
6.
Licensing
Requirements
A new
installation of Visual RPG 8.1 for Visual Studio 2005 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 8.1 for Visual Studio 2005 –
30-day temporary license. This allows
you to access the IDE and create your AVR for .NET applications.
§
DataGate for Windows Servers and Desktops –
a 5 user, 30-day trial license. This allows
you to create databases that run on Windows NT, 2000 and XP operating systems.
§
DataGate WebPak 8.x – 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.
System
Requirements to run Visual RPG 8.1 for
Visual Studio 2005
Since Visual Studio 2005 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.
|
Minimum
Requirements
|
|
Processor
|
Windows 2000, Windows Servers and Windows
XP:
Minimum: 450-megahertz (MHz) Pentium II-class processor,
Recommended: 600-MHz Pentium III-class processor recommended
Windows Vista:
Minimum: 800 MHz processor
Recommended:
1 GHz 32-bit (x86) processor
|
|
Operating
System
|
Visual RPG 8.1 for Visual Studio 2005 can
be installed and deployed onto any of the following
systems:
- Windows 2000
Professional SP4
- Windows 2000 Server
SP4
- Windows Server 2003
- Windows XP
Professional SP2
- Windows Vista
Business Edition only
|
|
*Memory
(Please see note above)
|
Windows Server 2005:
Minimum: 160 MB of RAM
Recommended: 3920 MB of RAM
Windows XP Professional:
Minimum: 160 MB of RAM
Recommended: 3920 MB of RAM
Windows 2000 Professional:
Minimum: 160 MB of RAM
Recommended: 3920 MB of RAM
Windows 2000 Server:
192 MB of RAM
Windows Vista Business Edition:
Minimum: 512 MB of RAM
Recommended: 1 GB of RAM
|
|
Hard
Disk
|
Minimum: 20 GB hard drive with at
least 15 GB of available space
Recommended: 40 GB hard drive with at
least 15 GB of available space
|
|
Graphics
|
Minimum: Support for Super
VGA graphics
Recommended: Support for DirectX
9 graphics with:
- WDDM Driver
- 128 MB of graphics memory (minimum)
- Pixel Shader 2.0 in hardware
- 32 bits per pixel
|
|
Drive
|
Minimum: CD-ROM
Recommended:
CD-ROM or DVD-ROM drive
|
|
Display
|
Super VGA (1024 x 768) or
higher-resolution display with 256 colors.
|
|
Mouse
|
Microsoft Mouse or compatible pointing
device.
|
Getting Started
Prior to Installing Visual RPG 8.1,
ensure that you have performed or have the following components on your system.
Checklist to Perform Prior to Installing Visual RPG
8.1 for Visual Studio 2005
1.
Ensure
that your system meets the necessary system
requirements required by Visual Studio 2005 and Visual RPG 8.1 for Visual
Studio 2005.
See System requirements for further information.
2.
Ensure that IIS
is installed on your system.
See IIS
for further information.
3.
Ensure that you are signed on with Administrative Rights.
See
Administrative Privileges for further
information.
Installing Visual RPG 8.1 for
Visual Studio 2005
After the Visual
Studio 2005 Professional Edition has been installed, you only need to install
the stand-alone version of Visual
RPG 8.1 to install Visual RPG 8.1 for Visual Studio 2005 for the first time, or
to install a newer version of Visual RPG 8.1.
You can install Visual RPG 8.1 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 install by
selecting the appropriate options from the CD Browser that will automatically
display when the ASNA Product Suite CD is inserted in the CD-Rom drive, as
described below.
Installing Visual RPG 8.1 for Visual
Studio 2005 will also automatically install Release 8.1 of the 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
on Windows 2000, Windows XP, or Windows Vista:
When installing Visual RPG 8.1 for Visual Studio 2005 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.
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 8.1 for Visual Studio 2005, you just cannot start the DataGate Service until you do.
To Install from ASNA Developer Network (DevNet.asna.com)
-
Go to
http://devnet.asna.com.
-
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.
-
Once you are signed in, click on
the Downloads
link at the top.
-
Scroll down and select the
product and version you wish to download.
-
On the next screen, the list of
products in the product suite selected will display for you to select from.
-
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 ASNA
Visual RPG® 8.1 for Microsoft® Visual Studio® 2005.
3. 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.
4.
After the setup file is located, the
Welcome screen will display. Select Next >
to continue.
5. The
installation process will automatically begin, and the component being
installed will display in the title bar.
Visual RPG 8.1 for Visual Studio 2005 will install, as well as ASNA
Client for .NET, Examples and Visual RPG 8.1 for Visual Studio 2005 Help. Please note that the installation process
will take awhile, and could take up to approximately 10 minutes.
6.
When the
installation has completed, you will be prompted to restart your computer
now. Select No if you will restart your computer later. Select the Finish button to close the
installation.
7.
All
installation dialogs will close, and you will not be taken back to the Visual
RPG 8.1 for Visual Studio 2005 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 2005 and Visual RPG 8.1.
Licensing ASNA Products
A new installation
of Visual RPG 8.1 for Visual Studio 2005 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 8.1 for Visual Studio 2005 –
30-day temporary license. This allows
you to access the IDE and create your Visual RPG 8.1 applications.
§
DataGate 8.1 or Windows Servers and Desktops –
a 5 user, 30-day trial license. This
allows you to create databases that run on your system.
§
DataGate
8x 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.
To License Visual RPG 8.1 for
Visual Studio 2005, DataGate 8.1 for Windows Servers and Desktops, or ASNA
DataGate 8.1 WebPak
The steps below
will describe how to use ASNA Registration Assistant to register one of the
components, but the steps are exactly
the same for any ASNA Product you’re registering.
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 8.1 for Visual Studio 2005, then again for DataGate 8x for Windows Servers and Desktops, then again
for DataGate 8x WebPak; entering the
appropriate license key for each product.
1.
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 .Net Product Suite -
ASNA Registration Assistant.
You can also
select asnakeys.exe from the ..\Program
Files\Common Files\Asna Shared folder.
3.
The Registration Assistant dialog will
display. You must first select the Product that you are licensing.
The
Product name will vary for each product you are licensing. In the example below, the product displayed
is ASNA DataGate 8.1 WebPak, but
could also be Visual RPG 8.1 for Visual
Studio 2005 or DataGate 8.1 for Windows
Servers and Desktops.
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 to License a product
for each ASNA product you are licensing.
After you have completed the
installation procedure, you can start Visual RPG 8.1 for Visual Studio 2005 at
any time.
To
Start Visual RPG 8.1 for Visual Studio 2005
1.
Start
ASNA Visual RPG by selecting Start –
Programs - ASNA .NET Product Suite - ASNA Visual RPG 8.1 for Visual Studio 2005 - ASNA Visual RPG 8.1.
2.
The default
start page in Visual Studio 2005 will display.
For help on using Visual Studio 2005 and Visual RPG .NET, select either Contents, Index or Search from the Help menu to display the help files for
the installed Visual Studio 2005 products.
You can also open Visual Studio 2005 and create a new
Visual RPG project by selecting File
– New – Project – Visual RPG Projects.
Starting DataGate
After you have completed the installation procedure, you
can start any of the products included with DataGate at any time.
To
Start DataGate
1.
Start
a DataGate product by selecting Start –
Programs - ASNA .NET Product Suite - DataGate.
2.
Select the
desired product to open.
3.
For help on using any of the products, select Contents from the Help menu to display the On-line help.
When uninstalling Visual RPG 8.1, you only need
to uninstall Visual RPG 8.1 for Visual
Studio 2005, which will also remove the DataGate for Windows Servers and
Desktops and/or DataGate Web Server (if installed).
See Uninstalling Visual
RPG 8.1 for Visual Studio 2005 for the instructions to remove Visual RPG
8.1 for Visual Studio 2005.
If you are removing all Visual
RPG 8.1 for Visual Studio 2005 and Visual Studio 2005 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 8.1 for Visual Studio 2005, 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 2.0, or refer
to your Microsoft documentation.
Please note that Visual Studio 2003 (Visual RPG 7.2) and
Visual Studio 2005 (Visual RPG 8.1) can run concurrently on the same
machine.
When a Visual RPG 2003 project is opened in
Visual Studio 2005, it will be converted to Visual Studio 2005
format and may no longer be opened by Visual Studio 2003. You will be prompted
before the update is conducted. It is recommended that you backup your 7.2
solutions prior to opening them in 8.1.
Visual
RPG 8.1 requires Visual Studio 2005 Professional Edition or Team Edition
You must have Visual Studio 2005
installed prior to installing Visual RPG.
Web
Project Conversion from Visual Studio 2005
Microsoft Visual Studio 2005 manages Web
site projects and files differently than Visual Studio .NET 2003. As a result,
when you want to use Visual Studio 2005 to work with a project that was created
in Visual Studio .NET, the project must be converted to the new Visual Studio
format. The process happens automatically when you open a Visual Studio .NET
project in Visual Studio 2005; the conversion wizard will convert your Web
application and minimize the amount of manual editing that is needed to finish
the conversion.
File System Web Sites
Visual Web
Developer allows you to keep the files for your Web site in a folder on your
local hard disk or in a shared location on your local area network. This is
called a file system Web site. Using such a file system Web site means that you
do not need to create your site as an Internet Information Services (IIS)
application to develop or test it. Y ou will typically find File System Web
Sites much easier to work with than http Web Sites.
Major
New features in Visual RPG 8.1 and DataGate 8.1
The following is a list of some features in
this release. Please refer to the Help Files for the
latest Features.
· Autocomplete
RPG command syntax prompting (Ctrl+Space).
· MSBuild
support.
· Implemented
Dynamic References; CALLD, CALLB, DCLPROTOTYPE (Monarch).
· Support
for .. / - , & separators in TimFmt keyword for the Data and Time operation
codes.
· Added
*NS; name of the current namespace as a string, ending with a dot (.).
· Added the following opcodes:
CABXX
CALLD
CASXX
DCLPROTOTYPE
EVALR
Bug Fixes in this Release
Please refer to the list of bug fixes in this release in the
Release Notes on the Downloads page at
http://devnet.asna.com/downloads.
Walkthroughs
There are several Web and Windows walkthroughs
available in 8.1. Walkthroughs provide step-by-step instructions for common
scenarios and are a good place to start learning about the product.
To Quickly access
the Visual RPG Walkthroughs
·
Select
the Visual RPG Walkthroughs link in
the Getting Started section of the Dynamic help window.
·
Enter
"walkthroughs, Visual RPG"
in the Help Index.
·
Select on
Samples and Walkthroughs -
Walkthroughs books in the Help
Contents.
The location of examples has changed in this release of
Visual RPG 8.1. You can access the examples with either of the following
options, based on the operating system you're installing on.
For Windows Vista systems,
you can open with either of the following options:
-
x:\Users\<Current
User>\Documents\ASNA Examples
-
Select Start button- Documents
<link on right side under User> - ASNA Examples
-
Select Start button - All
Programs - ASNA .Net Product Suite - ASNA Visual RPG 8.1 for Visual Studio
2005 - Visual RPG 8.1 Samples
For Windows XP (or
non-Vista system), you can open with either of the following options
-
x:\Documents and Settings\<Current User\My
Documents\ASNA Examples\
-
Or you can select Start - My
Documents - ASNA Examples
-
Start - Programs - ASNA .Net
Product Suite - ASNA Visual RPG 8.1 for Visual Studio 2005 - Visual RPG 8.1
Samples
Back
to Top
|
11/02/2007
© 2007. Amalgamated Software of North
America. All rights reserved.
|
