home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / procomm / pcpreorg.arc / PCPREORG.DOC < prev    next >
Text File  |  1989-03-24  |  19KB  |  530 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                    Charity-Ware
  10.                                   PCP-REORG v1.00
  11.  
  12.    A program to reorder entries in a PROCOMM (R) PLUS dialing directory.
  13.    PROCOMM PLUS is a trademark of Datastorm Technologies, Inc.
  14.    My sincere thanks go to the executives at Datastorm Technologies, Inc. who
  15.    gave their kind permission for me to copy the "look and feel" of ProComm+'s
  16.    dialing directory screen for this charitable purpose.
  17.  
  18.    PCP-REORG enables the user to reorder the entries in a PROCOMM PLUS dialing
  19.    directory.  Individual entries may be moved to new positions within the
  20.    directory.  Entries can be inserted, deleted, and erased.  The entire
  21.    directory can be compressed to move all useful entries to the front.
  22.  
  23.    I seek no remuneration for myself.  However, if you find yourself using this
  24.    program regularly, or just really appreciate it, please consider sending a
  25.    $9 or greater, tax-deductible donation to:
  26.                         Recording for the Blind, Inc.--CT Unit
  27.                         Bandes Fund
  28.                         1 Science Park
  29.                         New Haven, Conn.  06511
  30.    If you use the program regularly you are ethically bound to contribute.  To
  31.    keep your donation tax-deductible, the license for program use is free as
  32.    long as the terms of the license (described on the copyright screen) are
  33.    met.  But your donation will be sincerely appreciated by 24,000 print-
  34.    handicapped students, 4,000 volunteers, and the employees of Recording for
  35.    the Blind. Also, I'll get a kick out of seeing the donations grow, and I'll
  36.    be encouraged to write more Charity-Ware.
  37.  
  38.  
  39.  
  40.    Registration
  41.    ------------
  42.  
  43.    In return for your donation and registration, I will provide you with one
  44.    year of support via FidoNet for free.  Suggestions are welcome from all. 
  45.    Register in one of three ways.  You can enclose a note to me with your
  46.    donation; Recording For the Blind will see that I get it.  Just fold the
  47.    note and write my name on it, or enclose it in an inner envelope with my
  48.    name on it.  Alternatively, send me a message via FidoNet.  My IDs are:
  49.                   Ron Bandes 1:141/245
  50.                or Ron Bandes 1:141/250
  51.    The third way is to mail me your registration in a separate envelope from
  52.    your donation.
  53.                   Ron Bandes
  54.                   25 Meadow Lane
  55.                   New Canaan, CT 06840
  56.    Do not mail donations to me; please send them directly to Recording For the
  57.    Blind--CT Unit.
  58.  
  59.  
  60.  
  61.  
  62.    Copyright (c) 1989 Ronald M. Bandes     All Rights Reserved
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.    I think it will work out best to just enclose a note with your donation.  To
  76.    register, include in the note your:
  77.                   Name
  78.                   Postal address
  79.                   FidoNet ID (if you have one)
  80.                   Serial # of the copy of PCP-Reorg you now possess.
  81.  
  82.  
  83.  
  84.    Starting PCP-Reorg
  85.    ------------------
  86.  
  87.    Command format:  PCPREORG <dialing-directory-file-name> /B /H
  88.  
  89.    Where <dialing-directory-file-name> is the DOS file name of the initial
  90.    dialing directory you wish to reorganize.  If the file extension is .DIR, it
  91.    may be omitted.  The file will be searched for first in the current DOS
  92.    subdirectory, and second in the subdirectory specified by the SET PCPLUS=
  93.    Path command you have probably issued in your AUTOEXEC.BAT for ProComm+.
  94.  
  95.    The /B option indicates that PCP-Reorg should produce Black & White screen
  96.    output.  You will probably never need to use this option.  If you are using
  97.    a monochrome adapter, or a monochrome monitor on an EGA, PCP-Reorg will
  98.    automatically use black & white.  With other configurations, PCP-Reorg will
  99.    examine the PCPLUS.PRM file (searching as with the dialing directory) and
  100.    obtain the colors of the dialing directory window.  If PCPLUS.PRM can't be
  101.    found then the same defaults as ProComm+, white and light cyan on blue, will
  102.    be used.  If you are using a black & white composite monitor on a color
  103.    adapter, your configuration cannot be determined directly by software; if
  104.    you have previously started ProComm+ with its /B option, and saved that
  105.    setup, then PCP-Reorg will know to use black & white without being told by
  106.    you.
  107.  
  108.    The /H option displays the help file before displaying the copyright screen.
  109.  
  110.  
  111.  
  112.    Commands
  113.    --------
  114.  
  115.    Commands are issued with a single keystroke.  Some are letters, some are
  116.    cursor movement keys.  Some commands prompt you for additional information: 
  117.    the Find command prompts for a find-string, the GoTo command for a line
  118.    number, and the Delete command for a Y/N response to a precautionary prompt
  119.    (some other commands prompt also).  Pressing the Esc key in response to any
  120.    prompt cancels the command with no effect.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.    Copyright (c) 1989 Ronald M. Bandes     All Rights Reserved
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.    Moving Directory Entries
  142.    ------------------------
  143.  
  144.    To move an entry from one position in the dialing directory to another,
  145.    first select the entry you wish to move.  This is done by positioning the
  146.    reverse-video cursor-bar on the entry you are selecting, and pressing the
  147.    space bar.  Positioning can be accomplished in many ways which will be
  148.    described, but for now let's assume you have used the Up and Down Arrows.
  149.    Pressing the space bar selects the entry at the cursor bar, and selection is
  150.    indicated by the entry blinking.  Next position the cursor-bar to the entry
  151.    line you wish the selected item be moved to.  Press Enter, and the move will
  152.    be completed.
  153.  
  154.    The entry at the destination line, and the entries between the selected
  155.    entry and the destination, will be shifted toward the selected entry's
  156.    original position.  This means that if you are moving an entry UP, shifting
  157.    will be down, and the selected entry will appear BEFORE the entry which
  158.    previously occupied the destination line.  If you are moving an entry DOWN,
  159.    shifting will be up, and the selected entry will appear AFTER the entry
  160.    which formerly occupied the destination line.  What is consistent is that
  161.    the selected entry will always occupy the destination line after the move.
  162.  
  163.  
  164.  
  165.    Moving Several Adjacent (or close) Entries
  166.    ------------------------------------------
  167.  
  168.    There is no facility for marking a range of entries for moving.  However,
  169.    after a move the default line for the GoTo command is where the moved line
  170.    came from.  So by issuing the GoTo command and accepting the default line
  171.    number with the Enter key, you can go back and select another entry that was
  172.    formerly adjacent to the moved entry.  After selection, you can go back to
  173.    where the last GoTo command came from by once again issuing the GoTo command
  174.    with the default line number, which will take you back to where the
  175.    previously moved entry had been moved to.  Press Enter to complete the move. 
  176.    Repeat the process as necessary.
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.    Copyright (c) 1989 Ronald M. Bandes     All Rights Reserved
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.    Positioning the Cursor-Bar
  208.    --------------------------
  209.  
  210.    The cursor-bar may be positioned in the following ways:
  211.  
  212.            Up and Down Arrows  :  moves the cursor-bar one entry.
  213.            PgUp and PgDn       :  displays the prior/next 10 entries.
  214.            Ctrl PgUp, Ctrl PgDn:  display first/last 10 lines of directory.
  215.            Home, End           :  moves to first/last filled-in entry.
  216.            Go To command       :  positions cursor-bar to numbered entry, or to
  217.                                   position prior to last Move, Find, Again, or
  218.                                   Goto.
  219.            Find                :  case-insensitive search for Name/Phone.
  220.            Again               :  continues searching for same string.
  221.  
  222.  
  223.  
  224.    Un-Selecting an Entry
  225.    ---------------------
  226.  
  227.    If you decide not to move the selected entry after all, press C (Clear
  228.    command) while positioned anywhere.  Alternatively, press the Space bar
  229.    while the cursor-bar is positioned on the selected entry.
  230.  
  231.  
  232.  
  233.    Compressing the Directory
  234.    -------------------------
  235.  
  236.    Empty entries interspersed with filled-in entries can be deleted with a
  237.    single keystroke.  Press K (Compress command) and those entries will
  238.    disappear.  All filled-in entries will be moved to the first lines in the
  239.    directory.  All the empty entries after the last filled-in entry will be
  240.    reset to default values.  See the Erase command for determining what the
  241.    defaults are.  An entry is considered empty if the Name, Phone, and Script
  242.    fields are empty.
  243.  
  244.  
  245.  
  246.    Erasing an Entry
  247.    ----------------
  248.  
  249.    To erase the entry at the cursor-bar, press E (Erase command).  Values will
  250.    be reset to defaults.  Unlike ProComm+ 1.1B, which erases to fixed values
  251.    (1200 bps, No parity, 8 data bits, 1 stop bit, full duplex, ANSI terminal,
  252.    and XModem protocol), PCP-Reorg resets the entry to the defaults found in
  253.    PCPLUS.PRM as you specified them with ProComm+'s Port Setup and with its
  254.    Setup facility Terminal Options.  Since there is no default protocol in the
  255.    Setup facility, and since you will be prompted for one whenever you up/down-
  256.    load, it will be set to None.  If PCPLUS.PRM can't be found then the same
  257.    defaults as ProComm+, except for protocol, will be used.
  258.  
  259.  
  260.    Copyright (c) 1989 Ronald M. Bandes     All Rights Reserved
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.    Erasing an entry also allows you to specify a Name to be put into the erased
  274.    entry.  Because PCP-Reorg has no facility for revising an entry, it is
  275.    useful to enter a Name into an erased entry for two reasons:  one, it will
  276.    serve as a reminder of what you want in that entry when you use ProComm+ to
  277.    revise the entry; and two, the name will prevent the Compress command from
  278.    deleting the entry.  If no name is desired, just press Enter when prompted.
  279.  
  280.  
  281.  
  282.    Deleting an Entry
  283.    -----------------
  284.  
  285.    The entry at the cursor-bar may be deleted with the Del key.  If the entry
  286.    is not empty, you will be asked to verify the operation.
  287.  
  288.  
  289.  
  290.    Inserting an Entry
  291.    ------------------
  292.  
  293.    A new entry may be inserted between two adjacent lines by pressing the Ins
  294.    key.  Like the Erase command, you will be prompted for a Name.  The entry at
  295.    the line containing the cursor-bar and all the lines down to and including
  296.    the last filled-in entry will be shifted down to make room for the new
  297.    entry.
  298.  
  299.  
  300.  
  301.    Finding an Entry
  302.    ----------------
  303.  
  304.    The F key (Find command) or slash key (/) will search from the current line
  305.    to the end of the directory and back around to the line preceeding the
  306.    starting point.  You will be prompted for a search string.  The Name and
  307.    Phone fields will be examined for the string you provide.  If found, the
  308.    entry containing the string becomes the current entry, and the cursor-bar
  309.    will be positioned on it.  The A key (Again command) will search for an
  310.    additional occurence of the same string without prompting.
  311.  
  312.  
  313.  
  314.    Saving Changes
  315.    --------------
  316.  
  317.    Changes made on the screen are not immediately made to the dialing directory
  318.    file on disk.  When exiting the program or changing to (eXchanging) another
  319.    dialing directory, you will be asked whether or not to save the changes you
  320.    have made (if you made any).  You may also save changes while remaining with
  321.    the same dialing directory using the S key (Save command).  It is advisable
  322.    to do this periodically if you are making voluminous changes in one session.
  323.  
  324.    Your dialing directory will be backed up to PCPDIR.OLD (the same name
  325.  
  326.    Copyright (c) 1989 Ronald M. Bandes     All Rights Reserved
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.    SORTDIR uses) in the same subdirectory as your dialing directory before
  340.    replacing the dialing directory.  The temporary file name PCPDIR.NEW is also
  341.    used, and any existing file by that name will be deleted summarily.
  342.  
  343.  
  344.  
  345.    Effect of Changes on Script Files
  346.    ---------------------------------
  347.  
  348.    Changes to the dialing directory may necessitate updating ASPECT script
  349.    files which use the Dial script command.  The Dial command refers to a
  350.    dialing directory entry by its line number in the directory.  These numbers
  351.    will probably be affected by your changes made with PCP-Reorg.
  352.  
  353.  
  354.  
  355.    Loading a New Directory
  356.    -----------------------
  357.  
  358.    A new dialing directory can be loaded with the X key (eXchange command).  If
  359.    changes were made to the old one, you will be prompted whether or not to
  360.    save the changes.  In any case you will be prompted for the name of the new
  361.    dialing directory.  As on the PCP-Reorg command line at the DOS prompt, you
  362.    may omit the file extension if it is .DIR .  You may specify a device and
  363.    path in normal DOS fashion.  The search for the file is as with the initial
  364.    dialing directory.  Pressing just Enter indicates the default directory,
  365.    PCPLUS.PRM, 
  366.  
  367.  
  368.  
  369.    Printing the Directory
  370.    ----------------------
  371.  
  372.    The L key (List or Print command) can be used to print the directory loaded
  373.    into the program as it appears on the screen.  Only the fields which appear
  374.    on the screen will appear in the listing.  The last entry printed will be
  375.    the last filled-in entry.
  376.  
  377.  
  378.  
  379.    Exiting PCP-Reorg
  380.    -----------------
  381.  
  382.    The safest way to exit is with the Esc key (or Alt X) when no prompt window
  383.    is showing.  If changes have been made, you will be asked whether or not to
  384.    save them.  You may exit without saving changes and circumvent the
  385.    precautionary prompt by pressing Ctrl Q instead of Esc.  You may ensure that
  386.    changes are saved while circumventing the precautionary prompt by pressing
  387.    Alt S.
  388.  
  389.  
  390.  
  391.  
  392.    Copyright (c) 1989 Ronald M. Bandes     All Rights Reserved
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.    Installing PCP-Reorg
  406.    --------------------
  407.  
  408.    All that is necessary to install PCP-Reorg is to put the PCPREORG.HLP file
  409.    in the same subdirectory as ProComm+.  Since you have probably put a SET
  410.    PCPLUS=Path command into AUTOEXEC.BAT when you installed ProComm+, PCP-Reorg
  411.    will also be able to find its help file.  If the help file can't be found,
  412.    there are no deleterious effects other than no help information can be
  413.    displayed.  If you put PCPREORG.COM in a subdirectory specified in your
  414.    AUTOEXEC.BAT's PATH command (such as ProComm+'s subdirectory), you will be
  415.    able to invoke PCP-Reorg without regard to the current subdirectory.
  416.  
  417.  
  418.  
  419.    Running PCP-Reorg within ProComm+
  420.    ---------------------------------
  421.  
  422.    You may run PCP-Reorg within ProComm+, but there is one consideration and
  423.    you must USE THE UTMOST CAUTION TO REMEMBER THE ONE CRUCIAL STEP.  The
  424.    consideration is that if with ProComm+ you have Revised entries for just
  425.    this session and not saved them to disk, you will lose those revisions.  The
  426.    CRUCIAL step is if you saved changes with PCP-Reorg in the same dialing
  427.    directory as is loaded into ProComm+, then upon returning to ProComm+ you
  428.    must display the directory with Alt-D and reload the directory with the
  429.    eXchange (X key) function.  Don't put this step off just because you may be
  430.    on-line and time's a wastin'; you'll regret it.
  431.  
  432.    There are three ways to run PCP-Reorg within ProComm+.  The way requiring no
  433.    setup is really the most sensible way.  From ProComm+'s terminal or main
  434.    help screen just press Alt-F4 to open the DOS window and enter the PCPREORG
  435.    command.  Enter EXIT when PCP-Reorg returns to DOS.  Remember the crucial
  436.    step from the first paragragh of this section.
  437.  
  438.    If you always use only one dialing directory, you can install PCP-Reorg on a
  439.    hot key.  If it is the default directory, PCPLUS, install the name PCPREORG. 
  440.    If it's another directory, put the PCPREORG command in a .BAT file, and
  441.    install the .BAT file name on the hot key.  PCP-Reorg and the .BAT file
  442.    should be placed in ProComm+'s subdirectory.  Then to invoke PCP-Reorg, just
  443.    press the hot key.  When you return to ProComm+, REMEMBER THE CRUCIAL STEP.
  444.  
  445.    If you aren't using all three external protocols already, this is a good (if
  446.    slightly unorthodox) way to have ProComm+ prompt you for parameters before
  447.    invoking PCP-Reorg.  In ProComm+'s setup facility on the Protocol Options
  448.    screen, choose an unused external protocol.  If, for example, you chose
  449.    External Protocol 3 Upload Filename, then press E to update that one, and
  450.    enter PCPREORG or the name of a .BAT file containing it.  If you use a .BAT
  451.    file, be sure it passes parameters to PCP-Reorg.  PCP-Reorg and the .BAT
  452.    file should be placed in ProComm+'s subdirectory.  Now to run PCP-Reorg
  453.    press the PgUp (Upload) or PgDn (Download) key depending on which entry you
  454.    chose (for the example press PgUp).  You will see PCPREORG or the .BAT file
  455.    name in entry 14, 15, or 16 depending on which entry you chose (16 in the
  456.    example).  Type that number and press Enter.  You will be prompted for
  457.  
  458.    Copyright (c) 1989 Ronald M. Bandes     All Rights Reserved
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.    parameters, which could include the name of the dialing directory; just
  472.    press Enter to take the default, PCPLUS.  When you return to ProComm+,
  473.    REMEMBER THE CRUCIAL STEP.  Also remember the next time you Upload/Download
  474.    (whichever) that your default "protocol" is now PCPREORG and must be
  475.    overridden by typing the number of the desired protocol.
  476.  
  477.  
  478.  
  479.    Running with ProComm Plus Test Drive
  480.    ------------------------------------
  481.  
  482.    No special provision was made for running with ProComm+ Test Drive.  If you
  483.    are using a version which calls the default directory PCPLUSTD.DIR and which
  484.    calls the parameter file PCPLUSTD.PRM, you may do the following.  If you
  485.    wish PCP-Reorg to use information from the parameter file (such as screen
  486.    colors and defaults for Erase, Insert, and Compress), copy PCPLUSTD.PRM to a
  487.    file called PCPLUS.PRM.  To select PCPLUSTD.DIR as the initial dialing
  488.    directory to reorganize, just specify PCPLUSTD on the PCPREORG command line.
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.    Copyright (c) 1989 Ronald M. Bandes     All Rights Reserved
  525.  
  526.  
  527.  
  528.  
  529.  
  530.