                         Manipulate A Database
    DBPTR_BIN is  a  utility  program  for  use  with  the  DATABASE
package. It is  designed to  work under the pointer environment, and
so it requires DATA_BIN,  PTR_GEN  (or  some  equivalent)  and  WMAN
installed beforehand,  HOT_REXT (or  some equivalent) allows the use
of the button sleep  facility. It  cannot  manipulate  Archive  type
database files.
    DBPTR_BIN is  an EXECutable  type job, it is intended to fulfill
the role of ALTER/INSERT  in ARCHIVE.  The Extra  Information String
must contain  the   field  names   in  the   format   specified   in
ORGANIZE_doc (supplied with DATA_BIN).
    Three display  modes available,  each showing  different numbers
of records, fields from records, and characters from a field:
         Mode 0: 19*4 records, 1 field/record, 18 chars/field
         Mode 1: 18 records, 4 fields/record, 18 chars/field
         Mode 2: 1 reecord, 19 fields/record, 60 chars/field

    The job allows  viewing, adding,  amending, deleting,  ordering,
excluding,  including,   and  finding  records,  and  also  opening,
creating,  importing,  and  exporting  databases.  Instructions  are
supplied as the  program is  used. Also  an online  help facility is
supplied (text contained in the DBPT_HELP_DBS database).
    The Qjump  CONFIG   program  can   be  used  to  change  various
parameters:
         Default drive/DATA_USE
         Default create string size
         Help filename
         Default initial display mode
         Window/subwindow colours
         Button colours

    For those with  Toolkit II the program can be made to operate on
an already opened database from BASIC.
    This program  recognises   the  contents   of  a  database  code
section, and calls the appropriate routine parts. See CODE_doc.
    Directory databases can be supplied to DBPTR, but not modified.

    1) USE FROM BASIC

    To get the job to ask for a filename to open:

    EXEC flp2_DBPTR_BIN
    EXEC_W flp2_DBPTR_BIN

    1a) USE FROM BASIC WITH TOOLKIT II
    To use an already open database if channel is known:

    EX flp2_DBPTR_BIN,#C     (where C is the channel number)
    EW flp2_DBPTR_BIN,#C
    (This can  be   done  due   to  Toolkit  II  supporting  special
executable programs  where, immediately  following the  job name, is
$4AFB and a special routine.)

    To use an already open database if address is known:
     (The address can be found with DBADDR function supplied.)

    EX flp2_DBPTR_BIN,"@#ddddd"
    EW flp2_DBPTR_BIN,"@#ddddd"
    (where ddddd is the decimal address)

    Or:

    EX flp2_DBPTR_BIN,"@*nnnn"
    EW flp2_DBPTR_BIN,"@*nnnn"
    (where nnnn is  a four-byte string in which an address is stored
as if by POKE_L. This  facility is  intended for use from jobs other
than basic.)

    When an already  opened  database  is  used,  any  ordering  and
selection  stay   in  effect.  In  addition,  the  record  displayed
initially is the  current record upon handing over control. Likewise
the record displayed on quitting is the new current record.
    2) USE FROM MACHINE CODE or C
    The command string  should be  left as null if no database is to
be supplied.

    To use with an  already opened  database from machine code or C,
the command string must be set with one of the two following items:
    A)   word "@*"
         long nnnn (where nnnn is the address)
         The string length for this option must be six.
         For example, if the database address is $40720 then:
             $402A00040720
         would be stacked as the command string.


    B)   bytes "@#ddddd"     (where ddddd is the decimal address)
         Using the above example, then:
             "@#263968"      ($40720 = 263968)
         would be stacked as the command string.

    Any channels supplied are ignored.

    Source files for DBPTR_BIN:

    Extra source files required for main package:


