home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / DESKTOP / PDLDIAL.ZIP / PDL.DOC < prev    next >
Text File  |  1991-06-06  |  52KB  |  1,038 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                        ==============================
  8.  
  9.                         PDL Phone Dialer  -  vr.1.00
  10.  
  11.                        ==============================
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.          (C) Copyright 1991 by Steven Hawkins.  All Rights Reserved.
  36.  
  37.  
  38.                             +---------+
  39.                      +---------+      |               (R)
  40.                    --|         | O    |------------------
  41.                      |   +---------+  |  Association of
  42.                      |   |         |--+  Shareware
  43.                      +---|    O    |     Professionals
  44.                    ------|    |    |---------------------
  45.                          +---------+     Member
  46.  
  47.  
  48.  
  49.  
  50.          Distributed and Supported by :     FormGen Corporation
  51.                                             #9 - 13 Holland Dr.
  52.                                             Bolton, Ontario, Canada
  53.                                             L7E 1G4
  54.                                             (416) 857-4141
  55.  
  56.  
  57.  
  58.  
  59.         "This program is produced by a member of the Association of
  60.         Shareware Professionals (ASP).  ASP wants to make sure that the
  61.         shareware principle works for you.  If you are unable to resolve a
  62.         shareware-related problem with an ASP member by contacting the
  63.         member directly, ASP may be able to help.  The ASP Ombudsman can
  64.         help you resolve a dispute or problem with an ASP member, but does
  65.         not provide technical support for members' products. Please write
  66.         to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send
  67.         a CompuServe message via CompuServe Mail to ASP Ombudsman
  68.         70007,3536."
  69.                               DISCLAIMER OF WARRANTY
  70.  
  71.         WITH THE USE OF THIS PROGRAM, THE USER ACKNOWLEDGES THIS DISCLAIMER
  72.         OF WARRANTY : 'THIS PROGRAM IS SUPPLIED AS IS.  THE AUTHOR
  73.         DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
  74.         LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS OF
  75.         THIS PROGRAM FOR ANY PURPOSE.  THE AUTHOR WILL ASSUME NO LIABILITY
  76.         FOR DAMAGES DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE
  77.         OF THIS PROGRAM.  ANY LIABILITY OF THE AUTHOR WILL BE LIMITED
  78.         EXCLUSIVELY TO EITHER PRODUCT REPLACEMENT OR THE REFUND OF THE
  79.         PURCHASE PRICE.'
  80.                          PURCHASE AND LICENSE INFORMATION
  81.  
  82.         This program is NOT public domain but is being distributed via the
  83.         "Shareware" concept.  The program may be freely distributed but it
  84.         cannot under any circumstances be sold by anyone except the author.
  85.         You may distribute the program to others provided that it has not
  86.         been modified in any way, and that all supplied documentation and
  87.         support files remain intact.
  88.  
  89.         Feel free to try out the program for 30 days to see if it meets
  90.         your needs.  If you continue to use the program after the trial
  91.         period then please register by sending $25.00 as a single copy
  92.         license fee along with the registration form at the end of this
  93.         document to:
  94.                              FormGen Corporation
  95.                              #9 - 13 Holland Dr.
  96.                              Bolton, Ontario, Canada
  97.                              L7E 1G4
  98.  
  99.         A single copy license fee entitles you to execute the program on
  100.         only one machine at a time.  You may move the program from one
  101.         machine to another, store the program on several machines or store
  102.         the program on a network fileserver as long as the program is only
  103.         executed on one computer at a time.
  104.  
  105.         When you register, you will receive much more extensive, printed
  106.         documentation, a copy of the latest version without the Shareware
  107.         reminder screen, notification of and a discount on any future
  108.         updates, and unlimited tech support.
  109.  
  110.         Volume discounts, site licenses, LAN licenses etc. are available
  111.         under very reasonable terms.  Please send any reports of bugs or
  112.         requests for multiple copy licensing to the above address.
  113.  
  114.  
  115.  
  116.                               COMMERCIAL DISTRIBUTION
  117.  
  118.         Shareware distributors or bulletin board operators may distribute
  119.         the program only under the following conditions :
  120.  
  121.         - PDL must be distributed as a complete system with all original
  122.           files included.
  123.  
  124.         - PDL and its accompanying files may not be modified in any way.
  125.  
  126.         - No form of documentation may be added to the system.
  127.  
  128.         - No other software may be included on the diskette (or in the .ARC
  129.           or .ZIP file in the case of a bulletin board posting)
  130.  
  131.         - No purchase fee may be charged, a nominal handling and shipping
  132.           fee of $10 or less is allowed.
  133.  
  134.                                      SHAREWARE
  135.  
  136.         "Shareware" is a term used to describe a system for distribution of
  137.         software.  Under the shareware concept, software may be freely
  138.         copied and passed along to others, or distributed through bulletin
  139.         board systems, etc.
  140.  
  141.         As a recipient of a shareware program, you may use the software for
  142.         a short trial period to determine if it meets your needs.  If it
  143.         does, you pay the registration fee.  By paying the fee, you are
  144.         granted the right to retain the software for your use.  If the
  145.         software is not suitable, then you may discard it.
  146.  
  147.         The shareware system provides substantial benefits.
  148.  
  149.         1) You get to try out the software before you buy it so you know
  150.            exactly what you're buying.
  151.  
  152.         2) Shareware is substantially less expensive than most commercial
  153.            programs.  You don't pay for costly marketing programs and fancy
  154.            packaging.
  155.  
  156.         3) You get access to a much broader base of available programs.
  157.            Thousands of excellent programs have been written by expert
  158.            programmers who would never consider marketing commercially.
  159.            Through the concept of shareware, these people make their
  160.            programs available to the community.  Usually, all they ask in
  161.            return is a small fee to reward them for the time and effort
  162.            they have put into the program.
  163.  
  164.         The system is based entirely on the honor system, and generally
  165.         works quite well.  (Most people are honest and wouldn't violate the
  166.         trust placed in them by the author of the software.)  Shareware is
  167.         NOT free software - the author counts on your integrity.  Please
  168.         register using the form at the end of this manual.
  169.  
  170.         You are encouraged to copy this software and pass it along to others
  171.         who may be interested in using it.
  172.  
  173.  
  174.                                                                      Page 4
  175.  
  176.  
  177.        ==  Contents  ========================================================
  178.  
  179.         =  Introduction  ..............................       page  5
  180.  
  181.         =  Configuration  .............................       page  5
  182.  
  183.         =  Startup  ...................................       page  8
  184.  
  185.         =  Functions  .................................       page  9
  186.  
  187.            Letter Searches     ........................       page  9
  188.            Initial Search : F3 ........................       page  9
  189.            Text Search : F4      ......................       page 10
  190.            Case Sensitivity : F5 ......................       page 11
  191.            Dial Number : Enter     ....................       page 11
  192.            Exit PDL : Escape / F10  ...................       page 11
  193.  
  194.         =  Directory Files  ...........................       page 12
  195.  
  196.            Load Directory Files : F2  .................       page 13
  197.            Edit Directory Files : F7  .................       page 13
  198.  
  199.         =  Log Files  .................................       page 15
  200.  
  201.            Log File Toggle : F6  ......................       page 16
  202.  
  203.         =  Long Distance Codes etc.  ..................       page 16
  204.  
  205.         =  System Time Display  .......................       page 17
  206.  
  207.         =  Command Line Options  ......................       page 17
  208.  
  209.         =  PDL Registration  ..........................       page 18
  210.  
  211.  
  212.  
  213.  
  214.                                                                      Page 5
  215.  
  216.        ==  Introduction  ====================================================
  217.  
  218.         The PDL Dialer is a very simple to use utility that dials phone
  219.         numbers via your modem.  You can create any number of directory
  220.         files for use with the program and quickly load them into the
  221.         dialer.  You can locate a directory entry by searching for
  222.         Initials, searching for Text, or by going to the First Letter of a
  223.         record.  You can enter an Access Code that will be added to the
  224.         number dialed automatically in order to clear office switchboards
  225.         etc.  If you travel frequently, you can assign a default local area
  226.         code that will be removed from any long distance numbers when you
  227.         go to dial out.
  228.  
  229.         PDL is provided in two different forms, a memory resident version
  230.         called PDLr and a transient (non-resident) version called PDLn.
  231.         The memory resident version has a capacity of 100 records and can
  232.         be easily popped up from any application or DOS.  The non-resident
  233.         version has a capacity of up to 800 records but must be run from
  234.         the DOS prompt like a nornal DOS application.  Both version of PDL
  235.         can be easily setup for a tone or pulse phone line, and you can
  236.         also enter an initialization string for your modem.  You can also
  237.         change the hotkeys used by PDLr.  Both PDLr and PDLn are
  238.         functionally identical with the exception of the Startup and Exit
  239.         method.  These minor differences are discussed where appropriate
  240.         below.
  241.  
  242.         This package is supplied with three executable files, the resident
  243.         dialer PDLR.COM, the transient version PDLN.COM and a simple
  244.         configuration program called PDLC.EXE.  You MUST run the PDLc
  245.         configuration program before using the PDL dialer.
  246.  
  247.  
  248.        ==  Configuration  ===================================================
  249.  
  250.         In order to use PDL, you must run the PDLc setup utility.  This
  251.         program allows you to set screen colours, setup hardware
  252.         parameters, establish various program defaults, and define the
  253.         hotkey for the memory resident version.  Start PDLc by typing
  254.         "PDLC" and hitting Enter.  The lower half of your screen will
  255.         clear to present the following display :
  256.  
  257.         | PDLc | vr.x.xx | (c) Copyright 1991 S.Hawkins. All rights reserved|
  258.         +-------------------------------------------------------------------+
  259.         | Color              Options                  Modem                 |
  260.         | General   :  7   | Sys.Time    :  Y       | Com Port   :  Com?    |
  261.         | Highlight :  15  | Log Call    :  N       | Baud Rate  :  1200    |
  262.         | Edit      :  112 | Log Type    :  Both    | Dial Type  :  Pulse   |
  263.         | Header    :  112 | Tone Freq.  :  200  Hz | Initialize :          |            |
  264.         | Bar       :  112 | Access Code :          |                       |
  265.         | Keys      :  15  | L.Dist Code :          | ----------------------|
  266.         |                  |                        | HotKey : Mk 08 Scn 39 |
  267.         +-------------------------------------------------------------------+
  268.                       Up Dwn:Move  Space:Toggle  F2:Hotkey   Esc:Exit
  269.  
  270.  
  271.  
  272.                                                                      Page 6
  273.  
  274.         You can move from field to field using the Up and Down Arrow Keys.
  275.         When you are done, press the Escape key to exit PDLc.
  276.  
  277.         The section on the left allows you to change the colors used by PDL
  278.         if you find the defaults unacceptable.  The labels should easily
  279.         identify what the values refer to and won't be discussed here.  If
  280.         you start PDLc on a color system, it will attempt to set the color
  281.         values accordingly, therefore the values illustrated above may not
  282.         be what you will see.  Also, it is essential that the Highlight and
  283.         Edit colors be different values, particularly on a monchrome
  284.         system.
  285.  
  286.         The centre section allows you to change log operations, the
  287.         frequency of the error tone, and assign any Access or Long Distance
  288.         Codes.  Each option is outlined below :
  289.  
  290.         Sys.Time     :  If "Y", PDL will startup with the system time
  291.                         displayed on the status line.  This switch can be
  292.                         over-ridden by the "/t" command line switch
  293.                         discussed in the Display System Time section at the
  294.                         end of this file.
  295.  
  296.         Log Call     :  Allows you to toggle the Log Call function On or
  297.                         Off.  This is the Log Function's default setting
  298.                         when PDL is loaded.  Its can be easly toggled On or
  299.                         Off from within PDL.
  300.  
  301.         Log Type     :  Allows you to log only Local, Long Distance or Both
  302.                         calls to a log file called PDL.LOG.  Just press the
  303.                         Spacebar to toggle through the available choices.
  304.                         This option does Not turn the log function On or
  305.                         Off.
  306.  
  307.         Tone Freq.   :  Allows you to set the frequency of the beep signal
  308.                         used when a record cannot be found with a search
  309.                         command.  By default, the 200 Hz. cycle is not
  310.                         offensive, but may be too low for your environment.
  311.                         Type in the value you want to a maximum of 9999.
  312.  
  313.         Access Code  :  The Access Code allows you to add a dialing prefix
  314.                         with pause commands and numbers, to get through an
  315.                         office switchboard etc.  Type in the values you
  316.                         need using the symbols specified in your modem
  317.                         manual.  A typical pause would be a , comma
  318.                         character.
  319.  
  320.         L.Dist Code  :  Phone numbers in PDL should always be entered with
  321.                         their full dialing prefix and area code.  The
  322.                         L.Dist Code is the value you need to remove from
  323.                         this full number in order to change it to a local
  324.                         call.  For example, if you live in area code 416
  325.                         and all numbers are entered in your directory in
  326.                         the format "1-xxx-xxx.xxxx", then the L.Dist Code
  327.  
  328.  
  329.  
  330.                                                                      Page 7
  331.  
  332.                         would have to be "1-416".  When the number is
  333.                         dialed, the "1-416" and the "-" following it are
  334.                         stripped off to create a local number.  Please see
  335.                         the section on Long Distance Codes near the end of
  336.                         this manual.
  337.  
  338.         The block on the right allows you to change the modem setup.  The
  339.         Com Port can be set from 1 to 4 by hitting the Spacebar.  Press the
  340.         Down Arrow or Enter Key to move to the Baud Rate field, and use the
  341.         Spacebar to run through the list of choices until your number comes
  342.         up !  Options are 300, 1200, 2400, and 9600 baud.
  343.  
  344.         Next, move to the Dial Type field to set either Tone or Pulse,
  345.         using the Spacebar to toggle your choice.
  346.  
  347.         The Initialize section allows you to make changes to the default
  348.         values sent to your modem when PDL is loaded from the DOS prompt or
  349.         popped up.  Please consult your modem manual for available options.
  350.         Internally, PDL always sends the following Initialization string :
  351.  
  352.                            AT E0 S0=0 S11=65 Q1
  353.  
  354.                  AT        get the modems attention
  355.                  E0        do not echo back commands
  356.                  S0=0      disable answer mode
  357.                  S11=65    set dialing speed to 65 milli-seconds
  358.                  Q1        Disable Result Codes
  359.  
  360.         These defaults should be fine for any Hayes compatible modem.
  361.         Should you wish to change any of them or add new settings, just
  362.         type them in, up to 25 characters.  Any entries should always be
  363.         preceded by an "AT" command.  If you forget to add the AT then PDLc
  364.         will beep at you when you leave the Initialize field, add the "AT"
  365.         for you, and re-display the new values.  If you have entered a full
  366.         line of changes, some of them may be dropped off by the addition of
  367.         the "AT" command.  Please check the string before moving on to the
  368.         next item.
  369.  
  370.         The Hotkey section allows you to change the default Alt Spacebar
  371.         hotkey used by PDLr should it conflict with another memory resident
  372.         application.  To change the hotkey, press F2 to access the keymask
  373.         value,  The Keymask can ONLY be one of four possible keys, Ctrl,
  374.         Alt, Left or Right Shift.  When you press the appropriate key, its
  375.         Keymask value is displayed and the cursor moves over to the
  376.         Scancode box.  The Scancode value can be any other single key
  377.         supported by your systems BIOS.  Just press the key you wish to
  378.         use, and its Scancode value will appear on the display and you will
  379.         be returned to the first field on the PDLc display.  If your BIOS
  380.         does not support the selected key or you enter an illegal Keymask
  381.         value, PDLc will beep at you and not allow you to move on to the
  382.         next item.
  383.  
  384.         When all configuration options are set as you wish, press the
  385.         Escape key to return to DOS.  Your current setup options are
  386.  
  387.  
  388.                                                                      Page 8
  389.  
  390.         written to a file called PDL.CNF.  This file is always written to
  391.         the directory from which the PDLc utility has been run.  The
  392.         contents of this file are loaded every time you start either of the
  393.         two PDL Dialers.
  394.  
  395.  
  396.        ==  Startup  =========================================================
  397.  
  398.         Resident Version :
  399.  
  400.         To start the resident version of PDL, type "PDLR" on the DOS
  401.         command line and press Enter.  A brief copyright notice will
  402.         appear, PDLr and the default directory file PDL.DIR will be loaded
  403.         into memory, and the DOS prompt will be restored.  If PDL is
  404.         already in memory, then the message 'PDLr Already Loaded' will
  405.         appear.  To use the dialer, just pop it up using the key
  406.         combination Alt Spacebar (hold down the Alt key, tap the Spacebar,
  407.         and then release both keys).  If you have changed the hotkeys with
  408.         the PDLc utility, please substitute accordingly.
  409.  
  410.         Non Resident Version :
  411.  
  412.         To start the non-resident version of PDL, type "PDLN" on the DOS
  413.         command line and press Enter.  A copyright screen will then appear.
  414.         Press any key, and PDLn will load the default directory file
  415.         PDL.DIR and initialize your modem.
  416.  
  417.         Main Screen :
  418.  
  419.         Regardless of which version of PDL you use, the main screen will
  420.         appear as illustrated below :
  421.  
  422.         :  PDLx  | Dir : c:\pdl\pdl.dir            | 12:36:14 am |.l|  View :
  423.         +-------------------------------------------------------------------+
  424.         |     |
  425.         |     |
  426.         |    |
  427.         |>|ATI   ATI Technologies Inc.    Tech.Support      1-416-756-0711|<|
  428.         |  ATI   ATI Technologies Inc.    Graphics Cards    1-416-756-0718  |
  429.         |  AC    Ace Computer                               1-416-865-1112  |
  430.         |  AC    American Cybernetics     Multi-Edit        1-602-968-1945  |
  431.         +-------------------------------------------------------------------+
  432.         F1:Hlp F2:Dir F3:Ini F4:Txt F5:Case F6:Log F7:Edt  Rtn:Dial  Esc:Exit
  433.  
  434.         The top line in reverse video is the Status Line containing the
  435.         name of the directory file currently loaded, the system time, the
  436.         status of the Case Sensitivity and Log switches, and the current
  437.         mode.  Most of the time you will be in View Mode.
  438.  
  439.         The centre block displays seven phone records.  The centre line
  440.         highlighted in reverse video is the number ready to be dialed.  The
  441.         Arrow, PgUp, PgDn, Home, and End keys scroll through the centre
  442.         block displaying all available records.  Some functions use this
  443.         centre line for prompts or user input.
  444.  
  445.  
  446.                                                                      Page 9
  447.  
  448.         Each phone record contain a number of fields moving from left to
  449.         right.  The first is an initial field used for fast searches.  Next
  450.         is the name of the person or company, followed by a brief note.
  451.         The phone number then follows, pushing up to the right margin of
  452.         the block.
  453.  
  454.         Along the bottom you will see a command reference illustrating all
  455.         commands and their function key assignments.
  456.  
  457.  
  458.        ==  Basic Functions  =================================================
  459.  
  460.         This section outline some of the various functions available in
  461.         PDL.  For more information on Directory files, please see the next
  462.         section.
  463.  
  464.  
  465.        --  Letter Searches  -------------------------------------------------
  466.  
  467.         When PDL starts up, it usually moves to and displays the first
  468.         record in the directory.  As was previously mentioned, you can use
  469.         the Arrow, PgUp, PgDn, Home, and End keys to move through the file.
  470.  
  471.         An even faster way is to enter the first letter of the record you
  472.         wish to find.  PDL will then move instantly to the first record
  473.         starting with that letter.  The first record found is based on the
  474.         person or company name, not the first letter of the Initial at the
  475.         left edge of the centre block.  The Letter Search function is not
  476.         case sensitive and is not affected by the Case switch discussed
  477.         below.
  478.  
  479.  
  480.        --  Initial Search : F3  ---------------------------------------------
  481.  
  482.         You can locate a record by searching for the Initials that appear
  483.         at the left margin of the centre block.  When you press F3, you are
  484.         placed in Init Mode, and the reverse video line in the main records
  485.         block clears to prompt you to enter the Initials you wish to find.
  486.         Initials can be up to 4 letters only.
  487.  
  488.          ----------------------------------------------------------------
  489.         >|      Search for Initials   .    .                            |<
  490.          ----------------------------------------------------------------
  491.  
  492.         Just type them in and press the Up or Down Arrow key to tell PDL in
  493.         which direction you would like to start the search.  If the
  494.         initials cannot be found in the designated direction, PDL will wrap
  495.         around to the top or bottom of your file and continue the search.
  496.         If the initial does not exist then PDL will softly beep at you and
  497.         display the prompt line for a new entry.  If a matching record is
  498.         found, the prompt box will clear and the record will be highlighted
  499.         in reverse video, ready to dial by pressing Enter.  If the record
  500.         is not the one you want, continue to press an appropriate Arrow key
  501.  
  502.  
  503.  
  504.                                                                      Page 10
  505.  
  506.         until you find it.  If you wish to enter new initials to find,
  507.         press the F3 key to restore the prompt line.
  508.  
  509.         Within Init Mode you can also toggle the status of the Case and Log
  510.         keys (F5 and F6 respectively).  The Initial search function is
  511.         affected by the status of the Case key.  When Case is Off, all
  512.         entries are capitalized automatically and the search is not case
  513.         sensitive.  When Case is On, the entries you make are searched for
  514.         literally and the prompt line displays exactly what you type in,
  515.         use the Caps Lock key if need be.
  516.  
  517.         To exit Init Mode, just press Escape, and you will be returned to
  518.         View Mode.
  519.  
  520.  
  521.        --  Text Search : F4  ------------------------------------------------
  522.  
  523.         You can locate a record by searching for any text in an entry.
  524.         When you press F4, you are placed in Text Mode, and the reverse
  525.         video line in the main records block clears to prompt you to enter
  526.         the text you wish to find.  Text entries can be up to 20 characters
  527.         only.  Any characters are valid for a text search.
  528.  
  529.          ----------------------------------------------------------------
  530.         >|      Search for Text   .                    .                |<
  531.          ----------------------------------------------------------------
  532.  
  533.         Just type what you wish to find then press the Up or Down Arrow key
  534.         to tell PDL in which direction you would like to start the search.
  535.         If the text cannot be found in the designated direction, PDL will
  536.         wrap around to the top or bottom of your file and continue the
  537.         search.  If the text cannot be found, PDL will softly beep at you
  538.         and display the prompt line for new entries.  If a matching record
  539.         is found, the prompt box will clear and the record will be
  540.         highlighted in reverse video, ready to dial by pressing Enter.  If
  541.         the record is not the one you want, continue to press an
  542.         appropriate Arrow key until you find it. If you wish to enter new
  543.         text to find, press the F4 key to restore the prompt line.
  544.  
  545.         Within Text Mode you can also toggle the status of the Case and Log
  546.         keys (F5 and F6 respectively).  The Text Search function is
  547.         affected by the status of the Case key.  When Case is Off, all
  548.         entries are capitalized automatically and the search is not case
  549.         sensitive.  When Case is On, the entries you make are searched for
  550.         literally and the prompt line displays exactly what you type in,
  551.         use the Caps Lock key if need be.
  552.  
  553.         To exit Text Mode, just press Escape, and you will be returned to
  554.         View Mode.
  555.  
  556.  
  557.  
  558.                                                                      Page 11
  559.  
  560.        --  Case Sensitivity : F5  -------------------------------------------
  561.  
  562.         As has already been mentioned in the preceding sections, you can
  563.         toggle the Case Sensitivity of the Initial or Text Search functions
  564.         by toggling the F5 key.
  565.  
  566.         The Status line contains a small indicator block displaying the
  567.         current status of the Case and Log toggles.  The indicator is the
  568.         section between the Clock and Mode displays.  The character on the
  569.         left indicates Case and on the right, the Log function.
  570.  
  571.         |  PDLx  | Dir : c:\pdl\pdl.dir          | 12:36:14 am |.l|  View |
  572.  
  573.         When the Case switch is toggled Off, the block displays a simple
  574.         dot as illustrated above, when On, the letter "c".  The Case switch
  575.         can be toggled from View mode, and when the prompt line is
  576.         displayed in the Initial and Text Modes.  When On, all user input
  577.         will be converted to upper case.
  578.  
  579.  
  580.        --  Dial Number : Enter  ---------------------------------------------
  581.  
  582.         To dial the number displayed in the reverse video bar in the centre
  583.         block, just press the Enter key.  The bar then clears and displays
  584.         the following message.
  585.  
  586.          ----------------------------------------------------------------
  587.         >|      Dialing  756-0711   *   Press Spacebar to Disconnect    |<
  588.          ----------------------------------------------------------------
  589.  
  590.         If an Access Code was entered with the PDLc utility, it will prefix
  591.         the displayed number.  The displayed number will then be sent to
  592.         your modem and you should be able hear your modem dial out.  When
  593.         the number has been sent, just press the Spacebar to disconnect
  594.         your modem.  You do not have to wait for a dial tone or an answer
  595.         on the other end before disconnecting.
  596.  
  597.         If an L.Dist Code was entered in setup, then its value will be
  598.         stripped off of the directory entry you are dialing and the number
  599.         displayed will be the net result.
  600.  
  601.  
  602.        --  Exit PDL : Escape / F10  -----------------------------------------
  603.  
  604.         To exit PDL, just press the Escape key from within View Mode.
  605.  
  606.         If you are using the non-resident version, a prompt line will
  607.         appear asking you to confirm the exit.  Just press the "Y" key to
  608.         confirm, or any other key to ignore the exit and remain in PDL.  If
  609.         you have made changes to your Directory File and have not saved
  610.         them to disk, PDL will prompt you before it exits back to DOS.
  611.         Just type in "Y" to save your current Directory.  Should you find
  612.         the prompted exit to be a bother, you can go directly back to DOS
  613.  
  614.  
  615.  
  616.                                                                      Page 12
  617.  
  618.         by pressing the F10 key from the View Mode.  PDL will prompt you
  619.         only if you have made changes to your file and have not saved them
  620.         to disk.
  621.  
  622.         If you are using the resident version and have made changes to your
  623.         Directory File but have not saved them to disk, PDL will prompt you
  624.         before it exits back to DOS or your underlying application.  Just
  625.         type in "Y" to save your current Directory to disk or "N" if you
  626.         prefer.  If you respond with "N", PDL will prompt you every time
  627.         you escape back to DOS or the underlying application.  In the
  628.         resident version, F10 functions the same as the Escape key.
  629.  
  630.  
  631.        ==  Directory Files  =================================================
  632.  
  633.         Directory Files in PDL are created with the default file extension
  634.         ".DIR".  The Directory file is a straight ASCII text file that must
  635.         be written in a specific format to be loaded directly into PDL.
  636.         The file can be created from within PDL by using the Add function,
  637.         or can be written using any text editor that does Not add any type
  638.         of formatting codes to the text.
  639.  
  640.         If a text editor is used to build the Directory file, then the DIR
  641.         file must be written in the following format.  This format is
  642.         primarily column specific.
  643.  
  644.         FG    FormGen               PDL Tech Support       1-416-857-0022
  645.  
  646.         |     |                     |                                   |
  647.  
  648.         1     7                     34                                 74
  649.  
  650.         * The Initial can be up to 4 characters long, and must start at
  651.           column 1.  It does not have to be capitalized, but this seems to
  652.           make the most sense to me.
  653.  
  654.         * The person or company Name must start at column 7.  The text
  655.           itself can be written with any combination of upper and lower
  656.           case letters.
  657.  
  658.         * The Note can be written with any combination of upper and lower
  659.           case letters.  It does not have to start at column 34, but I have
  660.           found this to be the most convenient place.
  661.  
  662.         * The Number can be any length, but must always end at column 74.
  663.           The number should always be entered as a full dialing prefix and
  664.           area code, particularly if you travel a great deal.
  665.  
  666.         * The Directory File cannot contain more than 800 records (lines)
  667.           for the non-resident version PDLn, or 100 records for the
  668.           resident version PDLr.
  669.  
  670.         For your convenience, a default PDL directory is included to serve
  671.         as a template for your own file.  The file must be written with an
  672.  
  673.  
  674.                                                                      Page 13
  675.  
  676.         ASCII text editor that does not add any format codes to the file or
  677.         from within PDL.  Also, you do not have to write the Directory file
  678.         in alphabetic order, PDL's Edit functions include a Sort option
  679.         that sorts the entries beginning with the Name field at column 7.
  680.  
  681.  
  682.        --  Load Directory File : F2  ----------------------------------------
  683.  
  684.         The Directory File command allows you to load new directory files
  685.         into PDL.  You can create several different files containing
  686.         diverse information, and then pull them into PDL in a flash.
  687.  
  688.         When you press F2, the reverse video line in the main records block
  689.         clears and prompts you to enter a file name.  Only the first part
  690.         of the filename is required, PDL assumes a .DIR extension unless
  691.         you specify otherwise.  PDL also assumes that all directory files
  692.         reside in the directory where PDLN.COM or PDLR.COM reside.
  693.  
  694.         When you have typed in the file name, just press Enter to load the
  695.         directory into PDL.  If the file cannot be found, a brief message
  696.         will be displayed and you will be returned to the prompt to enter
  697.         or edit a name.  You can press Escape to exit the Directory
  698.         function at any time.
  699.  
  700.         As an option, you can also select a directory file from a list of
  701.         choices presented in the lower part of the screen.  If you press
  702.         Enter on an empty prompt field, PDL displays a list of available
  703.         files and highlights the first, as illustrated below.
  704.  
  705.         |  LOG   Logitech U.S.A.                                  1-415-
  706.         | --------------------------------------------------------------
  707.         |>|      Load Directory File  .            .
  708.         | --------------------------------------------------------------
  709.         |  Dir :|pdl.dir     | tst.dir       work.dir
  710.         |        cmp.dir       new.dir
  711.         +---------------------------------------------------------------
  712.  
  713.         You can simply move the highlight with the cursor keys to the
  714.         desired file and press Enter to Load it into PDL.  If you change
  715.         your mind, just press Escape to return to the prompt field.
  716.  
  717.         Should you wish, you can load a file when you invoke PDL by
  718.         including the filename on the command line.  Please see the Command
  719.         Line Options section at the end of this manual.
  720.  
  721.  
  722.        --  Edit Directory File : F7  ----------------------------------------
  723.  
  724.         PDL contains full editing functions to allow you to modify, add or
  725.         delete records from the current Directory file.  These function are
  726.         accessed by pressing F7 from View Mode.  When in Edit Mode, the
  727.         message "Edit" appears in the upper right box on the Status line
  728.         and the current record will appear in the center block or Edit
  729.         Line, ready for editing.
  730.  
  731.  
  732.                                                                      Page 14
  733.  
  734.         |  PDLx  | Dir : c:\pdl\pdl.dir            | 12:36:14 am |.l| Edit  |
  735.         +-------------------------------------------------------------------+
  736.         |  INT   Intuit                   Quicken           1-415-322-2800  |
  737.         |  LOG   Logitech U.S.A.                            1-415-795-8500  |
  738.         | ----------------------------------------------------------------- |
  739.         |>|MCR   Microsoft Canada Ltd.    Sales Office            672-7220|<|
  740.         | ----------------------------------------------------------------- |
  741.         |  MS    MultiScope               Debuggers         1-415-968-4892  |
  742.         |  NAN   Nantucket Corporation    Clipper           1-213-390-7923  |
  743.         +-------------------------------------------------------------------+
  744.           F2:Save  F3:Add  F4:Del  F5:Sort  AltC:Clear  AltR:Rest  Esc: Exit
  745.  
  746.         The functions keys indicated below allow you to access additional
  747.         functions within Edit Mode, and will be discussed in turn below.
  748.  
  749.         At this point, you can modify the currently displayed record as you
  750.         wish.  By default, the editor is in OverType mode, but can be
  751.         toggled to Insert by pressing the Ins key, the cursor will then
  752.         change to a fuller block.  Other key functions available when
  753.         editing are as follows :
  754.  
  755.           Home       :  Move to the beginning (first character) of the line.
  756.           End        :  Move to the end (last character) of the line.
  757.  
  758.           Up         :  Move to next record.
  759.           Down       :  Move to previous record.
  760.  
  761.           PgUp       :  Move up one page (7 records).
  762.           PgDn       :  Move down one page (7 records).
  763.  
  764.           Ctrl Home  :  Move to the first record in the Directory file.
  765.           Ctrl End   :  Move to the last record in the Directory file.
  766.  
  767.           Tab        :  Move to the next default entry column.
  768.  
  769.           Alt C      :  Erase the current contents of the edit line.
  770.  
  771.           Alt R      :  Restore the previous contents of the edit line
  772.                         after a change or the use of the Alt C function.
  773.                         Works only while you remain on the current record.
  774.  
  775.         The Edit function is a simple line editor, therefore the Edit Line
  776.         is the only active window onto the Directory File.  When scrolling
  777.         through a Directory, the full screen will update to show you the
  778.         effect of your changes.  Any changes you make are automatically
  779.         written to the Directory File in memory without any confirmation
  780.         step on your part.
  781.  
  782.         In Edit Mode, function keys provide these additional features :
  783.  
  784.           F2 :  Save the current Directory file to disk.  When making
  785.                 changes, you are only modifying records currently held in
  786.                 memory.  Use the F2 key to write your changes to disk.  If
  787.                 you forget to save your changes, you will be prompted when
  788.                 you try to exit back to DOS.
  789.  
  790.  
  791.                                                                      Page 15
  792.  
  793.          F3  :  Add a new record to the current Directory.  The Edit Line
  794.                 will clear, Add will insert a new blank record above the
  795.                 displayed record, and the cursor will move to the extreme
  796.                 left.  Type in whatever you want and then press any other
  797.                 function or movement key to continue.  If you leave the new
  798.                 record blank, Add will remove it from the Directory when
  799.                 you press any other operation key.
  800.  
  801.           F4 :  Delete the current record.  This function will remove a
  802.                 record from the Directory, and will NOT prompt for any
  803.                 confirmation before doing so.  Please be careful !  Once
  804.                 again, you will only be modifying the contents of memory,
  805.                 so the original record can be restored by reloading the
  806.                 Directory File.  You can not use the Delete function to
  807.                 remove a record in a file containing only one record, PDL
  808.                 will sound an error tone in this instance.
  809.  
  810.           F5 :  Sort the current Directory File.  The Sort function sorts
  811.                 the File starting with the Name string at column 7, NOT the
  812.                 Initial at column 1.
  813.  
  814.         When you have finished making any modifications, we strongly
  815.         suggest you use the F2 Save function before you exit.  You can exit
  816.         to View Mode at any time by pressing the Escape key.  If any
  817.         records have been changed and you try to exit PDL back to DOS or
  818.         your underlying application, you will be prompted to Save to Disk
  819.         unless you have already used the F2 function.
  820.  
  821.  
  822.        ==  Log Files  =======================================================
  823.  
  824.         PDL allows you to Log your calls to a text file for business
  825.         purposes.  You can also specify which type of calls will be
  826.         captured to the Log from within the Config section of the program.
  827.         When the Log function is toggled On via the F6 key, any calls of
  828.         the type specified will be sent to a file called PDL.LOG in the
  829.         directory where PDLx resides.
  830.  
  831.         The Log file is a straight ASCII text file in the following format
  832.  
  833.                   Name              Number        Date      Time     Dir.
  834.         ----------------------- -------------- ---------- -------- ---------
  835.          Burton Systems Softwa  1-919-233-8128 12-20-1990 16:19:44 pdl
  836.          American Cybernetics   1-602-968-1945 12-27-1990 16:55:36 pdl
  837.          Ein Stein's Computers  1-916-671-7444 01-07-1991 19:34:01 pdl
  838.  
  839.         The items comprising the file should, needless to say, be quite
  840.         clear from this fragment.  The Time column is only the start of the
  841.         call, not the calls duration, and the Dir column is the name of the
  842.         Directory file loaded at the time of the call.
  843.  
  844.         If the Log function is activated and no Log file currently exists,
  845.         then one will be created the first time you dial a number.  Calls
  846.  
  847.  
  848.  
  849.                                                                      Page 16
  850.  
  851.         will be posted to the Log only when the Log switch is toggled On,
  852.         allowing you to turn the feature Off for a specific call that
  853.         matches the type of call selected in Config that you don't want to
  854.         post.  The Log file can be cleaned up or edited at any time with a
  855.         text editor that does not add format codes.  If you wish to include
  856.         fragments in a word processed document, I suggest you copy the
  857.         PDL.LOG file to another name before dumping it into your word
  858.         processor.
  859.  
  860.  
  861.        --  Log File Toggle : F6  --------------------------------------------
  862.  
  863.         The Status line contains a small indicator block displaying the
  864.         current status of the Case and Log toggles.  The indicator is the
  865.         section between the Clock and Mode displays.  The character on the
  866.         left indicates Case and on the right, the Log function.
  867.  
  868.         |  PDLx  | Dir : c:\pdl\pdl.dir          | 12:36:14 am |c.|  View |
  869.  
  870.         When the Log switch is toggled Off, the block displays a simple dot
  871.         as illustrated above, when On, the letter "l".  The Log switch can
  872.         be toggled from View mode, and when the prompt line is displayed in
  873.         the Initial and Text Modes.  As was mentioned in the previous
  874.         section, you can turn the Log function Off if you don't wish to
  875.         post a certain call and then back On again afterward.  The F6 Log
  876.         switch is completely independent of the Log Type selection set with
  877.         PDLc.
  878.  
  879.  
  880.        ==  Long Distance Codes etc.. ========================================
  881.  
  882.         Phone numbers in PDL should always be entered with their full
  883.         dialing prefix and area code.  By so doing, you will never have to
  884.         edit your directory files to suit your geographic location; all you
  885.         would need to do is modify the L.Dist Code in PDLc to reflect the
  886.         change, and what were once long distance numbers would be
  887.         automatically converted into local calls.
  888.  
  889.         This can be very useful to those of you who travel a great deal,
  890.         making PDL ideal for a laptop system.  The Call logging function is
  891.         not affected by any change to the L.Dist Code, the Log function
  892.         bases its actions on the number actually dialed, not the number
  893.         stored in your directory file.
  894.  
  895.         If you live in a rural area, you very often have to add "1-" to an
  896.         eight digit phone number.  To preserve the "1-" and just extract
  897.         the area code from a directory entry, merely enter the area code
  898.         itself in the L.Dist Code field.  For example, if you live in area
  899.         code 416 and all numbers are entered in your directory in the
  900.         format "1-xxx-xxx.xxxx", then the L.Dist Code would have to be "416".
  901.         When the number is dialed, the "416" and the "-" following it are
  902.         stripped off to create a local number with the "1-" prefix, ie
  903.         "1-xxx.xxxx".
  904.  
  905.  
  906.  
  907.                                                                      Page 17
  908.  
  909.        ==  System Time Display  =============================================
  910.  
  911.         The System Time Display is a very useful addition to PDL, but can
  912.         present problems with certain software setups.  The Time function
  913.         grabs the timer interrupt in order to continuously display the
  914.         clock.  This interrupt can however, have already been grabbed by
  915.         another application which will usually cause your system to crash.
  916.         The worst offenders in this regard are memory resident programs
  917.         like Sidekick from Borland International.  If Sidekick is resident
  918.         when you load PDL with the Time Display switched On, your system
  919.         will go down for sure.
  920.  
  921.         To help this problem, PDL contains a command line switch to toggle
  922.         the status of the System Time Display.  By default, PDL turns the
  923.         Time Display On the first time you load it (unless you have toggled
  924.         it Off within the PDLc utility).  If there is a clash with another
  925.         program, then PDL will most likely cause a system crash.  Just
  926.         reboot your machine and start PDL again with the command line :
  927.  
  928.                                        PDLx /t
  929.  
  930.         This will toggle the Time Display Off.  You should then use PDLc to
  931.         toggle the Sys.Time switch Off permanently.
  932.  
  933.  
  934.        ==  Command Line Options  ============================================
  935.  
  936.         You can, in addition to the Config Options discussed above, direct
  937.         some of PDL's actions from the DOS command line.  These choices are
  938.         entered as parameters after the "PDLx" program name, and are
  939.         separated by a forward slash (/).  You do not need to enter spaces
  940.         between parameters, but the separator is essential.  Parameters are
  941.         case insensitive.
  942.  
  943.         The syntax for the command line is :
  944.  
  945.                                PDLx filename /option /option
  946.  
  947.         Please note that the status of these switches are Not preserved by
  948.         PDL when you exit the program.  They must be added to the command
  949.         line when you run either version of PDL.
  950.  
  951.         file :  Should you wish to load a different Directory file when you
  952.                 start PDL , then specify the filename on the command line.
  953.                 If the file has the default extension "DIR" then an
  954.                 extension need not be added.  When you specify a file, the
  955.                 first record in the new Directory file will be displayed.
  956.  
  957.                 If the filename you type on the command line is invalid
  958.                 under the rules of DOS (8.3 characters) then PDL will
  959.                 assign the filename 'NEW.DIR" as a default.  This file will
  960.                 not exist on disk until you save it from PDL.
  961.  
  962.  
  963.  
  964.                                                                      Page 18
  965.  
  966.                 The file command line option can also be used to create a
  967.                 new directory file from scratch.  Just start PDL with the
  968.                 filename you wish to use, build the contents from within
  969.                 Edit Mode, and then save it to disk.
  970.  
  971.         /b   :  This switch forces PDL to load default monochrome colour
  972.                 values, regardless of the type of monitor in use.  This can
  973.                 be most useful if you are using a two colour monitor with a
  974.                 CGA or EGA card.  The multiple colour defaults may result
  975.                 in a display that is somewhat difficult to read.  If these
  976.                 monochrome values work better on your display hardware,
  977.                 then configure them with PDLc to avoid having to use the /b
  978.                 switch every time you start up.
  979.  
  980.         /t   :  Please see the previous section for a complete discussion
  981.                 of the /t switch.
  982.  
  983.         /u   :  Unload the PDLr dialer from memory.  If you do not have
  984.                 another TSR program in memory after PDLr then the message
  985.                 "PDLr Unloaded" will appear.  If PDL finds another program
  986.                 in memory after itself then the message "Unable to Unload
  987.                 PDLr" will appear and PDL will remain in memory.  Dump any
  988.                 memory resident programs after PDL and try again.  If you
  989.                 try to uninstall PDL when it is not loaded then the message
  990.                 "PDLr is Not Resident" will appear.
  991.  
  992.         /? /h   Either the /? or /h switch will display a brief list of the
  993.                 command line switches and not run PDL.
  994.  
  995.  
  996.        ==  PDL Registration =================================================
  997.  
  998.         By registering, you will have a printed manual with more detailed
  999.         information, an update of the program including any new features,
  1000.         and a clear conscience.
  1001.  
  1002.         The registration is a very reasonable price that helps me to make a
  1003.         living and to continue to maintain and improve the program.  If you
  1004.         do not register, but continue to benefit from the use of my program,
  1005.         you are clearly violating the terms of my copyright.
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.   +-----------------------------------------------------------------------------+
  1012.   |   Please register me as a PDL User!  RUSH my manual and update ASAP!        |
  1013.   |   Here's my $25 registration fee.                                           |
  1014.   |                                            Please charge my credit card:    |
  1015.   |  -----------------------------------                                        |
  1016.   | | Name:                             |       ------------------------------- |
  1017.   | |-----------------------------------| VISA |       |       |       |       ||
  1018.   | | Company:                          |      |-+-+-+-|-+-+-+-|-+-+-+-|-+-+-+-||
  1019.   | |-----------------------------------| MC   |       |       |       |       ||
  1020.   | | Address:                          |      |-+-+-+-|-+-+-+-|-+-+-+-|-+-+-+- |
  1021.   | |-----------------------------------| AMEX |       |           |         |  |
  1022.   | | City:                 State:      |       -+-+-+-|-+-+-+-+-+-+-+-+-+-+-   |
  1023.   | |-----------------------------------|          -------                      |
  1024.   | | Zip:                              | Expires |   |   |                     |
  1025.   |  -----------------------------------           -+-+-+-                      |
  1026.   |                                                                             |
  1027.   |  mail check or credit card info to:                                         |
  1028.   |                                                                             |
  1029.   |     Steven Hawkins             For faster service:                          |
  1030.   |     c/o FormGen Corporation                                                 |
  1031.   |     13 Holland Drive               in the US order toll free (800) 263-2390 |
  1032.   |     Bolton, Ontario                         Canada & foreign (416) 857-4141 |
  1033.   |     L7E 1G4                    Questions & Technical Support (416) 857-0022 |
  1034.   |                                                          FAX (416) 857-4531 |
  1035.   +-----------------------------------------------------------------------------+
  1036.  
  1037.  
  1038.