Copyright: All products on this CD-ROM are Copyright 1992..1999 © multisoft Datentechnik GmbH, 82031 Gruenwald/Munich, Germany. All rights reserved worldwide. No part of this media may be copied or distributed, transmitted, transcripted, or published in any form or by any means without the express written permission of multisoft Datentechnik GmbH.
Made in Germany. Printed in Germany.
License: The License Agreement & Warranty is available in the /cdrom/doc_engl/license.doc or /cdrom/doc_germ/lizenz.doc ASCII files and in the FlagShip printed or on-line manual in chapter GEN.2. By installing the package you will read this document and acknowledge that you agree to be bound by its terms and subjects to its conditions.
Trademarks: FlagShip and FS2 Toolbox are trademarks of multisoft Datentechnik GmbH. Other products named herein may be trademarks of their respective manufacturers or trademark holders.
Contact address
Introduction
Contents of this CD-ROM
Products and Licenses
Installation from this CD-ROM
Deinstallation
Support
Using FlagShip
Additional Infos and Ports
Postal address:
multisoft Datentechnik
GmbH
Postfach 1312
D-82027 Gruenwald/Muenchen
Germany
Delivery address:
multisoft Datentechnik
GmbH
Auf der Eierwiese 1
D-82031 Gruenwald/Muenchen
Germany
Telephone:
(++49 - 89) 649 0040
Fax:
(++49 - 89) 641 2974
E-mail:
sales:
sales@fship.com or sales@multisoft.de
support:
support@fship.com or support@multisoft.de
CIS:
74431,552
Internet:
Web:
http://www.fship.com
Ftp: ftp://fship.com/pub/multisoft
Call for address of your local distributor.
FlagShip Pro is intended as the regular license kit for software developers who will resell their executables, and for large in-house systems, accessed simultaneously by any number of users. Therefore,
- The application supports an unlimited number of simultaneous processes
or users,
- The developer/licensee may sell the application compiled by FlagShip
Pro as often as he/she likes, since
- No run-times fees or royalties exist.
- Discounted additional licenses for other platforms are available.
Of course, neither the FlagShip compiler, nor cc is required on the customer's site, but the executable only. You will need to obtain a license (Activation Key) from your dealer, distributor or from multisoft Datentechnik GmbH to be able to install and run this full version.
The Personal FlagShip is intended as a low cost Starter Kit for personal, company internal/in-house and software developer use, as well as the presentation of applications. Personal FlagShip has all the features of FlagShip Pro, except:
- Personal FlagShip supports the execution of the same application or
allows access to the same shared database by two different users (or processes)
simultaneously.
- Since used "personally" or in-house, executables need to run on the
system where the compiler resides, but are usable also for presentation
purposes.
There are no run-time licenses or other limitations. You may upgrade to FlagShip Pro at any time. You will need to obtain an Activation Key to be able to install and run the Personal FlagShip.
With the "Free Personal FlagShip", we support the effort of Linux community for a free software for personal use. It is similar and compatible to the licensed "Personal FlagShip", but this free version may be used strictly for personal, non-commercial purposes or education. You cannot use it for company purposes where the commercial Personal/Pro license is required. You may not sell the produced executable(s) but may pass it to anyone for free (see para 5.c of the FlagShip License Agreement for details). There are no run-time licenses or other limitations. You may upgrade to the commercial "Personal FlagShip" or "FlagShip Pro" at any time.
The free FlagShip Demo/Test Drive is fully functional, and lets you evaluate FlagShip with your applications without any risk. Compared to the full FlagShip license, it is only limited as follows:
- The compiler and with it produced executables run for 30 days, but
may be freely reinstalled again.
- The produced executable has a 1 hour run-time limit and supports
four users simultaneously.
- Any number of records are supported, but only the first hundred records
are writable.
The executable produced by this Demo cannot be distributed. The Test Drive is also available for a free download on Internet or CompuServe. You may directly install and run the Test Drive from the CD-ROM without any additional activation.
The FS2 Toolbox is an optional extension of the FlagShip package. The FS2 library includes hundreds of additional functions, call-compatible to the NT2/CA3 Toolbox of CA. It includes i.e. windowing, various data manipulation, communication etc. You will need to obtain an Activation Key of the same class (Pro, Personal) as your FlagShip license to be able to install the FS2 Toolbox.
Here the detailed description:
1. Before installing the FlagShip full release (FlagShip Pro, Personal FlagShip or the FS2 Toolbox), call your dealer or multisoft GmbH for your Activation Key, you will not be able to install it otherwise. The activation key for the "Free Personal FlagShip is available for free on http://www.fship.com/register.html The installation of the Trial/Demo FlagShip version does NOT require such an Activation Key.2. Log into your computer system as super-user or root:
$ su (Unix shell prompt)
Password: john_miller (not displayed)
# (Unix prompt)
Caution: Before installing the DEMO version of FlagShip,
make sure that the date and time are correctly set on your
system. Check this or set it by using:
# date -or-
# date mmddHHMMyy - e.g. date 0321154898 for the
21-Mar-98 at 3:48pm
3. Insert the CD-ROM into the drive and mount the CD-ROM to any mount point (directory) of your choice (here referred as /cdrom), if not already mounted
# [/etc/]mount -r <type <device> <mountPoint>
Invoke the CD-ROM installation script in the /cdrom directory
# ./FSinstCD
-or-
# ./FSinstCD -e
(for English messages) -or-
# ./FSinstCD -d
(for German messages)
The full syntax with optional arguments is:
# ./FSinstCD [-e|-d] [-help|-h] [-nocheck] [-t nn] [system]
whereby -e : English messages (the default)
-d : German messages
-nocheck : suppress check for important Unix tools
-t <nn> : terminal lines (default = 24 or environment LINES)
<system> : path of the system to be installed (e.g. sco325
)
The installation script will communicate with you and ask the system and product to install.
Normally, if more than the maximum allowed number of users/processes try to execute an application, the message "...sorry, user limits exceeded, try later..." occurs and the next execution becomes possible when one of the current users finishes his session. Only a certain maximum number of users may access shared databases at any one time, otherwise a run-time warning occurs and the NETERROR() function returns .T. An application can check the user limit before database access by using the FlagShip functions USERCHECK(), USERSMAX() and USERSACTIVE().
Of course, applications created by the usual FlagShip (FlagShip Pro)
do not have any limitations, full access is available at any time.
7. The FlagShip installation is now finished.
Remove the distribution media from the disk drive and keep it safe. Log
into your computer as an ordinary user:
# exit
(leave the su state now)
$
(std. UNIX shell prompt)
$ newfscons fsman -or-see details in the Unix manual pages
$ fsman
$ man flagshipOf the most important sections are the REL (Release Notes) and FSC (compiler). If you are not very familiar with Xbase programming yet, read carefully the section LNG (Language) and study the complete programming examples there. For an advanced programmer, the chapter QRF (quick reference) gives you a quick overview and the reference part (CMD and FUN) describes in detail all commands or functions, including the differences (if any) to other Xbase dialects.
$ man fsman
Note for Linux users: For your convenience, a printed manual (over 1500
pages including slip case) is available for purchase from your dealer.
The printed manual is included in the distribution (except of the Demo)
for all other Unix systems.
$ su
# FSuninstall -e (using English messages, the default)
# FSuninstall -d (using German messages)
$ cd ~/ (or simple cd )There are also many additional hints in /usr/FSsrc/docu directory, e.g. the howto* files.
$ cp /usr/FSsrc/fsadr* . (a small example)
$ FlagShip fsadr*.prg -omytest (see section FSC)
$ newfscons ./mytest (or newfswin, newfsterm instd.)
Before starting your application, you should check the actual environment settings (stty, TERM, ttymap etc.) according to chapter Runtime Requirements in sections FSC and REL, and the configuration file /etc/ FSconfig. If the colors or special keys work other than expected, check section SYS or use the semi-automatic checking program fscheck.prg stored in the /usr/FSsrc directory. Copy it into your working directory, compile and run it. It will check and display the input and output mappings, the default settings and so on:
$ cd /usr/home/john (or simple cd )
$ cp /usr/FSsrc/fscheck.prg .
$ FlagShip fscheck.prg (see section FSC)
$ TERM=FSansi ; export TERM (see release notes, section REL)
$ export FSTERM=fslinux (for Linux, see release notes)
$ ./a.out -or to do it automatically, use:
$ newfscons ./a.out (sets the terminal for you)
http://www.fship.com
ftp://fship.com/pub/multisoft
e-mail: info@fship.com
fax: (++49-89) 6412974
phone : (++49-89) 649-0040
We suggest to frequently check the faqsupp.txt file on Internet
or CompuServe (via the Support button on the home page, or by ftp
in the /pub/multisoft/flagship/support directory) for actual hints from
the support department.
Enjoy !