Jargon Building Blocks^TM
Installation Instructions

The Jargon Writer "jsi" host procedures must be already installed on your host system before installing Jargon Building Blocks.  See the Jargon Writer Installation Instructions for further details.

To install Jargon Building Blocks, do the following steps:

1. Install Client Files

Unzip the "jsxapp[vers].zip" file into your Jargon Writer working directory.  This will install the following files under your Jargon Writer working directory:

2. Install Host Procedures

Copy the Progress source procedures to your host and uncompress them within your application's working directory. Also see "Host Software Installation for Progress" for details on this process. This step will install the following files under the application working directory on your unix or NT host system:

jrep/include/*.i
jsx/*.p
jsx/*.i
jsx/api/*.p
jsx/data/*.d

2.1 For unix systems, use the "binary" option in FTP to copy "jsxprog[vers].tar" to the application working directory, then enter the command "tar -xvf jsxprog[vers].tar" to uncompress it.

2.2 For Win32 systems, copy the "jsxprog[vers].zip" file to the application working directory and use pkunzip or WinZip to unzip it.

Next, use any text editor to find the line in "jsi/jsi.ini" that reads:

          &GLOBAL-DEFINE UseBldBlks FALSE

and change the FALSE to TRUE (don't use quotes), so that the include files in the jsi directory will use Building Blocks logic in addition to the standard logic.

3. Build the XFiles Database Tables

Copy the XFiles database schema definitions to your host and uncompress them. This step will install the "xfiles.df" schema definition file in a directory of your choice (wherever you locate your database files, possibly on a different host than the programs).

3.1 For unix systems, use the "binary" option in FTP to copy "jsxdb.tar" to the database directory, then enter the command "tar -xvf jsxdb.tar" to uncompress it.

3.2 For Win32 systems, copy the "jsxdb.zip" file to the database directory and use pkunzip or WinZip to unzip it.

With the Progress Data Dictionary, use this "xfiles.df" to build a new database or to add its tables and sequences to an existing database that is used by your application. The xfiles database tables will self-initialize when the first user login is done (use a blank UserID and password). This initialization will create a temporary "sa" UserID and certain system code records, and will also load the contents of several exported ".d" data files from the "jsx/data" directory.

NOTE: The xfiles database definitions include both sequences and tables. When dumping and reloading an "xfiles" database, be sure to dump and reload the sequences ".d" file as a separate step, since specifying "all" table contents does not include sequences. It's a separate step in the Data Dictionary for both dumping and loading.

(optional) For better performance, use RDU or a Progress editor session to compile the ".p" programs in the "jsx" directory. There is a jsx/complist.txt file that can be used for batch compiling in RDU or otherwise.

Copy the Building Blocks online help file to your web server and uncompress it under the web server's document root directory. This will uncompress as "doc/jsx/*".

       For Win32 systems, use "jsxhelp[vers].zip".
       For unix systems, use "jsxhelp[vers].tar".

For detailed configuration instructions for the many Building Blocks features, see the Building Blocks Installation and Configuration Notes document.

For Additional Assistance
If you have questions or problems not covered by this document, see the additional assistance section in the installation instructions index.

Up to Top    Installation Instructions Index     Return to Help Index