Progress
Developer’s Toolkit


Time-stamp R-code

This section provides an overview of the steps to follow to deploy an application using time-stamp-based r-code when you are done developing and testing your application. For a complete discussion of time-stamp-based r-code, see the Progress Programming Handbook.

If you deploy your application to users with full development Progress products (the 4GL Development System, ProVISION, or ProVISION Plus), the users can write their own applications to both access and modify the application database. Depending on the nature of your application, you might not want this to happen. To restrict access to the database, you can use the DBRSTRCT utility that comes with the Developer’s Toolkit. For more information about using this procedure, see the "Restricting Database Access" section in Deployment Topics and Tasks."

If you decide to restrict access to the database, you must physically deploy a copy of your application database with your application, because it is not possible for users to build your database at their site. Databases are not portable, so you must generate a copy of the database for each target platform. Then you must run the DBRSTRCT utility on each platform against all of the databases.

In general, restricting access to the database makes it more difficult to initially deploy applications. The development site must:

Restricting the database removes any advantage that the portability of r-code gives you. However, it does ensure that the database schema cannot be modified.

Time-stamp-based r-code is closely coupled with the application database: both the database time stamps and the r-code time stamps must match for the application to run. It is therefore necessary to build the database on each target platform before you compile your application. To build the database, you can copy an empty database to your target platform, then load a .df file. You can also load .d files into the database.

After you create r-code for each target platform, you need to duplicate the r-code and database as a preliminary step to creating your distribution media. At your development site, you must keep a copy of the application database for each target platform.

As described in "Choosing a Code Format," r-code is not completely portable. For each combination of factors requiring a separate compilation, you have to generate and keep track of a different code tree at the development site. To do the compilations, you also need a full development Progress product (the 4GL Development System, ProVISION, or ProVISION Plus). Once you have generated the necessary code trees, you can duplicate the r-code when you create your distribution media.

Unless you explicitly specify the -tstamp parameter when you start Progress, Progress generates CRC-based r-code files at compilation.

You must transfer any .d files that are part of your application to the target platform. This is a preliminary step to creating your distribution media, which must be created on the target platform.

There is more than one way to transfer files. For example, you can use FTP or other protocols, such as CROSSTALK. You can also put the files on tape or other storage media and physically transport the files.

To aid in moving r-code files between platforms, you can use the BUNDLE utility. For more information about the BUNDLE utility, see the "BUNDLE Utility" section in Deployment Topics and Tasks."

If users have the 4GL Development System, ProVISION, or ProVISION Plus products, they have full dump/load capabilities. If users do not have these products, you must provide a dump/load facility. If the database is restricted, you must supply r-code files to dump and load. For more information, see the "Dumping and Loading" section in Deployment Topics and Tasks."

NOTE: The dump/load procedures should be considered part of your application. The decision to distribute r-code versions of your application procedures applies to the dump/load procedures as well.

You must provide a way for the users to install your application. If they do not have a Progress product installed, they must install Progress before they can use your application. You can create one install for both Progress and your application. To do this, create an install program using a third-party tool, such as Installshield, and call the Progress Install batch mode from within it.

You must provide a way for users to start the application. You can either write a script to do this or provide adequate documentation.

You must provide users with enough documentation to use your application and to perform the above tasks if you do not automate them.

You might want to provide online help for your application. For more information, see the Progress Help Development Guide.

Now you have to prepare your distribution media. It should include:


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095