home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: InfoMgt / InfoMgt.zip / pvma110.zip / Read.Me < prev    next >
Text File  |  1996-11-29  |  17KB  |  321 lines

  1.                                  Oberon Peronal VoiceMail Assistant - PVMA
  2.                                                           (Formerly: pLog)
  3.                                                               Version 1.10
  4.  
  5.                                                      Oberon Software, Inc.
  6.                                                      1405 East Main Street
  7.                                                          Mankato, MN 56001
  8.                                                        Voice: 507-388-7001
  9.                                                          BBS: 507-388-1154
  10.                                            EMail: oberon@prairie.lakes.com
  11.                                           http://prairie.lakes.com/~oberon
  12.  
  13.   ------------------------------------------------------------------------
  14.  
  15.                            Contents
  16.                            ========
  17.  
  18.                       I.   Installing PVMA
  19.                       II.  Updating from pLog Version 1.00
  20.                       III. Using PVMA
  21.                            1. Configuration
  22.                            2. Placing a call
  23.                            3. Receiving calls
  24.                            4. Adjusting the time and date of a call
  25.                            5. Defining a macro
  26.                            6. Report
  27.                       IV.  Disclaimer
  28.  
  29.  
  30.   ------------------------------------------------------------------------
  31.  
  32. I. Installing PVMA
  33.  
  34.     1. If you wish to place PVMA into its own directory, you can do
  35.        one of the following:
  36.        - At an OS/2 command prompt, type "MD d:\PVMA".  Do not use
  37.          double quotes as in the example, replace "d:" with the
  38.          appropriate disk letter and "PVMA" with the name of the
  39.          directory you want to create.
  40.        - From the desktop "Drives" object, open a view of the drive
  41.          on which you wish to create the directory.  Open the "Templates"
  42.          folder and drag a "Folder" template onto the drive.  Rename
  43.          the new folder "PVMA" (or the name of your choice).
  44.  
  45.     2. If you have downloaded the PVMA package, unzip the ZIP file into
  46.        the directory.  If you received PVMA on diskette, copy the
  47.        entire contents of the diskette into that directory.
  48.  
  49.     3. Create a program object on your desktop or in the folder of your
  50.        choice by dragging a "Program" template from the "Templates"
  51.        folder onto the desktop or into the desired folder.  The settings
  52.        notebook for the program object will open automatically.  Fill
  53.        in the following fields:
  54.        - On the "Program" page (the first page) set "Path and program
  55.          name" to "d:\PVMA\PVMA.EXE" (replacing "d:\PVMA" with the
  56.          actual path-name of the directory into which you placed the
  57.          files).
  58.        - On the "Program" page, set "Working directory" to "d:\PVMA"
  59.          (again, replace "d:\PVMA" with the actual path-name of the
  60.          directory into which you placed the files).
  61.        - On the "General" page (the last page) set "Title" to
  62.          "Oberon Phone Logging" (or the title of your choice.
  63.  
  64.     4. The first time you run PVMA, it will ask you for a registration
  65.        number.  If you have been given one, enter it now.  If you have
  66.        purchased PVMA but have not yet received a registration number,
  67.        please contact Oberon Software and you will be assigned one.
  68.        If you are using an evaluation copy of PVMA, it will execute
  69.        successfully 50 times without registration.  Thereafter the
  70.        registration dialog will continue to display when you execute
  71.        PVMA but the program will no longer function.
  72.  
  73.     5. The first time you execute PVMA, you will want to select the
  74.        "Settings..." button to configure the program.  This is discussed
  75.        below under "Using PVMA/Configuration".
  76.  
  77.  
  78. II. Updating from pLog Version 1.00
  79.  
  80. PVMA Version 1.10 is file compatible with its predecessor, pLog.  After
  81. installing PVMA as per the directions above, you may copy your PLOG.INI
  82. from your old pLog directory onto PVMA.INI.  If you have entered a
  83. registration code for your copy of pLog, it will now be applied to your
  84. copy of PVMA.
  85.  
  86. You should also copy all of your log and macro files from the pLog directory
  87. into your PVMA directory, retaining their names.
  88.  
  89.  
  90. III. Using PVMA
  91.  
  92.     1. Configuration
  93.  
  94.        Select the "Settings..." button to change your PVMA configuration.
  95.        The following settings are available:
  96.  
  97.        - Inbound Log:  The full (or relative) path-name for the file in
  98.                        which PVMA will record its incoming call data.
  99.        - Outbound Log: The full (or relative) path-name for the file in
  100.                        which PVMA will record its outbound call data.
  101.        - Macro File:   The full (or relative) path-name for the file in
  102.                        which PVMA will keep the macro which you define
  103.                        (see "Placing a call").
  104.        - Faxworks:     The full path-name to your FaxWorks phone book
  105.                        file.  If you do not use FaxWorks or if you don't
  106.                        want PVMA to search your FaxWorks phone book for
  107.                        voice numbers, leave this field blank.
  108.        - Com Device:   The COM port you wish PVMA to use.  I.e., "COM1"
  109.        - Modem Init:   The modem initialization string which PVMA will
  110.                        send to the modem each time before it dials.
  111.        - Modem Dial:   The modem command to dial a number (this the
  112.                        a prefix; the actual number will be appended to
  113.                        this string).
  114.        - Modem Hangup: The modem command to hang up the line.  (You may
  115.                        leave this blank and check "Drop DTR at Hangup"
  116.                        if your modem is configured to drop connection
  117.                        after a DTR transition.)
  118.  
  119.  
  120.     2. Placing a call
  121.  
  122.        The place an outbound call, press the "Outbound..." button.  This
  123.        will display the "Dialer" window.  Here you may either type a
  124.        phone number, a macro, or a name that will be found in your FaxWorks
  125.        phone book (if you have so configured PVMA).  The way PVMA decides
  126.        which is which is as follows:
  127.  
  128.        - If the first character of the entry is a digit, it is assumed to
  129.          to a phone number and will be dialed verbatim (letters will be
  130.          translated to numbers as per the standard telephone dial conversion).
  131.        - If the first character of the entry is a letter, PVMA will look
  132.          first through your macro list.  If it finds an exact match (except
  133.          possibly for upper/lower case differences), it will dial the
  134.          macro's associated number.
  135.        - If nothing was located in the macro list, and you have provided
  136.          the filename of your FaxWorks phone book, PVMA will search that
  137.          file for matching records.  It will compare versus the full name
  138.          entry in the FaxWorks phone book AND versus just the last name.
  139.          That is, if "John Smith" is in your FaxWorks phone book, you can
  140.          type either "Smith" or "John Smith" to locate him.  However, if
  141.          you have more than one "Smith" in your phone book and type only
  142.          "Smith", PVMA will return only the first one; in this case you
  143.          will need to use the entire name to ensure that you get the
  144.          correct result.
  145.        - If none of the above cases apply, PVMA will then translate the
  146.          letters to numbers, and attempt to dial the number.
  147.  
  148.        Another way to dial a number is to click on the "Macros..." button,
  149.        select an entry from the list of macros, and press "OK".  The
  150.        associated number from the macro list will filled in automatically.
  151.  
  152.        There are also several ways to dial an outbound call from the
  153.        "Report" display.  See the section on "Report" later in this
  154.        document.
  155.  
  156.        When you click on the "Dial..." button, PVMA will display a
  157.        window which says "Dialing...", shows you the number it is dialing,
  158.        and "Press ENTER when complete".  At this point you must listen to
  159.        the sound coming from your modem.  You should hear first a dial
  160.        tone, then the dialing tones, and finally the ringing of the phone
  161.        on the other end.  At this point, you must lift the receiver on
  162.        your phone and then press the "Enter" button.  If you press "Enter"
  163.        BEFORE you lift the receiver, PVMA WILL hang up the phone and your
  164.        call will not go through.  (You can use this feature if you find
  165.        that you are dialing a wrong number, if PVMA has misinterpreted
  166.        what you input, or if you hear a busy signal on the other end.  The
  167.        "Outbound Call" dialog described below will still appear but you
  168.        should simply "Cancel" it in this case.)
  169.  
  170.        After the call has been dialed, you will see a dialog window
  171.        titled "Outbound Call".  This window controls what information will
  172.        be placed into PVMAs Outbound call log.  The date and start time
  173.        are filled in automatically; the end time and duration are updated
  174.        as the call progresses until you select either "Done" or "Stop".
  175.        The Phone number is also automatically filled in but you may edit
  176.        this field if you wish.  If you dialed using a Macro or a FaxWorks
  177.        phone book entry, the "To" field will also be filled in; you may
  178.        edit this field also.  In the center of the window is a large area
  179.        wherein you may make any notes you wish regarding the call.  If
  180.        you select the "Callback" checkbox, this record will be marked in
  181.        the report as needing a callback (see the section on "Report" later
  182.        in this document).  The "Stop" button will stop the call timer
  183.        without dismissing the window (use this in case you have further
  184.        notes to make regarding this call after actual call has ended),
  185.        the "Cancel" button will dismiss this window WITHOUT saving any
  186.        of the information, the "Done" button will dismiss this window
  187.        after saving the log information.
  188.  
  189.  
  190.     3. Receiving calls
  191.  
  192.        When you receive a call, press the "Incoming..." button.  You
  193.        will be shown a window with the title "Incoming Call" which is
  194.        in almost all respects the equivalent of the "Outbound Call"
  195.        window (see discussion on "Placing a call" above).  The only
  196.        real difference between this two windows (other than the fact
  197.        that calls entered via this window will be placed in the Inbound
  198.        log rather than the Outbound log), it that the name and number
  199.        are not automatically filled in; you must enter them your self.
  200.  
  201.        If the incoming call is from someone for whom you have a defined
  202.        macro or if they have a voice number in your FaxWorks phone
  203.        book, you may type the macro or name in the "From" field and
  204.        press the ENTER key while the cursor is in the "From" entry
  205.        field.  PVMA will search your macro file and FaxWorks phone book
  206.        using the same techniques as outline in "Placing a call" above.
  207.        If the name or macro was not found, PVMA will issue a warning
  208.        beep; you will then have to enter the phone number manually.
  209.  
  210.        Note: You can use the "Incoming Call" window to record voice mail
  211.        messages and mark them for callback!  You will probably want to
  212.        press the "Stop" button as one of your first actions in this case
  213.        if your Inbound call duration statistics are a concern to you
  214.        (see the discussion below entitled "Adjusting the time and date of
  215.        a call").
  216.  
  217.  
  218.     4. Adjusting the time and date of a call
  219.  
  220.        You may adjust the time, date, and/or duration of a call from
  221.        both the Inbound and Outbound call dialogs.  Once you have clicked
  222.        on the "Stop" button to stop the call timer, the button text
  223.        changes to "Edit".  When you click on the "Edit" button, you will
  224.        be given a dialog which allows you to edit the call date, time,
  225.        and duration.  If you change these values, the new values MUST
  226.        be entered EXACTLY in the format that they are given in when the
  227.        dialog first appeared.
  228.  
  229.        You may also adjust the time, date, and/or duration of a call from
  230.        the "Report" view by selecting the "Adjust Time and Date" item
  231.        from the popup menu.  The same restrictions apply when editing
  232.        these values from the "Report" view.
  233.  
  234.  
  235.     5. Defining a macro
  236.  
  237.        A dialing macro is a short name which you can use in place of
  238.        an actual phone number when you use PVMA.  To be effective, a
  239.        macro should be short and easy to remember.  Examples are:
  240.        "Home", "Car", "Bank", "Mom", and so on.
  241.  
  242.        To define a dialing macro, press the "Outbound..." button on the
  243.        main display.  This invokes the "Dialer" window.  Press the
  244.        "Macros..." button and you will see the "Macro List" window.
  245.        Here you may add, delete, or modify your macros.  Adding and
  246.        deleting procedures are straightforward and invoked via the
  247.        buttons with those labels.  To edit an entry, click on it with the
  248.        left mouse while holding down the ALT key.  You may then edit the
  249.        selected field.  Click anywhere away from the entry field to end
  250.        the edit and save your changes; press ESCape to cancel the changes.
  251.  
  252.     6. Report
  253.  
  254.        PVMA has numerous reporting options.  By default, when you press
  255.        the "Report..." button, you will be shown a list of all of your
  256.        calls, outbound and incoming.  This will quickly become unwieldy
  257.        as you use PVMA.  Use the "Options..." button to limit which
  258.        calls are displayed and in what sort-order they are displayed.
  259.  
  260.        Your options are:
  261.        - Merge:  Outbound only, Inbound only or both
  262.        - Sort:   By Date & Time, Name (then Date & Time), or Number
  263.                  (then Name, Date & Time)
  264.        - Filter: By Date: All date (no filter), just today's calls, or
  265.                           in a given range.  Date entry is flexible;
  266.                           you may enter dates in a variety of formats.
  267.                           If you enter only one end of a range, it is
  268.                           assumed that the other end is open (i.e.,
  269.                           a start date of 2/1/96 with no end date means
  270.                           calls on or after 2/1/96; and end date of
  271.                           2/1/96 with no start date means calls on or
  272.                           before that date).
  273.                  By Type: All calls (no filter), only callbacks, only
  274.                           non-callbacks.
  275.                  By Text: You can specify string which must occur in the
  276.                           Name, Number, and/or Note fields.  The search is
  277.                           not case sensitive and the string may occur
  278.                           anywhere in the field.  (i.e., the string "ron"
  279.                           in the Name field will match both "Oberon Software"
  280.                           and "Ronald McDonald").  Multiple search
  281.                           criteria are cumulative (i.e., searching name
  282.                           for "IBM" and Number for "1-800" will find all
  283.                           toll-free calls to IBM).
  284.  
  285.  
  286.        Both "Export..." and "Print..." work on the currently displayed
  287.        list of calls.
  288.  
  289.        "Export..." will write the currently displayed list to a standard,
  290.        comma delimited file (SDF format) suitable for import into a
  291.        spreadsheet or other program.  You will be asked for the file name.
  292.  
  293.        "Print..." will print a formatted report of the displayed calls
  294.        to the printer of your choice.
  295.  
  296.  
  297. IV. Disclaimer
  298.  
  299.     Every care has been taken so that PVMA will perform as outlined in
  300.     this document and that it is as error free as the author can make it.
  301.     We should be aware however that no piece of software is ever totally
  302.     bug free.
  303.  
  304.     Use of this software for any purpose whatsoever constitutes your
  305.     unqualified acceptance of the following statements.
  306.  
  307.     The author makes no warranty or representation that the software will
  308.     be error free.  The author disclaims any warranties, either express or
  309.     implied, including but not limited to any implied warranty of
  310.     merchantability or fitness for any particular purpose.
  311.  
  312.     The user agrees to take full responsibility for the selection of and
  313.     any use whatsoever made of the software.
  314.  
  315.     IN NO EVENT WILL THE AUTHOR BE LIABLE FOR ANY DAMAGES WHATSOEVER
  316.     (INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF BUSINESS PROFITS,
  317.     BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION OR THE LIKE)
  318.     ARISING OUT OF THE USE OF, INTERRUPTION IN THE USE OF, OR INABILITY
  319.     TO USE THIS SOFTWARE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF ANY
  320.     POSSIBILITY OR LIKELIHOOD OF SUCH DAMAGES.
  321.