Setup For Examples

Overview

A minimal EUS environment is required to run the code samples in this manual. The following configuration file and setup program loads the necessary global strings to run the examples.

Configuration file

# Use this as your config.EUS file to test the examples
# provided in this manual. Use "_acu.utl" to load this
# file into your global string table.
#
# Provide the full directory path to your sample data
# files:
DICTIONARY=
DATA=
#
# Provide the full directory path to your EUS Toolkit
# project:
PROJECT=
#
# Provide the full directory path to your PRO/5
# installation
# directory:
BBROOT=
#
# Provide the full directory path to the PRO/5 extended
# utility programs in the BBEXT global string:
BBEXT=
#
# Provide the full directory path to the PRO/5 standard
# utility programs in the BBSTD global string:
BBSTD=

Initialization program

0010 REM "Prepare Global String Table for Testing EUS
0010:Toolkit
0020 LET TRASH$=STBL("NEWLINE_CHAR","\")
0030 LET TRASH$=STBL("COMPANY","BASIS International,
0030:Ltd.")
0040 LET TRASH$=STBL("LANGUAGE","am")
0050 LET TRASH$=STBL("HELPFILE","thelp")
0060 LET TRASH$=STBL("HELP","(PROJECT)help/")
0070 LET TRASH$=STBL("MENUS","(PROJECT)menus/")
0080 LET TRASH$=STBL("SECURITY",
0080:"ABCDEFGHIJKLMNOPQRSTUVWXYZ")
0090 LET TRASH$=STBL("TRANSLATE","")
0100 LET TRASH$=STBL("SYSTEM","")
0110 LET TRASH$=STBL("KEYMAP","(PROJECT)mykeys")
0120 CALL "_acu.utl","EUS"
0130 LET BBEXT$=STBL("BBEXT")
0140 CALL BBEXT$+"_lkeymap.utl"
0150 END

Personalizing Your Configuration

Individual users may want specific environment characteristics, and different projects may require separate locations for source and data files. The TPM environment variable invokes PRO/5 with a personalized copy of the configuration file.

For example, a PRO/5 developer may prefer configuration settings stored in a file called sys/config.DLM. Before invoking PRO/5, an operating system environment variable called TPM is set equal to the full path and location of this personal file. The EUS Toolkit locates the file config.DLM in the sys directory and uses the preferred settings and file locations while running.

In a UNIX or similar operating system (Bourne or Korn shell), execute a command line similar to:

$ TPM=/basis/pro5pm/sys/config.DLM;export TPM
$ pro5 -m1024 myapp

In a UNIX or similar system (C shell), execute a command similar to:

% setenv TPM /basis/pro5pm/sys/config.DLM
% pro5 -m1024 myapp

In MS-DOS, execute a command similar to:

c:\ > SET TPM=c:\basis\pro5\sys\config.dlm
c:\ > pro5 -m1024 myapp

Some developers may prefer different configuration files for different applications. Once the various configuration files are defined, invoke a new application and specify the desired configuration file in a command line option. For example:

pro5 -m1024 "myapp" TPM=c:\basis\pro5pm\sys\config.dlm