home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / procomm / poe.arc / POE.DOC < prev    next >
Encoding:
Text File  |  1987-07-23  |  9.3 KB  |  223 lines
  1.                           ProComm Outside Environment
  2.                                    POE 1.0.0
  3.                                 July 22nd, 1987
  4.  
  5.                       Copyright (c) 1987 by Mark Herring
  6.                          Donated to the Public Domain
  7.  
  8.  
  9.  
  10.          Before we get started...
  11.  
  12.                 I, Mark  Herring,  have  donated  POE  to  the  Public
  13.                 Domain.   This  means that you may make as many copies
  14.                 of POE as you wish, and that you may give POE to  your
  15.                 friends.
  16.  
  17.                 I  COULD  have  made POE a shareware product, but many
  18.                 factors contributed  to  my  decision  to  donate  the
  19.                 system to the Public Domain:
  20.  
  21.                         If  I  requested  a  registration  fee, then I
  22.                         would HAVE to  support  my  registered  users.
  23.                         Since  it cost  you nothing to acquire POE, I
  24.                         feel no obligation to SUPPORT it.  If you have
  25.                         problems  with  the  system,  you'll  find   a
  26.                         telephone  number  at  the  end  of  this file
  27.                         telling you how  to  leave  messages  for  me.
  28.                         If  you  send me  a message  via  one of these
  29.                         systems, I'll send you back a reply.
  30.  
  31.                         I have seen many programs that  were  released
  32.                         as  shareware that wouldn't be worth the phone
  33.                         bill it took to download them.   Some  systems
  34.                         have been obviously written in only hours, and
  35.                         people  expect others to send them money for a
  36.                         "shoddy" job.  If a  package  is  released  as
  37.                         Shareware,   the  authors  should  take  their
  38.                         system as seriously as  if  it  were  sold  by
  39.                         Microsoft!   There  are many systems out there
  40.                         that  qualify  for   Shareware   (ProComm   is
  41.                         certainly one), while there are many more that
  42.                         give the name a black eye.
  43.  
  44.                         Finally, if I don't accept money, I also don't
  45.                         accept any responsibility  for  what  POE  may
  46.                         ever  do  to  your  system.  It's been checked
  47.                         for problems, and up until now, none have been
  48.                         found.  However, if POE chokes on  your  cache
  49.                         and destroys your FAT table, don't come crying
  50.                         to me!  Caveat Empetor!
  51.  
  52.  
  53.  
  54.                 What is POE?
  55.  
  56.                 POE is a utility that will let you add  external  file
  57.                 protocols  to  ProComm or any other telecommunications
  58.                 system.    POE  will  also  allow  you to run up to 15
  59.                 different programs from inside ProComm.   POE.EXE  and
  60.                 POE.CFG  should reside in your ProComm subdirectory.
  61.  
  62.                 Let's    face...everyone    has   their  own  favorite 
  63.                 communications  system.  I  believe that ProComm beats 
  64.                 all of the others hands down,  except when it came  to 
  65.                 the   newer   "external"   protocols  that  are  being 
  66.                 developed.  Since I refuse  to  change  to  one  other 
  67.                 "inferior"  communication  programs  out there just to 
  68.                 pickup a new protocol,  I wrote POE so I could  easily 
  69.                 call them up with a ProComm-styled interface.  I could 
  70.                 just   as  easily  dropped  to  DOS  and  execute  the 
  71.                 protocols,  but I'm a consultant  by  trade,  and  all 
  72.                 programmers are lazy to begin with!  Hence,  I created 
  73.                 POE.  Now, ProComm has it all! 
  74.  
  75.                 POE  is  designed  to  "hook" into ProComm through the
  76.                 ALT-A command.  Datastorm  Technologies  designed  the
  77.                 ALT-A  command to interface with your favorite editor.
  78.                 We use this key to call up POE instead.
  79.  
  80.                 Before you can call  up  POE  using  ALT-A,  you  must
  81.                 reconfigure  ProComm to execute POE.  Here's how to do
  82.                 this:
  83.  
  84.                 1. Execute ProComm.
  85.                 2. Press the ALT-S key combination.
  86.                 3. Select option #4 from the menu...GENERAL SETUP.
  87.                 4. Select option #1 from the GENERAL SETUP menu.
  88.                 5. Type POE and press Return.
  89.                 6. Press the [ESC] key.
  90.                 7. Press the [S] key.
  91.                 8. Press the [ESC] key.
  92.  
  93.                 There!  If POE is sitting in  your  ProComm  directory
  94.                 (and  assuming  that you are too), then pressing ALT-A
  95.                 will call up POE!
  96.  
  97.  
  98.  
  99.                 Configuring POE.
  100.  
  101.                 POE.EXE  is  distributed  with  POE.CFG  and  DSZ.EXE.
  102.                 POE.CFG is a configuration file that  tells  POE  what
  103.                 transfer  protocols  are available.  POE understands a
  104.                 few commands that reside inside the POE.CFG file:
  105.  
  106.  
  107.                 COLOR
  108.  
  109.                         The COLOR command allows  you  to  change  the
  110.                         colors that POE displays on the screen.
  111.  
  112.                         Format: COLOR {old color no}={new color no}
  113.  
  114.                         Color numbers   Description
  115.                         -------------   -----------
  116.                               0         Black
  117.                               1         Blue
  118.                               2         Green
  119.                               3         Cyan
  120.                               4         Red
  121.                               5         Magenta
  122.                               6         Yellow
  123.                               7         White
  124.  
  125.  
  126.                 UP PATH=path name
  127.  
  128.                         This command will set the upload path.
  129.                         Example: UP PATH=C:\TERM\UP
  130.  
  131.                 DL PATH=path name
  132.  
  133.                         This command will set the download path.
  134.                         Example: DL PATH=C:\TERM\DL
  135.  
  136.                 MS PATH=path name
  137.  
  138.                         This command will set the path for your
  139.                         miscellaneous programs.
  140.                         Example: MS PATH=C:\PROGRAMS
  141.  
  142.  
  143.                 UP PROTOCOL=protocol description,command[,path name]
  144.  
  145.                         UP  PROTOCOL  describes  an upload protocol to
  146.                         POE.  Example:
  147.  
  148.                         UP PROTOCOL=Zmodem upload,DSZ sz !
  149.  
  150.                         The ! at the end of the command tells  POE  to
  151.                         ask   for   additional  parameters  when  this
  152.                         protocol is selected.
  153.  
  154.                         You may  also  append  a  path  name  that  is
  155.                         special  to  this one protocol.  If you do use
  156.                         a path name, it overrides any path  name  that
  157.                         was setup with UP PATH=.
  158.  
  159.  
  160.                 DL PROTOCOL=protocol description,command[,path name]
  161.  
  162.                         DL  PROTOCOL  describes a download protocol to
  163.                         POE.  Example:
  164.  
  165.                         DL PROTOCOL=Zmodem download,DSZ rz !
  166.  
  167.                         The ! at the end of the command tells  POE  to
  168.                         ask   for   additional  parameters  when  this
  169.                         protocol is selected.
  170.  
  171.                         You may  also  append  a  path  name  that  is
  172.                         special  to  this one protocol.  If you do use
  173.                         a path name, it overrides any path  name  that
  174.                         was setup with UP PATH=.
  175.  
  176.  
  177.                 MISC=Program description,command,[path name]
  178.  
  179.                         POE can also run external programs outside  of
  180.                         ProComm.   The  MISC=  command describes these
  181.                         programs.  For example:
  182.  
  183.                         MISC=Directory management,DR,C:\
  184.  
  185.                         Notice that this command also  uses  the  path
  186.                         name option. The C:\ tells POE that the program
  187.                         DR may be found in the root directory.
  188.  
  189.  
  190.  
  191.                 Getting to me.
  192.  
  193.                 If you find you are having problems with POE,  you may 
  194.                 leave  messages for me on the PC-Board Echo Conference 
  195.                 Systems.  We're a system of PC Boards that have  begun 
  196.                 to  pass  echomail  nightly.  Feel  free to call these 
  197.                 fine boards listed below and check it out! 
  198.  
  199.  
  200.                 Most of these systems can be reached via PC-Pursuit:
  201.  
  202.                 Unusual Situations, Memphis, TN     901-365-0407
  203.                 Sleepy Hollow, Los Angeles, CA      213-859-9334 *
  204.                 The Tool Shop, Phoenix, AZ          602-279-2673 *
  205.                 Redundant PCB, Salt Lake City, UT   801-487-5339 *
  206.  
  207.                 * PC-Pursuitable
  208.  
  209.  
  210.  
  211.  
  212.                 If  you  ever  need  consulting  for  ProComm,   we're 
  213.                 available! Reasonable rates quoted upon request. 
  214.  
  215.  
  216.  
  217.                 ProComm Forever!
  218.  
  219.                 Mark Herring
  220.                 1400 Phillips Road
  221.                 Memphis, TN   38134
  222.  
  223.