Conetic Software Systems, Inc.

Create a new group ID account named conetic. To create a new group account, follow the procedure outlined in your Operations/System Administration Guide.

Create a new login ID called cbase. When creating the login ID cbase, the group ID entry for the user "cbase" must correspond to the conetic group ID number created in step 1.1. To create the "cbase" login ID, follow the procedure given in your Operations/System Administration Guide.

Make a home directory for the cbase login ID, changing the owner and group ID of the directory to cbase and conetic.

NOTE: If you created the new user following the procedure outlined in your Administrator’s Guide, the home directory for the user cbase may have already been created. It is the responsibility of the system administrator to ensure a directory has been created for the user cbase with the correct ownership ID’s.

C/Base will run under either the bash or sh shell environments. The menu and report programs use the environment variable SHELL to execute other programs. If the SHELL environment variable is not set, the default is set to /bin/sh. The SHELL variable can be set as follows:

# SHELL=/bin/sh
# export SHELL

You must set the TERM environment variables before running the install program.

Partial Supported Terminal Listing:

wyse50, tvi925, 605, xterm, vt100, tvi970, 4410, 5410, 4425, console

# TERM=terminaltype
# export TERM

NOTE: The typical FreeBSD terminal is automatically set.

The following instructions describe how to install from either a diskette distribution or from a FTP download file. The unzip of the files is the same for both types of distribution (step 2.4). If you are using the diskette distribution please proceed to Section 2.2. If you are using the FTP distribution skip to Section 2.3.

Insert distribution disk #1 into the disk drive and enter the following:

# cd /home/cbase /*example dir only*/

# tar -M -xf /dev/fd0

The tar command will prompt you for each disk in order and will build a gzipped tar file.

NOTE: The directory you install to may be different than the above, this is for example only.

NOTE: The floppy drive device name may differ on your machine. Please make the appropriate changes to the instructions. See Appendix C for example device names.

Please proceed to Section 2.4 for setup instructions.

Download the files README (this file) and CBASE_fbsd_r004.tar.gz. Place these files in the directory that you will install C/BASE. Please proceed to Section 2.4 for setup instructions.

From the directory where C/BASE will be installed, please enter the following commands:

# umask 000

# gzip -d ./CBASE_fbsd_r004.tar.gz

/* this will process for a few minutes */

# tar -xf ./CBASE_fbsd_r004.tar

The C/BASE database catalog must be setup to look to the directory you installed to. The following command will handle all necessary setups and build a start-up file called cbase_env (see section 2.6). Please enter the following from the C/BASE directory:

# install.me

With C/BASE now installed you may logout of root and login as a C/BASE user. The install.me script will create a file called cbase_env in the C/BASE home directory. The cbase_env script will set the mandatory environment variables required for C/BASE (see section 3.1). The script must be run as follows:

$ . ./cbase_env

You may now begin the magazine demo with the command:

$ start demo

You can modify the magazine demo with the command:

$ toolkit demo

or create your own application with the command:

$ toolkit my_app

You can examine and modify C/BASE system parameters with the command:

$ start cbase

Please see the C/Base Reference Manual for more details.

You must set the TERM, CBASE, PATH, TMPDIR and PRINTER environment variables before running any C/BASE or C/BOOKS programs. The next steps describe the commands to set these variables. You should add the commands to the /home/cbase/.profile and the .profile in the home directory of each C/BASE user so these steps need not be repeated each time you log in.

Set the TERM environment variable to the correct terminal type. See the /home/cbase/lib/cbase/escape directory for all available terminal types.

$ TERM=terminaltype

$ export TERM

NOTE: The C/BASE package includes definitions for several popular terminals. If your terminal is not on the list, you must define it with the C/BASE program termset or, it must be defined with the terminfo utilities.

Set the CBASE environment variable.

$ CBASE=/home/cbase/lib/cbase

$ export CBASE

Set the PATH environment variable to search the cbase program directory.

$ PATH=/home/cbase/bin:$PATH

$ export PATH

Set the TMPDIR environment variable.

$ TMPDIR=$HOME

$ export TMPDIR

Each user must have a unique TMPDIR work area. This can be achieved by setting

TMPDIR=$HOME

Set the PRINTER environment variable to the command or filename where printed output is to be redirected. The default print spooler for the C/BASE software is lpr. To override the default print spooler, enter:

$ PRINTER=spooler-command

$ export PRINTER

For example, if you want printed output to go to the lpr print spooler without displaying the spooler ID messages, enter:

$ PRINTER=lpr

$ export PRINTER

If you have finished installing Conetic C/BASE software onto your computer system and you have installed the C/BASE Development System, there is a demonstration application called demo that you (logged in as cbase) can run as follows:

$ start demo

You can examine and modify the "DEMO" application with the following command:

$ toolkit demo

C/BASE now supports on-line manual pages. The man pages are initiated by the command:

$ cssman command

If the command is omitted, then cssman will display a table of contents of all commands. An information bar at the bottom of the manual screen displays paging options and exit commands. See Appendix D and E for a list of Commands and Functions.

An unlimited number of printers may be setup in C/BASE. The printer setup utility can be run from the C/BASE catalog menu.

$ start cbase

/* menu selection: E6 - Printer Setup Utility*/

The printer setup utility can also be accessed from the toolkit menu.

$ toolkit demo

/* menu selection: 7 - Printer Setup */

NOTE: All applications use the same printer file. You do not need to setup printers for each application.

The printer setup utility form will not allow you to select a unique id for each printer (27, 1150, etc.), a name for that printer (Apple1, MyPrinter, etc.), a device or spooler for that printer, and a reset escape sequence. The reset escape sequence is used to restore the printer back to its original printing mode. If you print a report in compressed mode without resetting the printer, all documents printed afterwards will be in compressed mode.

After the printer has been named press F5 to store it. Each named printer can have up to 5 different printing attributes. For each of the 5 attributes you can set page dimensions and printing modes (compressed, landscape, etc.)

There are 4 dimensions for a page:

• pagelength - The page length is the total number of lines that can be printed per page. Default=66 lines.

• pagewidt - The page width is the total number of characters per line. Default=132 chars..

• firstline - The firstline number indicates the line on which to begin printing on. Please note that the first line is reserved for invisible printer codes, therefore the firstline number MUST be greater than one. Default=2.

• lastline - The lastline indicates the last line of print before going to the next page. The value must be less than the pagelength. Default=64.

The defaults are automatically set in the printer setup form and may be manually overridden.

Printing modes are controlled through the use of escape sequences which can be found in your printer manual. Enter a meaningful name for the sequence and then enter the escape sequence itself. The escape sequence can be entered in two ways:

1) As characters where the escape character "^[" is represented by "ESC".

Example: The LaserJet manual says the landscape escape sequence is "^[&110" (no quotes). You would enter "ESC&110" (no quotes) into the escape sequence field.

2) Or as equivalent decimal numbers for each character where the escape character "^[" is represented by 27.

Example: The LaserJet manual says the landscape escape sequence is "^[&110" (no quotes). You would enter "27 38 108 49 79" (no quotes) into the escape sequence field.

Before entering this form you will be asked which method to use. The escape sequences are translated through the form. Therefore, if you enter the escape sequences as characters the first time through and decide to later update them as decimal numbers, just select the appropriate method and your previous entries are displayed accordingly.

NOTE: It is not mandatory that escape sequences be set up. You may print to a printer by just completing the first half of this setup.

The C/BASE program grace is used to print reports. After grace processes the report (and ONPRINTER is not set or is set to "no") it will display an output destination screen.

The first field of the output destination screen is the output device. Pressing the F3 key will scroll forward through the options and the F2 key will scroll backwards. There are three output destination options:

• Printer - send output to a printer. Selecting this destination will activate the printer name field and the escape sequence field. Enter the number of copies you want to print, default=1. From the printer name field you may use F3 and F2 to scroll forward and back through the availableprinters (created in the printer setup utility section 4.1). After selecting a printer you may select an escape sequence number to print with, default=sequence 1. The field file name is ignored.

• Screen - send output to the screen. Selecting this destination will send the report to the screen where you can scroll up, down right, or left through it. All other fields in the output destination screen are ignored.

• File - send output to a file. Selecting this destination will send the report to a file. Enter the name of the destination file in the filename field. You may select to send more than one copy to the file in the number of copies field, default=1. All other fields are ignored.

The following environment variables are used to control printing.

• ONPRINTER=yes/no - This variable, if set to "yes", will cause grace no to give any printing options and send the output directly to the printer designated by $PRINTER (see section 4.3.2) or if $PRINTER is not set, to the default printer lpr. If this variable is set to "no" or not set at all, then grace will display an output destination screen.

• PRINTER="printer_name" - This variable designates an output destination. The printer_name may be a spooler, a printer device, or even a file name. This variable is overridden if a different printer is selected through the grace output destination screen.

• NCOPIES=integer - This variable designates the number of copies of a report required. It is an integer number i.e. 1, 2, 3, etc.. Selecting a different number of copies from the grace output destination screen will override this variable.

The following environment variables must be set for the C/BASE makefiles

INC=/home/cbase/include

LIB=/home/cbase/lib

LOCALCFLAGS=-I/home/cbase/include

LOCALLFLAGS=-L/home/cbase/lib

TERMLIB=-ltermcap

NOTE: The directory "/home/cbase" is used as an example of the C/BASE home directory and may be different on your system. Please make changes to these directions accordingly.

NOTE: These variables were placed in the script file "cbase_env" in the C/BASE home directory when the demo was installed.

The binaries and library was compiled using the GNU project C compiler Ver 2.4.

An example of a C/BASE user edit is in the directory /home/cbase/demo/src. The file is named sform.c and is part of the magazine subscription applications. With the above environment variables set, the code can be compiled by the command:

make sform

The resulting binary is placed in /home/cbase/demo/bin and is run from the "Magizine Demo Menu" when option "2. Enter Subscriptions" is selected.

The demo user_edit /home/cbase/demo/src/sform.c and all other C/BASE programs can be compiled manually with the following lines:

cc -c -I/home/cbase/include sform.c -o sform.o

cc -L/home/cbase/lib sform.o -lcbase -ltermcap \

-lm -o /home/cbase/bin/sform

Variable Name - Function

CBASE - The location for the C/BASE catalog files, i.e. CBASE=/home/cbase/lib/cbase.

COUNTRY - The variable which contains the name of a country, used to change Conetic language resource files, i.e. COUNTRY=39. This will set the language resources to Italian.

DBASE - The name of the database being presently utilized, i.e. DBASE=demo.

DBHOME - The home directory of database.

NCOPIES - The number of copies of a report to be printed usually set by GRACE.EXE , i.e. NCOPIES=1.

ONPRINTER - A boolean flag to determine whether reports go to the printer or not, usually set by GRACE.EXE, i.e. ONPRINTER=yes.

PATH - The path to the directories which contain the Conetics executable programs.

PRINTER - The name of a printer to send a report file.

RPATH - The path to the directory which contains the Conetic resource files, overrides the CBASE variable, i.e. RPATH=/home/cbase/lib/cbase/resource.

TERM - The name of a terminal type used by Conetics programs running under FreeBSD, i.e. TERM=cons25, TERM=xterm, etc..

TMPDIR - The location of an existing directory which will hold temporary files. Each user must have a unique TMPDIR work area. This can be achieved by setting TMPDIR=$HOME.

C/BASE 4GL Modules

Approximate Space Requirements

MODULE DESCRIPTION - C/Base 4GL Development DEMO System

DISK SPACE (MB) - 9 MB

PLATFORM - FreeBSD 2.05

DEVICE - 3.5" Floppy Drive

DEVICE NAME - "/dev/fd0", "/dev/fd0H1440", "/dev/fd1"

NOTE: The first number in the device name usually indicates the order of that device in your system configuration. For example, the 3.5" floppy diskette device name /dev/fd0 assumes that the 3.5" floppy drive is setup as device 0. If your system has that device setup in a different order, say device 1, you would access it with the name /dev/fd1.

intro - introduction to commands

addlf - add a logical RMSfile to the database catalog

cdef - build a definition for a data file

cdict - build a data dictionary for an RMSfile

cform - build a formfile

clearlf - clear contents in an existing RMSfile

convertlf - convert an existing RMSfile

convform - reformat old style formfile

copies - produce multiple copies

createlf - create a logical RMSfile

creport - build a Visual Reportfile

crw - compile report writer program

csort - sort pull style text lines

cterm - build a terminal definition

dbadd - add a database definition

dbadmin - administer database catalog

dbcreate - create a new database

dbfile - print pathname of logical RMSfile

dbhome - print database home directory

dblist - list database catalog

dbremove - remove a database definition

dbrm - completely remove a database

dbupd - update the database catalog

dcopy - copy RMSfile

deletelf - remove an existing RMSfile

dprint - print the contents of an RMSfile

drestore - restore a database

dspace - compute space required for RMSfile

escape - generate terminal escape sequence

expandl - expand an RMSfile

filedef - create or maintain RMS definition files

form - display input form on terminal, accept input

formadmin - administer formfile catalog

formcopy - copy logical formfile

formdef - create and maintain formfiles used by form

formedit - create or maintain logical formfiles

formrm - remove a logical formfile

formupd - update the logical formfile catalog

grace - run a report writer program

lfadmin - administer RMSfile catalog

lfcopy - copy logical RMS data and definition file

lfedit - create or maintain logical RMSfile definitions

lfrm - remove a logical RMS data and definition file

lfupd - update the logical RMSfile catalog

makelf - make an RMSfile

makelog - make empty log file

menu - display menu on terminal

menudef - create or maintain menufiles used by menu

npull - a fast data record extraction utility (uses indexes)

pdef - print contents of RMS definition

pdict - print data dictionary for RMSfile

pform - print contents of formfile used by form

pindex - print contents of RMS index file

plog - print log file contents

preport - print contents of a visual reportfile

prtset - set up a printer to use with grace

pterm - print terminal characteristics

pull - pull records from an RMSfile

put - put text data into RMSfile

rbldidx - rebuild RMS index file

removelf - remove a logical RMSfile catalog entry

rmsck - check RMSfiles for consistency

rptadmin - administer reportfile catalog

rptcopy - copy logical reportfile

rptedit - create or maintain logical reportfiles

rptrm - remove a logical report

rptupd - update the logical reportfile catalog

shash - computer statistics about a hashed RMSfile

sindex - print summary of RMS index file usage

start - start an application system

table - load data into a row and column matrix

termset - set terminal characteristics

toolkit - create or maintain an application system

touch - creates a zero byte data file (used for transaction logging)

wtr - interpret a compiled reportfile

wtrdef - create and maintain visual reportfiles