


















                                   FastFlip

                         The Fast Application Swapper
































































         FastFlip, Copyright 1992 Aquila Data Systems and Chris Curran.
                              All rights reserved.



















                           Aquila Data Systems, Inc.
                               304 Bayfield Drive
                               Brandon, FL  33511

               FAX   : (813)653/2408  Group II, III
               BBS #1: (813)653-2937  1200-38400 v.32bis/v.42bis
               BBS #2: (813)685-4218  1200-38400 v.32bis/v.42bis






    Contents
                Topic                           Section   Page
               ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
                General
                  Tools Used                       1       1
                  Program Description              1       2
                  System Requirements              1       2
                  Memory Requirements              1       2
                  Installing FastFlip              1       4
                  Starting FastFlip                1       4
                  Command line options             1       5

                  Program Status Screen            1       6
                  Editing Pages Online             1       7
                  Custom DOS Prompt                1       8
                  Cut & Paste                      1       9


                Configuration
                  FFSETUP.EXE                      2       1
                  Startup Parameters               2       2
                  Application Pages                2       4


                Command Line Operation
                  Help                             3       1


                Trouble Shooting
                  Help                             4       1


                Programmer Interface
                  Definition                       5       1
                  Functions                        5       1


                Legal Information
                  License                          6       1
                  Shareware Policies               6       1
                  BBS Operators                    6       1
                  Disclaimer                       6       2
                  Trademarks                       6       2


                Ordering Information
                  How                              7       1
                  Form                             7       3







  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                          Table of Contents


 Development    C compiler     : BorlandC++ v2.0   (Borland)
  Tools Used    Assembler      : TASM v3.0         (Borland)
                Linker         : TLink v5.0        (Borland)
                Debugger       : TDebug v3.0       (Borland)
                Editor         : Qedit 2.15        (SemWare)
                Version Control: PVCS for DOS      (Sage Software)
                C Libs         : CodeRunneR        (Omega Point, Inc.)
                               : PDK1-3, ADK1      (Omega Point, Inc.)


                Omega Point is the developer of a group of TSR libraries for
                'C' programmers. Their libraries were used extensively in
                the development of FastFlip, most notably ADK1. It should
                also be noted that a sample program provided with ADK1 was
                used as the "starting point" for FastFlip. While FastFlip no
                longer resembles the original sample, FastFlip does have its
                roots in someone else's work. In other words, credit is due
                to Omega Point for providing superior programming libraries
                with superior sample programs to its customers.

                It should also be noted that Omega Point provides some of
                the best technical support there is. There are no three day
                waits for a call back from tech support! Without the quality
                tech support provided by Omega Point, FastFlip would have
                been next to impossible to write.

                While the Omega Point documentation is not what one would
                call "perfect", it is much better than other products
                competing in the same market, and sufficient for most
                applications. Omega Point has also been receptive to
                comments and suggestions concerning their doc, and has
                continually improved the quality of its documentation with
                each release.

                And no, I don't work for Omega Point, and I don't get any
                kick-back from them (no free updates). The above is this
                programmers opinion; you may or may not agree.

                How to contact Omega Point:

                        Omega Point, Inc.
                        25 Birch Road
                        Framingham, MA  01701

                        Voice: (508)877-1819
                          BBS: (508)875-8009









  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 1, Page   1


     Program    FastFlip v2.18
        Name    Application Swapper


 What is it?    FastFlip(tm) is a versatile program management tool that
                allows you to load up to 10 programs at once and instantly
                switch between them. You can switch between your word
                processor, spreadsheets, databases, and utilities at will
                without having to wait. This eliminates the need to exit one
                program to open and use another, which lets you concentrate
                on the reasons why you are using your software in the first
                place.

                NOTE: This is NOT a multi-tasker; the PC apps are simply
                      swapped in and out as desired. The *only* task that is
                      actually running is the task that is being viewed.


        Why?    Why on EARTH would someone write "yet another task
                switcher"? Good question.

                FastFlip is not like other task switchers. For one, FastFlip
                is "lean & mean"; there aren't ten zillion features to
                learn, configure and remember. Because of this, you'll have
                FastFlip "up & running" in only minutes! And it's EASY!

                But just because FastFlip is easy use doesn't mean it's a
                "bare-bones" program. You can CUT & PASTE data from one
                application to another, specify memory size and type for
                each application page, and control it from DOS BAT files.
                And if you're a programmer, you can even control FastFlip
                from within your own programs!

                Everything about FastFlip is FAST. FAST setup. FAST load.
                FAST task switching.


      System    FastFlip will run on the IBM PS/2, PC/AT, PC/XT, PC, and
Requirements    IBM compatible computers including the Compaq, NCR, Tandy,
                and WYSE PC's.  MINIMUM requirements are:

                  - 512k of memory.
                  - PC/MS-DOS 3.0 or higher
                  - Color or monochrome monitor with 80-column display.


      Memory    Now for the next question in everyone's mind - how much
Requirements    memory is this going to cost me? 16k! That's right - you can
                have up to 10 PC applications running at the same time for
                16k of DOS memory. And if you load FastFlip into upper
                memory (with DOS 5.0), it will leave a 0k DOS footprint!




  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 1, Page   2


                The memory/disc space requirements of FastFlip are as
                follows (assuming you use the default memory settings):

                    1.  ~775k of XMS memory per application, or
                    2.  ~775k of LIM memory per application, or
                    3.  ~775k of disc space per application, or
                    4.  Any combination of the above.

                FastFlip is able to "scatter" its data requirements among
                the different stowage mediums available at load time. In
                other words, it can use some XMS, some LIM and send the rest
                to disc.

                XMS memory is preferred, then LIM, then lastly the disc
                drive. Note that FastFlip can directly access XMS (extended
                memory) if it is available. This type of memory is the
                cheapest to add to a PC (no extra boards are needed to
                install or control this type of memory), and also the
                fastest performing memory you can add to your PC. Street
                prices for memory are now about $50 to $75 per meg
                (depending on type and speed).

                Also note that if you use extended memory, you'll need to
                include HIMEM.SYS in your CONFIG.SYS file (make it the first
                entry).

                If a disc drive is used (and most will need to), then disc
                caching software is recommended. I personally use HyperDisk
                version 4.21 and find it to be one of the best. I have my
                machines on UPS's, so I also enable the disc write caching
                of HyperDisk, which tremendously decreases application swap
                time.























  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 1, Page   3


  Installing    You may install FastFlip two different ways: 1) copy all
    FastFlip    FastFlip files to the directory of your choice (a separate
                directory is recommended), or, 2) run the FastFlip install
                program, "FFINST".


    Starting    To start FastFlip, type FASTFLIP at your DOS prompt,
    FastFlip    followed by any optional command line parameters (see
                next page). Do NOT start FastFlip if you have "shelled to
                DOS" from another application - this will leave "holes" in
                your memory.

                After FastFlip has been loaded, you may "hotkey" into any
                available application. With the exception of Windows 3.0,
                FastFlip can swap almost any application - even hi-res
                graphics applications.

                NOTE: FastFlip defaults to three application pages; to
                      change this (and other) settings you need to run the
                      setup program (see Section 2).



































  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 1, Page   4


Command Line    Command line options allow you to override settings that you
     Options    have defined in the setup program. The available command
                line options are as follows:

                  /?  Display HELP screen. The help screen may be displayed
                      before, or after FastFlip is loaded.

                  /C  Sets the hotkey used for CUT.

                      Example:    FastFlip /clcs-1

                                  Sets the CUT hotkey to Left-Ctrl-Shft-1.

                  /E  Forces FastFlip to NOT use any available EXPANDED
                      memory (LIM 3.x-4.x) for swapping.

                  /I  Displays detailed information about the currently
                      defined pages.

                  /M  Sets the hotkey used for MENU.

                  /N  Specifies the number of pages FastFlip will setup. The
                      default is 3, and the maximum is 10.

                      Example:    FastFlip /n6

                                  Loads FastFlip with 6 pages.

                  /P  Sets the hotkey used for PASTE.

                  /S  FastFlip will use the current drive for swapping (if
                      disc swapping is needed). If you do not have
                      sufficient space on the current drive, or, have a RAM
                      drive with sufficient space, use this option to
                      specify a different swap drive.

                      Example:    FastFlip /sg

                                  Loads FastFlip, and swaps to drive G: if
                                  needed.

                  /U  Unload FastFlip from memory. This option requires that
                      FastFlip is the LAST TSR that has been loaded. If
                      other TSR's are loaded AFTER FastFlip, they will need
                      to be removed before FastFlip can perform an unload.

                  /X  Forces FastFlip to NOT use any available XMS memory for
                      swapping.







  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 1, Page   5


     Program    After FastFlip has been loaded, LCTRL-? will pop-up the
      Status    application status menu.

                ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
                ³Pg Stat  Mem    Program                    HotKey  ³
                ³ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ³
                ³ 1  ÍÍ>  554k   Dos Prompt                 LC-1    ³
                ³ 2  Act  256k   Dos Prompt                 LC-2    ³
                ³ 3  Idl  256k   Dos Prompt                 LC-3    ³
                ³ 4  Idl  256k   Dos Prompt                 LC-4    ³
                ³ 5  Act  256k   Dos Prompt                 LC-5    ³
                ³ 6  Idl  256k   Dos Prompt                 LC-6    ³
                ³ 7  Idl  256k   Dos Prompt                 LC-7    ³
                ³ 8  Idl  256k   Dos Prompt                 LC-8    ³
                ³ 9  Idl  256k   Dos Prompt                 LC-9    ³
                ³ 0  Idl  256k   Dos Prompt                 LC-0    ³
                ³ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ³
                ³           Enter Page #, or 'E' to edit            ³
                ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

                           Sample Application Status Menu


                The Application Status Menu is rather self-explanatory. The
                current page is indicated with a "ÍÍ>". Pages that are idle
                show "Idl" and pages that are active (but not currently
                selected) show "Act". The status display also shows the
                amount of memory, program name and hotkey for each page.



























  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 1, Page   6


     Editing    A limited number of fields may be modified at run time for
     Program    each application page. To edit the settings of a page, enter
 Information    'E' and select the appropriate page number from the list.
                The following screen will then be displayed:

                ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
                ³    Page: x                                          ³
                ³    Name: _________________________                  ³
                ³ Program: ________________________________________   ³
                ³ Chg Dir: ________________________________________   ³
                ³                                                     ³
                ³ Pause for command line options? (Y/N): _            ³
                ³                                                     ³
                ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

                               Sample Page Edit Display


                     Page   The page number being edited. This is a display
                            only field.

                     Name   The description of the program. This may be any
                            text up to 25 characters.

                  Program   The DOS name of the program. If the program is a
                            COM or EXE file, an extension is not needed. If
                            the program is a BATCH file, then the ".BAT"
                            extension *MUST* be included.

                            If the program is in your DOS PATH, then a path
                            does not need to precede the DOS file name. If
                            the program is NOT in your DOS PATH, then you
                            must specify the path with the file name, or use
                            the "Chg Dir" field below.

                            If you only want a DOS prompt, leave this field
                            blank. A BATCH file will also return to the DOS
                            prompt (unless an EXIT command is included).

                  Chg Dir   The path that FastFlip should change to when the
                            program is started.

                    Pause   If this field is "Y", FastFlip will pause for
                            entry of any parameters to be passed to the
                            program.










  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 1, Page   7


  Custom DOS    If a custom prompt is desired for each page at the DOS
      Prompt    prompt, specify a BATCH file in the Program field to change
                the prompt.

                Example SETNEWP.BAT file for DOS:

                    @echo off
                    prompt $e[37;40m%1³$p$g$e[36;40m


                Example SETNEWP.BAT file for 4DOS users:

                    @echo off
                    setdos /V0
                    prompt $e[37;40m%1³$p$g$e[36;40m


                This BATCH file will set a new prompt for this page (the
                4DOS version also sets a 4DOS state variable). The PROMPT
                statement above requires ANSI.SYS (or equivalent) to be
                loaded since it also changes the color of the prompt (my
                personal preference). Note the placement of the DOS
                parameter "%1" - this parm is specified in the FastFlip
                Program Edit screen for this page (see example below).

                Following is a sample BATCH file setup:

                    ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
                    ³    Page: 3                                          ³
                    ³    Name: Dos Prompt                                 ³
                    ³ Program: setnewp.bat 3                              ³
                    ³ Chg Dir:                                            ³
                    ³                                                     ³
                    ³ Pause for command line options? (Y/N): N            ³
                    ³                                                     ³
                    ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ



















  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 1, Page   8


     Cut and    FastFlip also allows you to "cut and paste" data between
       Paste    applications.

                Cutting   The contents of one application screen may be
                   Data   copied to another application, or to itself. Data
                          that is to be copied must first be marked, then
                          "cut". Note that the term "cut" does not denote
                          that any damage or modification with come to the
                          original data.

                          Data is marked for cutting by pressing
                          "Left-Ctrl-Left-Shft-C". The current application
                          screen will then be set to white on black, and the
                          marked area will be displayed as white on blue.
                          The current cursor location is used as the upper
                          left corner of the marked block. Use the arrow
                          keys to expand or shrink the marked area.

                          You may not move the cursor above or to the left
                          of the current upper left corner of the marked
                          block. If the upper left corner of the block needs
                          to be moved, press "A", reposition the cursor and
                          press "A" to anchor the upper left corner of the
                          marked block.

                          After the block has been marked, press "Enter".
                          The data will then be copied to a disc file for
                          later use by the Paste command. The disc file is
                          NOT erased after a Paste command, or when FastFlip
                          is unloaded. This allows you to paste the same
                          data any number of times, to any number of
                          applications.

                Pasting   The contents of the disc cut file is pasted to the
                          current application by pressing
                          "Left-Ctrl-Left-Shft-P". The contents of the disc
                          cut file is then fed into the current applications
                          keyboard buffer, with an "Enter" simulated at the
                          end of each line. If the disc cut file is empty or
                          an error occurs during reading, a beep will be
                          emitted and no action taken.

                          Note: You must release all keys of the Paste
                                command before pasting will begin.











  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 1, Page   9





















                              Configuring FastFlip




































 Configuring    The program FFSETUP.EXE is used to configure FastFlip. If
    FastFlip    you run FFSETUP from a page in FastFlip (while it is
                loaded), the changes will not take effect until FastFlip has
                been unloaded and reloaded.

                    NOTE: Command line toggles will override any configured
                          settings.


                After FFSETUP has been loaded, you will be presented with
                the following menu:

                                ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
                                ³                     ³
                                ³ Startup Parameters  ³
                                ³ Application Page 1  ³
                                ³ Application Page 2  ³
                                ³ Application Page 3  ³
                                ³ Application Page 4  ³
                                ³ Application Page 5  ³
                                ³ Application Page 6  ³
                                ³ Application Page 7  ³
                                ³ Application Page 8  ³
                                ³ Application Page 9  ³
                                ³ Application Page 10 ³
                                ³                     ³
                                ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ


                Select "Startup Parameters" to configure settings that
                affect all application pages (number of apps, swap drive,
                etc). Select "Application Page 1" through "Application Page
                10" to configure the appropriate application page.






















  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 2, Page   1


     Startup    ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
  Parameters    ³                                                      ³
                ³             Menu Hotkey: LC-/                        ³
                ³              Cut Hotkey: LCS-C                       ³
                ³            Paste Hotkey: LCS-P                       ³
                ³         Prev App Hotkey: LCS-,                       ³
                ³         Next App Hotkey: LCS-.                       ³
                ³                                                      ³
                ³  Number of Applications:  3                          ³
                ³  Swap Drive (if needed): C   Alternate Drive: C      ³
                ³   Use EMS for swapping?: Y                           ³
                ³   Use XMS for swapping?: Y                           ³
                ³                                                      ³
                ³                                                      ³
                ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

                             Startup Parameters Edit Screen


                     Menu   Sets the hotkey used to display the application
                            menu. See "Hot Key" in "Application Page Edit
                            Screen" for valid hot key specifiers.

                      Cut   Sets the hotkey used to activate the cut
                            operation. See "Hot Key" in "Application Page
                            Edit Screen" for valid hot key specifiers.

                    Paste   Sets the hotkey used to activate the paste
                            operation. See "Hot Key" in "Application Page
                            Edit Screen" for valid hot key specifiers.

                     Prev   Sets the hotkey used to swap to the previous
                            application page. See "Hot Key" in "Application
                            Page Edit Screen" for valid hot key specifiers.

                     Next   Sets the hotkey used to swap to the next
                            application page. See "Hot Key" in "Application
                            Page Edit Screen" for valid hot key specifiers.
                            
                   Number   Specifies the number of pages FastFlip will
                            setup. The default is 3, and the maximum is 10.

               Swap Drive   The primary drive that FastFlip should use for
                            swapping (if disc swapping is needed). If there
                            is not enough free space on this drive, the
                            Alternate swap drive will be attempted.

                Alternate   If FastFlip needs to swap to the disc and the
                            primary swap drive does not have enough free
                            space to hold the swap file, the alternate drive
                            will be used instead.




  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 2, Page   2


                  Use EMS   If this field is "Y", FastFlip will allow
                            application pages to use EMS memory for
                            swapping.

                            If this field is "N", FastFlip will not allow
                            application pages to use EMS memory for
                            swapping.

                  Use XMS   If this field is "Y", FastFlip will allow
                            application pages to use XMS memory for
                            swapping.

                            If this field is "N", FastFlip will not allow
                            application pages to use XMS memory for
                            swapping.








































  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 2, Page   3


 Application    ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
   Page 1-10    ³                                                      ³
                ³     Page: 1                                          ³
                ³     Name: Dos Prompt                                 ³
                ³  Program:                                            ³
                ³  Chg Dir:                                            ³
                ³   Memory: 512                                        ³
                ³  Hot Key: LC-1                                       ³
                ³  Use EMS: Y                                          ³
                ³  Use XMS: Y                                          ³
                ³                                                      ³
                ³  Pause for command line options? (Y/N): N            ³
                ³                                                      ³
                ³                                                      ³
                ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

                             Application Page Edit Screen


                     Page   The page number being edited. This is a display
                            only field.

                     Name   The description of the program. This may be any
                            text up to 25 characters.

                  Program   The DOS name of the program. If the program is a
                            COM or EXE file, an extension is not needed. If
                            the program is a BATCH file, then the ".BAT"
                            extension *MUST* be included.

                            If the program is in your DOS PATH, then a path
                            does not need to precede the DOS file name. If
                            the program is NOT in your DOS PATH, then you
                            must specify the path with the file name, or use
                            the "Chg Dir" field below.

                            If you only want a DOS prompt, leave this field
                            blank. A BATCH file will also return to the DOS
                            prompt (unless an EXIT command is included).

                  Chg Dir   The path that FastFlip should change to when the
                            program is started.

                   Memory   The amount of memory needed (in k) for this
                            program.

                            NOTE: Memory size changes do not take effect
                                  until FastFlip has been unloaded and
                                  reloaded.






  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 2, Page   4


                  Hot Key   The HotKey that will be used to change to this
                            page. A HotKey is selected by entering HotKey
                            specifiers, followed by a dash ('-') and then
                            the identifier key. Available HotKey specifiers
                            are:

                                L   Left
                                R   Right
                                A   Alt
                                C   Ctrl
                                S   Shift

                            HotKey specifiers may be combined in any manner,
                            except 'L' and 'R' - these two specifiers are
                            mutually exclusive.

                            A HotKey identifier is any single key. Function
                            keys may be used as identifiers by using the key
                            name (i.e. "F5").

                            Examples:
                              LCS-1         Left-Ctrl-Shift-1
                              RCS-1         Right-Ctrl-Shift-1
                              LCA-1         Left-Ctrl-Alt-1
                              LCAS-1        Left-Ctrl-Alt-Shift-1
                              LC-F9         Left-Ctrl-F9
                              RC-F11        Right-Ctrl-F11
                              LCAS-F9       Left-Ctrl-Alt-Shift-F9
                              RCS-Q         Right-Ctrl-Shift-Q


                            NOTE: HotKey changes do not take effect until
                                  FastFlip has been unloaded and reloaded.

                  Use EMS   If this field is "Y", FastFlip will attempt to
                            use EMS memory for swapping this page. If EMS
                            usage is turned off (via Startup Parameters),
                            this field has no effect.

                            If this field is "N", FastFlip will not use EMS
                            memory for swapping this page.

                  Use XMS   If this field is "Y", FastFlip will attempt to
                            use XMS memory for swapping this page. If XMS
                            usage is turned off (via Startup Parameters),
                            this field has no effect.

                            If this field is "N", FastFlip will not use XMS
                            memory for swapping this page.

                    Pause   If this field is "Y", FastFlip will pause for
                            entry of any parameters to be passed to the
                            program.


  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 2, Page   5





















                             Command Line Operation





































     Command    The program FFCTL is provided to allow you to change
                FastFlip pages from a DOS batch file.

                NOTE: This program provides other features, but are
                      primarily designed as examples for programmer's
                      using the FastFlip Programmer Interface.
                      Therefor, these features are not discussed in
                      this section.

                To change a FastFlip page from DOS, type:

                        FFCTL -pX

                where 'X' is the 1 based page number to switch to. For
                example, "FFCTL -p2" will cause FastFlip to change to
                page 2.






































  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 3, Page   1





















                           FastFlip Trouble Shooting




































        Huh?    Having trouble with FastFlip? Check the following list
                of questions and answers to see if that helps. If not,
                try re-reading the documentation - sometimes we have
                to read something a few times before the "light bulb"
                comes on. If this still doesn't help, please call our
                BBS for support. WE'll try to help you through your
                problem whether you're registered or not.

           Q    How do I shutdown a DOS page so that I may unload FastFlip.

           A    Change to the DOS page and enter "EXIT" followed by ENTER.



           Q    I can't get more than 3 pages to work.

           A    Run the setup program FFSETUP. Select "Startup Parameters"
                and change the "Number of Applications" field to the number
                of pages you wish to run.



           Q    I can't get more than 512k in a page.

           A    Run the setup program FFSETUP. Select the application page
                you wish to modify. In the "Memory" field enter the amount
                of memory for this page.

                NOTE: If FastFlip is loaded when you change memory sizes,
                      you must unload, then reload FastFlip for the changes
                      to take effect.



           Q    I can't get DOS BAT files to run.

           A    You *MUST* include the ".BAT" extension when specifying the
                "Program" name for this page (see Section 2).



           Q    I get a "Program not found" message when I select page X.

          A1    The program name may be spelled incorrectly.
          A2    The program may not be in your PATH (and no path specified
                with the program name).
          A3    The PATH specified with the program name may be invalid.
          A4    The PATH specified in "Chg Dir" may be invalid.







  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 4, Page   1





















                         FastFlip Programmer Interface




































  Programmer    Your programs may communicate with FastFlip via the
   Interface    Multiplex Interrupt (interrupt 0x2F). This interrupt is well
                defined and its usage is somewhat "standardized" amongst
                TSRs. For a detailed discussion of the Multiplex Interrupt
                see any one of the following: Microsoft Encyclopedia
                (M$Press), DOS Programmer's Reference (QUE) or MS-DOS
                Developer's Guide (Waite Group). I recommend all three.

                A set of 'C' routines that can be used with your programs
                are contained in the file "FFLNK.C". The source is also
                provided for the utility program FFCTL - you may use this as
                an example program.
                
                ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
                Function: int ffLoaded(void);

                 Purpose: Check to see if FastFlip is loaded.

                   Input: none

                  Return: 0 = Not loaded.
                          1 = Loaded.

                ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
                Function: int ffGetMaxPage(void);

                 Purpose: Get the max number of pages available.

                   Input: none

                  Return: The number of DEFINED pages (not ACTIVE pages).

                ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
                Function: int ffSetPage(int page)

                 Purpose: Set new active page.

                   Input: page: The 0 based page number to change to.

                  Return: 0 = Error
                          1 = No Error

                ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
                Function: void ffSetTimer(int clicks)

                 Purpose: Set FastFlip internal timer.

                   Input: clicks: The number of timer ticks to elapse before
                                  FastFlip checks internal tables for
                                  instructions.

                  Return: none



  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 5, Page   1


                ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
                Function: void ffSetMem(int offset, void far *buf, int len)

                 Purpose: Copy data to the FastFlip common application
                          memory area. NOTE: This area is 64 bytes in length
                          (TOTAL, not per app) and YOU must verify that it
                          is not overwritten.
                          This function can be used to pass data between
                          applications running under FastFlip.

                   Input: offset  The offset into the common memory to
                                  begin write to.
                          buf     Far pointer to data to write to the common
                                  memory.
                          len     The number of bytes to write to the common
                                  memory.

                  Return: none

                ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
                Function: void ffGetMem(int offset, void far *buf, int len)

                 Purpose: Copy data from the FastFlip common application
                          memory area. NOTE: This area is 64 bytes in length
                          (TOTAL, not per app).
                          This function can be used to pass data between
                          applications running under FastFlip.

                   Input: offset  The offset into the common memory to
                                  begin read from.
                          buf     Far pointer to receive buffer.
                          len     The number of bytes to read from common
                                  memory.

                  Return: none




















  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 5, Page   2


                ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
                Function: void ffSetLock(int state)

                 Purpose: This function allows you to "lock" or "unlock"
                          FastFlip. When FastFlip is in a locked state, the
                          user will NOT be able to perform ANY FastFlip
                          actions. Note that even when FastFlip is in a
                          locked state, your program can still perform all
                          normal functions.

                          NOTE: It is VERY important to ALWAYS unlock
                                FastFlip after it has been locked. If your
                                program exits with FastFlip locked and other
                                pages are active, the user will not be able
                                to switch to other pages. If other pages
                                cannot be shutdown, the user cannot unload
                                FastFlip - they must reboot to clear memory.
                                Since this is not a desired action, it would
                                be a good idea to call an unlock function
                                with "atexit()". This will ensure that
                                FastFlip is unlocked when your program exits
                                (if FastFlip is not locked, the unlock
                                command is ignored).

                   Input: state   0 = Unlock FastFlip
                                  1 = Lock FastFlip

                  Return: none



























  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 5, Page   3





















                                The Legal Stuff




































     License    This version of FastFlip is NOT public domain or free
                software, but is being distributed as "shareware".

                Non-registered users of this software are granted a limited
                license to make an evaluation copy for trial use on a
                private, non-commercial basis, for the express purpose of
                determining whether FastFlip is suitable for their needs. At
                the end of this trial period, you should either register
                your copy or discontinue using FastFlip.

                A FastFlip registration entitles you to use the program on
                any and all computers available to you, with the following
                restriction: If other people have access to this program or
                may use it, then you should purchase a site license.  See
                the following section for information about site licensing
                or quantity discounts.

                All users are granted a limited license to copy FastFlip
                only for the trial use of others and subject to the above
                limitations. This license does NOT include distribution or
                copying of this software package:

                    1. In connection with any other product or service.
                    2. For general use within a company or institution.
                    3. For any consideration or 'disk fee'.
                    4. For distribution in modified form; i.e., the file
                       containing this license information MUST be included,
                       along with the full FastFlip documentation.


   Shareware    This shareware version of FastFlip has a 3 second delay when
    Policies    started from DOS. Registered versions of FastFlip do not
                contain this screen. The registered and shareware versions
                are otherwise IDENTICAL.


         BBS    Operators of electronic bulletin board systems (Sysops) are
   Operators    encouraged to post FastFlip for downloading by their users,
                as long as the above conditions are met.
















  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 6, Page   1


  Disclaimer    The software and accompanying written materials (including
                instructions for use) are provided "AS IS" without warranty
                of any kind. Further, Aquila Data Systems does not warrant,
                guarantee, or make any representations regarding the use, or
                the results of the use, of the software or written materials
                in terms of correctness, accuracy, reliability, currentness,
                or otherwise. The entire risk as to the result and
                performance of the software is assumed by you. If the
                software or written materials are defective you, and not
                Aquila Data Systems or its dealers, distributors, agents or
                employees, assume the entire cost of all necessary
                servicing, repair, or correction.

                No warranties of any kind, either express or implied,
                including but not limited to the implied warranties of
                merchantability and fitness for a particular purpose, that
                are made by Aquila Data Systems on this Aquila Data Systems
                product. No oral or written information or advice given by
                Aquila Data Systems, its dealers, distributors, agents or
                employees shall create a warranty or in any way increase the
                scope of this warranty, and you may not rely on any such
                information or advice. This warranty gives you specific
                legal rights. You may have other legal rights, which vary
                from state to state.

                Neither Aquila Data Systems nor anyone else who has been
                involved with the creation, production, or delivery of this
                product shall be liable for any direct, indirect,
                consequential, or incidental damages (including but not
                limited to damages for loss of business profits, business
                interruption, loss of business information, and the like)
                arising out of the use or inability to use such product even
                if Aquila Data Systems has been advised of the possibility
                of such damages. Because some states do not allow the
                exclusion or limitation of liability for consequential or
                incidental damages, the above limitation may not apply to
                you.


  Trademarks    All trademarks and copyrights belong to their respective
                holders. Who else would they belong to anyway?














  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 6, Page   2





















                              Ordering Information




































    Ordering    A FastFlip registration licenses you to use the product on a
 Information    regular basis. Registration includes notification of updates
                and technical support (via our support BBS).

                Registering FastFlip costs $35. When received, we will send
                you an "unlock" code that will turn your current (and
                future) versions of FastFlip into a "registered" version. If
                you prefer, you may also receive this code via our support
                BBS.

                A diskette with the latest version of FastFlip and printed
                documentation is also available for an additional $15.
                Florida residents should include 6% sales tax. Please use
                the form at the end of this document.


    Upgrades    Updating to a newer version of FastFlip is currently free.
                We do not expect this policy to change in the future, but we
                reserve the right to do so. When you register, you will
                receive an unlock code that will brand the current and
                future versions of FastFlip with your name.


      Orders    Please send a check drawn on a US bank in US dollars.  We
     outside    can accept non-US currency; however, you must include an
      the US    additional $15 to cover conversion and collection costs.
                Please include an additional $10 to cover postage on orders
                delivered outside of the US (if applicable).

   Corporate    All corporate, business, government or other commercial
        Site    users of FastFlip must be registered.  We offer quantity
Licenses and    discounts as well as site licensing.
    Quantity
   Purchases    Corporate site licensing agreements allow duplication and
                distribution of specific numbers of copies within the licensed
                institution. Duplication of multiple copies is not allowed
                except through execution of a licensing agreement. Site
                license fees are based upon estimated number of users.

                Please call or write for more information.

                ALL PRICES AND DISCOUNTS ARE SUBJECT TO CHANGE WITHOUT
                NOTICE. Discounts are not cumulative; they apply to single
                orders of like products only. Unit prices are the same as
                for individual users.

     WARNING    YOU MAY NOT USE FastFlip WITHIN YOUR ORGANIZATION WITHOUT A
                PRIOR PURCHASE OR LICENSE ARRANGEMENT.







  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 7, Page   1


      How To    To register your copy of FastFlip, please fill out the
    Register    following form and send it along with a check or money
                order.

                Remit/Send To:  Aquila Data Systems, Inc.
                                304 Bayfield Drive
                                Brandon, FL  33511
















































  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
    FastFlip v2.18                                        Section 7, Page   2
  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
   FastFlip Order Form
  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

       Name (to register to): ________________________________________________

          Address to ship to: ________________________________________________

                              ________________________________________________

                              ________________________________________________

                   Telephone: ________________________________________________

                        Date: __________________


  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
   QUANTITY         DESCRIPTION                      UNIT PRICE          TOTAL
  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

   ________         FastFlip                         US $ 35.00       ________

                                       Florida Residents add 6%       ________

                                                       Shipping          $1.50

                                            Additional Shipping       ________

                                                          Total       ________

                               Check/Money Order enclosed for US $ ___________

  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

         Version Number of FastFlip: _________________________________________

                Place obtained from: _________________________________________

                   Type of Computer: _________________________________________

           Type of Operating System: _________________________________________

         Type of video card/monitor: _________________________________________


                Additional Comments: _________________________________________

      ________________________________________________________________________

      ________________________________________________________________________

      ________________________________________________________________________



