CPMODEM

                  Working with MODEM in Background mode

     The program CPMODEM permits to connect with a remote computer using a
modem, to exchange the messages in terminal mode and to organize
receiving/transfer of files. All the operations can be performed in a
background mode, i.e. you can use your computer for other applications in
time of redialing or data transfer.

     To provide the exchange of information you need the Fossil-driver which
is responsible for buffering of the data received and transmitted.  The
package includes driver PTS-Fossil which should be started to call CPMODEM:

   Fossil [[/p1][/p2][/p3][/p4]] | [/h] | [/?]

where

/p1...4 - specifies for which serial ports the buffering is necessary.
/ H, /? - invokes the help feature.

     Fossil without parameters can be set up on all present serial ports up
to the fourth one.

Attention! For the correct work of the CPMODEM in a background mode
           and using a network you should use only PTS-fossil!

                          Starting the PROGRAM

     CPMODEM can be started from CP by pressing the keys [Alt-F1]. On
pressing it once you start the subroutine of work with the Telephone
database.

                    Keys in a Telephone database mode

   [Esc]         - exit to CP.
   [Enter]       - type in number.
   [Up], [Down]  - move cursor.
   [Ins]         - insert new record.
   [+]           - add record at the end of the list.
   [F3]          - edit record.
   [Del]         - delete record.
   [Ctrl-T]      - pass to terminal-mode.
   [Ctrl-S]      - setup parameters.

     The record consists of two parts: name of user and his telephone
number.  On pressing the key [Enter] the program passes to terminal mode and
begins automatic dialing the number. In case the users number is busy or if
the connection is not established for one reason or another the program
automatically hangs up the receiver and redials the number.

                         Keys in Terminal-mode:

  [F10]       - exit to CP.
  [Alt-H]     - hang the receiver (redialing is interrupted).
  [Alt-I]     - initialize the modem.
  [Alt-D]     - pass to the telephone database mode.
  [Blank]     - (when redialing) redial the number.
  [Ctrl-PgUp] - send a file (only when the connection is established).
  [Ctrl-PgDn] - receive a file (only when the connection is established)

     In Terminal mode all the symbols received from modem are displayed on
the screen, and symbols typed on keyboard are transmitted to modem.  At any
moment the user can leave CPMODEM by pressing the key [F10] (or [Esc] if the
connection was not established) and start any program or even leave CP. In
the meantime all the information received will be transferred to the virtual
screen in the memory and will be displayed on the screen when you call
CPMODEM again. It allows you to use the computer for other applications in
time of redialing or files transfer. To return to CPMODEM you should press
the key [Alt-F1] from CP. CPMODEM will immediately return to the terminal
mode.  In output onto the screen the terminal emulation TTY and ANSI modes
are used.

                        The mode of file transfer

    For file transfer the Upload mode (sending the files) and Download mode
(receiving the files) are intended. To pass to these modes you should press
[Ctrl-PgUp] and [Ctrl-PgDn] in terminal mode, respectively.  The protocol of
data transfer ZMODEM developed by Omen technology,Inc.  is realized in
CPMODEM program. It provides correct data transfer at very high rate and it
is used the most often for data transfer with modem. The Upload mode
(sending files) requires the list of files to be transferred.  The user may
highlight required files in CP before starting CPMODEM, or (in case he
didn't) the program will ask the name of file to be transferred. The
standard symbols "*" and "?" may be used in the filename.  In latter case if
the path to the files is not specified, the program will look for them in
the setup directory defined in CPMODEM Setup.  The received files are placed
to the catalog which is defined in the parameters setting program.

                           Parameters setting

     To enter the setup menu press the keys [Ctrl-S] in database mode.

     Main menu:

                          +---CPMODEM Setup----+
                          |   Line Settings    |
                          |   Modem Settings   |
                          |   Directories      |
                          |   Save Setup       |
                          +--------------------+

    The setup menu for line parameters:

                        +-----Line Settings------+
                        |   Communication Port   |
                        |   Baudrate             |
                        |   DataBits             |
                        |   Parity               |
                        |   StopBits             |
                        |   Flow Control         |
                        +------------------------+

     In this menu the user defines the data exchange parameters with modem:

Communication port  - the serial port to which the modem is connected

Baudrate            - the rate of data exchange with modem. Usually
                      the modem sets the same rate in communicating with
                      a remote modem.

                      Attention!  Some modems may automatically change the
                      rate of exchange with computer after connection,
                      that may cause incorrect work. Usually you should
                      just except this possibility in the modem
                      initialisation string and use the flow control to
                      avoid the buffer overflow.

Databits
Parity
StopBits            - these parameters describe the data format for
                      exchange with modem. They should be set up in
                      accordance with the modem description.

Flow control        - here you select the method of the data flow
                      operating:  by means of the symbols XOn and XOff or
                      by means of signals RTS and CTS.

Attention! You cannot change line parameters while the CPMODEM is in the
           redialing or connection mode.

     Modem settings menu:

                        +-----Modem Settings-----+
                        |   Initialization       |
                        |   dial Prefix          |
                        |   dial Suffix          |
                        |   Hangup command       |
                        |   Disconnect Message   |
                        |   Connect Message      |
                        |   hAngup delay time    |
                        +------------------------+

Initialization
               - the string to be send to modem for initialization.
dial Prefix    - the part of input command preceding to the telephone
                 number.
dial Suffix    - the part of input command following the telephone number.

Hangup command - the command for modem to interrupt connection and hang up
                 the receiver. In this string the symbol '~' means the
                 pause with the duration denoted in the point "hAngup
                 delay time".

Disconnect message
              - the list of messages from modem about lost carreer.  The
                messages are divided by symbols ';'.  When CPMODEM
                recognizes one of these messages and the connection is
                established, it automatically sends the command to
                interrupt the connection and hang up the receiver.

Connect message
              - The list of messages about connection. The messages are
                divided by symbols ';'. when CPMODEM recognizes one of
                this messages, it automatically passes to the connection
                mode.

hAngup delay time
              - the duration of the pause caused by the symbol ';'
                in Hangup command (seconds).


     Directories menu:

                        +---Change Directories---+
                        |   Download directory   |
                        |   Upload directory     |
                        +------------------------+

Download directory
         - the directory for files being received. All the files received
           will be placed in this directory. This directory must exist
           certainly! Otherwise the error occurs in transferring files.

Upload directory
         - the directory for the files being sent. The program is looking
           for files in this directory if the user doesn't specify himself
           the entire pathway to them.  It does not matter if the group of
           files was selected from CP.

Save setup
        - saves the settings in the configuration file CPMODEM.STP.