FlagShip

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.



Contents of this Installation Booklet
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.



 

Introduction

FlagShip is an independent Database Development system, perfectly suited also to migrate xBase based applications to UNIX. It is a superset of CA/Clipper 5.3 and therefore fully source and data compatible to it, including macros, code blocks, objects, user defined OOP classes etc.

Contents of this CD-ROM

FlagShip is ported to all standard Unix systems, from PC-Unix to workstations and mainframes. On this CD-ROM, you will find for the following operating systems (in alphabetical order; additional systems are available upon request):

Products and Licenses

The complete License Agreement in English is available in the ascii file /cdrom/doc_engl/license.doc (and LICENSE.DOS). Here in short:

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.

Installation from this CD-ROM

FlagShip may easily be installed. You will need superuser (or root) privileges to perform the installation. Requirements: With the CD-ROM distribution, the "FSinstCD" script does it all automatically and interactively for you. If you are in hurry, just cd to the CD-ROM directory and type ./FSinstCD - that's all.

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)

    Note: in an emergency, you may perform the installation (at least partially) also without the 'su' permissions. You will be prompted accordingly.

    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

Now, you are ready to use the FlagShip development system. Please invoke the FlagShip on-line manual first by e.g.
$ newfscons fsman              -or-
$ fsman
see details in the Unix manual pages
$ man flagship
$ man fsman
Of 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.

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.
 

Deinstallation

All of the files installed by 'FSinstCD' or 'FSinstall' may be removed selectively at any time by entering
$ su
# FSuninstall -e           (using English messages, the default)
# FSuninstall -d           (using German messages)
 

Support

The tech support is for free during the initial period for all registered users. To join it, fill in and return the registration card (the REGCARD file available in the installation directory or in /usr/FSsrc), applicable also for the Demo. You may contact your local distributor or multisoft by e-mail, phone or fax. Preferably use the Support Request form, available in the appendix of the on-line manual or on the CD-ROM in /cdrom/doc_engl/suppreq.doc .
 

Using FlagShip

The handling of the FlagShip package is very similar to the handling of any other compiler package like Clipper, cc etc. Please see details in the printed manual or in the FlagShip on-line manual (see "man fsman" for its invocation). The most important chapters are REL, FSC and LNG. An example:
$ cd ~/ (or simple cd )
$ cp /usr/FSsrc/fsadr* .             (a small example)
$ FlagShip fsadr*.prg -omytest (see section FSC)
$ newfscons ./mytest                     (or newfswin, newfsterm instd.)
There are also many additional hints in /usr/FSsrc/docu directory, e.g. the howto* files.

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)

Additional Infos and Ports

For other Unix systems not available on this CD-ROM, FlagShip demos/test drives are available on floppies or tape for a nominal fee. Ask your distributor or contact:

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 !