Fullscreen
Loading...
 
[Show/Hide Left Column]
[Show/Hide Right Column]

Print

Alpha Five Runtime License

The Alpha Five Runtime allows other users to run your Alpha Five applications, but not to modify them (with certain exceptions). The following Runtime products are available.

Product

Description

Runtime

No user modifications allowed.

Runtime+

Allows modification of Reports, Letters, and Labels

Netmailer for Runtime

Has the same features as the Netmailer standard edition, but can be distributed with an Alpha Five Runtime application.

ReportMailer for Runtime

Has the same features as ReportMailer , but allows for unlimited distribution with an Alpha Five Runtime Application. Not available for V5 Runtime

Note : You (the developer) will need a full copy of Alpha Five in order to create the applications that you wish to distribute with the Alpha Five Runtime. The Runtime is an inexpensive way for you to distribute your Alpha Five applications to other users, without requiring these users to purchase a full copy of Alpha Five.

The Alpha Five Runtime is ideal for commercial developers who would like to sell applications that they have developed in Alpha Five. It is also ideal for corporate developers who have developed an application that they would like to deploy to many users within their organization.

Runtime users cannot make any modifications to your application, or add new objects to the application. For example, Runtime users cannot:

  • Edit layouts (such as forms or reports)

  • Create new layouts

  • Edit table structures

  • Edit field rules

  • Define or delete indexes

  • Create new tables or sets

  • Edit scripts

  • Create new scripts

In addition, Runtime applications cannot use the ODBC Import Genie, or ODBC_IMPORT_TABLE() function. You can design your application so that the fact that the application is written in Alpha Five is largely hidden from your customers or users. For example you can:

  • Specify your own splash screen image to display when the Runtime loads

  • Turn off the splash screen completely when the Runtime loads

  • Specify your own icon to display on the Runtime Title bar, and on the Task bar

  • Specify your own title for the Title bar and Task bar, rather than the standard "Alpha Five" title.

  • Customize all menus and toolbars.

Distributing Runtime Applications - Licensing Issues

The number of users who can use your application concurrently on any network is based on the type of Runtime that you purchased. The people to whom you distribute the Alpha Five Runtime may not, in turn, distribute any copies of the Alpha Five Runtime. For example, if you purchased an "Unlimited 10-User Runtime", then a maximum of 10 users can use your application concurrently on any particular network. If you purchased an Unlimited User Runtime, then there are no limitations on the number of concurrent users of your application.

How to Distribute a Runtime Application

In order to distribute an application to another user, you must distribute a copy of your own application files, and a copy of the Alpha Five Runtime. You retain the copyright on your application files. Alpha Software retains the copyright on the Alpha Five Runtime files. You are free to make copies of the Alpha Five Runtime Installation Program (setup.exe) to distribute to your users. You can burn your own CDs with these files.

You will have to create another installation program to install your application files. These files are the files with the following extensions:

Extension

Description

ADB

Alpha Five Database

ALB

Data Dictionary for Database

ALM

Data Dictionary for Database (memo file)

ALX

Data Dictionary for Database (index file)

CDX

Index file for a table

DBF

Table

DDD

Data Dictionary for a table

DDM

Data Dictionary for a table (memo file)

DDX

Data Dictionary for a table (index file)

FPT

Memo file for a table

SEM

Set (memo files)

SET

Set

SEX

Set (index file)

It is recommended that when you develop your application, you place all of the files that belong to that application in a single folder. Then you can be sure that as long as you install all of the files from this folder on your users' machines, you will have included all of the necessary application files.

To create an installation program for your application you can use the Alpha Five Installation Maker , or you can use a 3rd party program (such as  InstallShield or Wise Install Maker ).

The Alpha Five Installation Maker

The Alpha Five Installation Maker is only enabled if you have both the full version of Alpha Five and the Runtime version of Alpha Five installed on the same computer. To access the Installation Maker, start the full version of Alpha Five (not the Runtime version), display the Control Panel, and select Tools > Utilities. Click Help on the dialog for more information.

Installing a Runtime Application on a User's Computer

You should install the Alpha Five Runtime on each user's local machine. DO NOT INSTALL A SINGLE COPY OF THE RUNTIME ON A SERVER FOR USERS TO SHARE FROM THEIR DESKTOPS. Doing so could result in serious performance degradation.

If your application is designed to be run in a network environment, you should consider taking advantage of Alpha Five's Network Optimization feature. You should install a master copy of your application on a shared folder on the network, and you should also install shadow copies of your application (created using Alpha Five's Network Optimize command) on each user's local machine.

Remember:

  • Each client workstation must have read/write privileges to the database folder on the "server".

  • Each user must have read/write privileges to the registry on their workstation (i.e. as a Power User or Administrator).

Starting the Alpha Five Runtime

To start the Alpha Five Runtime, you can use the following command:

alpha5 <.adb file> -TITLE=<title> -ICON-<icon> -SPLASH=<splash> -NOSPLASH -INCLUDE=<file>

NOTE: An easy way to generate the command line syntax for starting Alpha Five is to use the Shortcut Genie (See the Tools > Create Shortcut... command) to create a shortcut. The right click on the shortcut that Alpha Five created and examine the properties of the shortcut. You will see that Alpha Five has generated the correct syntax for starting your application.

Command Line Option

Description

Example

-TITLE=<title>

Change the displayed title for the main Alpha Five window.

-TITLE="Customers"

-SPLASH=<bitmap>

Change the splash screen bitmap that displays when the Alpha Five Runtime loads.

-SPLASH=clock.bmp

-ICON=<icon>

Change the icon that displays on the Alpha Five Runtime title bar.

-ICON=logo.ico

-NOSPLASH

Do not display a splash screen when the Alpha Five Runtime loads.

-NOSPLASH

-COMMAND=<xbasic>

Runs the specified Xbasic commands after the Alpha Five Runtime starts.

 

-INCLUDE=<file>

When you have more command line options than can fit on one line, you can create an ASCII file with the command line options in the file. Put one option per line. Use this option to specify the name of the ascii file.

-INCLUDE=start.txt

-HELP

Get help on the command line parameters

 

IMPORTANT : Do not leave any spaces between the option name and the '=' sign. E.g. -TITLE="Invoice", NOT -TITLE = "Invoice"

The following example shows how the Alpha Five Runtime Title bar can be changed:

Runtime Title bar with a custom icon and title

Runtime Title bar with standard icon and title

The following example shows how the Windows Task bar can be customized to show your own icon for the Alpha Five Runtime:

Task bar showing Runtime with a custom icon and title

Task bar showing Runtime with standard icon and title

Examples

The following command starts the Alpha Five Runtime, loads a database (an .adb file) called "Orders" that is stored in the "c:\Orders" folder, changes the title of the Alpha Five Runtime title bar to "Orders", uses a bitmap called "NewAgeSolutions.bmp" for the splash screen, and uses an icon called "orders.ico" for the icon on the Title bar and the Task bar:

C:\a5runtime\alpha5.exe "c:\orders\orders.adb" -title="Orders" -splash="NewAgeSolutions.bmp" -icon="orders.ico"

The following command starts the Alpha Five Runtime, loads a database called orders, and opens a file called "start.txt" which contains a list of command line options:

C:\a5runtime\alpha5.exe "c:\orders\orders.adb" -include=start.txt

Start.txt is an ASCII file that might contain the following text:

-title="Orders"

-splash="NewAgeSolutions.bmp"

-icon="orders.ico"

The following command starts the Alpha Five Runtime, loads a database called orders, and defines, then sets a global variables:

C:\a5runtime\alpha5.exe "c:\orders\orders.adb" -COMMAND="DIM GLOBAL VPath as C; VPath = \"myfile.adb\""

Note : that the quotes in the command Vpath = "myfile.adb" need to be prefixed with a slash ( \ ) to indicate that they are not the end of the command being passed to the Alpha Five Runtime.

How to Make a Shortcut

After starting Alpha Five from the Control Panel, select Tools > Create Shortcut... .

See Also

Designing an Application for Alpha Five Runtime, Runtime Compared to Runtime+, InstallMaker, Netmailer Overview

Supported By

Alpha Five Version 5 and Above


Created by admin. Last Modification: Wednesday 28 of December, 2011 13:09:07 EST by mheller.

Print