home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / PMAC10.ZIP / QMTOPM.DOC < prev   
Text File  |  1992-05-07  |  11KB  |  205 lines
  1.      ====================================================================
  2.           QMtoPM/REXX, Copyright 1991 Brad Berson, Psycho Psoftware
  3.                         Version 1.00, April 28, 1992
  4.      ====================================================================
  5.  
  6.      Warranties...
  7.  
  8.      Warranties, Guarantees, golf tees, herbal teas, phooey.  There ARE
  9.      NONE!!!  You use this software at your own risk.  I will not be held
  10.      in any way responsible for damage incurred by this software for any
  11.      reason whatsoever.  Period.  And please, read the instructions for
  12.      goodness' sakes.
  13.  
  14.      I hate writing documentation.  Can you tell?
  15.  
  16.      QMtoPM began as a quick-n-dirty little utility to help me convert my
  17.      Qmodem phone dialing file (QMODEM.FON) to the equivalent PMCOMM.FON
  18.      file for PMcomm.  Re-typing 150 entries by hand was a tedious enough
  19.      task to keep me from actually making the switch from DOS to OS/2!
  20.      Well, almost...
  21.  
  22.      Once it worked, I thought "Gee, I'm sure lots of other people are in
  23.      the same dilemma."  So I spent a few hours tidying up the code,
  24.      adding some features, and making the conversions more comprehensive.
  25.      Then I got a really bent idea and converted the original QuickBASIC
  26.      code (crazy enough) into REXX (crazier still).  I mean, nobody gets
  27.      rich from Shareware registrations of phone directory converters, eh?
  28.      So why not give 'em a program they can change to suit if necessary.
  29.      Spent more tedious hours figuring out REXX workarounds for other-
  30.      wise simple endeavours, blew about another hour writing this, er,
  31.      documentation and here you have it.
  32.  
  33.      Could you care less?
  34.  
  35.      Fine.  If you were using a communications program other than Qmodem
  36.      before PMcomm, worry not.  There are at least two or three utilities
  37.      that convert most of the popular communications software's phone
  38.      directories to the Qmodem format.  You may then use QMtoPM for the
  39.      translation to the PMcomm format.  If you can't find the converter
  40.      you need, write me about it.  If you have the money, I have the
  41.      time.  And no pride or guilt whatsoever.  If you're brave, re-write
  42.      it yourself.
  43.  
  44.      Bored?
  45.  
  46.      Don't be.  Watch out for a few things.  Entry names longer than 20
  47.      characters will be truncated.  Qmodem prefix information will have
  48.      to be re-done with PMcomm's approach.  There's no room for your
  49.      passwords in the PMCOMM.FON file (keep reading).  Scripts and their
  50.      filenames will need attention (again, keep reading). PMcomm doesn't
  51.      allow for notes attached to directory entries.  Some xfer protocol
  52.      codes may not convert (particularly Qmodem "external" protocols).
  53.      If you have unusual echo/duplex settings, forget them.  And this is
  54.      important:  Make sure your Qmodem directory has no duplicate entry
  55.      names.  Make each one at least slightly unique - and changing case
  56.      won't help.  PMcomm can't handle duplicate entry names and will
  57.      promptly corrupt the newly made .FON file.  If you are appending
  58.      onto an already-existing PMCOMM.FON file, be especially careful of
  59.      duplicates.  ALWAYS BACK-UP YOUR FILES BEFOREHAND!
  60.  
  61.      QMtoPM will optionally create a text file with your directory entry
  62.      names and respective passwords and notefile names if they exist.
  63.      QMtoPM will also optionally change your script filename extensions
  64.      to ".CMD", as needed by OS/2, REXX & PMcomm.
  65.  
  66.      QMtoPM will translate the protocol letters A (Ascii), X (Xmodem),
  67.      C (Xmodem-CRC), R (Relaxed Xmodem), O (Xmodem-1K), Y (Ymodem Batch),
  68.      Z (Zmodem), F (Zmodem-1K/G), G (Ymodem/G Batch), B (Compuserve CISB)
  69.      and K (Kermit).  All other codes will default to Xmodem.
  70.  
  71.      Anxiety attacks?
  72.  
  73.      If you try to give PMcomm duplicate dialing entry names, PMcomm will
  74.      make your computer belch molten lava and summon the beast to wreak
  75.      irreperable havoc upon your PMcomm data file and startup info.  Feel
  76.      any better now?  Your Qmodem FON file can't be harmed unless your
  77.      machine is possessed, but at your command a pre-existing PMCOMM.FON
  78.      file will be happily and permanently obliterated.  Ya' been warned.
  79.  
  80.      Get down to business!
  81.  
  82.      QMtoPM accepts everything on the command line, or will ask you for
  83.      whatever you don't include.  The operating syntax is as follows:
  84.      QMTOPM [Qmodem.FON [PMcomm.FON]] [Y|N][T|B][A|O]
  85.      Where Qmodem.FON is the full address of your Qmodem directory file
  86.      (.FON is assumed), PMcomm.FON is the full address of where your
  87.      PMcomm directory file is or will be (.FON is assumed, specify only
  88.      if you also specified Qmodem.FON), and <Y>es or <N>o to create the
  89.      password file, <T>ranslate or <B>lank out script filenames, and
  90.      <A>ppend or <O>ver-write any existing PMcomm .FON file of the same
  91.      name specified.
  92.  
  93.      Or just fire up QMtoPM (from the OS/2 command line).  The first
  94.      questions will be the path and file names of your Qmodem and PMcomm
  95.      FON files.  By default, those are QMODEM.FON and PMCOMM.FON in the
  96.      current directory.  Press the "Return" key to accept each default,
  97.      or type in the paths only (include a trailing backslash, for example
  98.      "\TURD\TOILET\"), or type in the full path\filename (for example
  99.      "D:\SEWAGE\TREATMNT\FORBNYUK.FON"), followed by the "Return" key.
  100.      The name of the password file will follow the name of the PMcomm
  101.      .FON file and end with ".PWD".  The last three questions each take
  102.      single-character answers (plus the "Return" key).  Possible answers
  103.      are in <> brackets.  You will be asked if you want a password list
  104.      to be created from the password field in Qmodem.  If you used that
  105.      field in Qmodem you will want to answer "Y".  The file PMCOMM.PWD
  106.      will be created.  You will then be asked how you want to handle
  107.      the script names in Qmodem's script field.  If you never entered
  108.      anything here, it doesn't matter how you answer.  If you have or
  109.      will be converting your scripts for PMcomm/REXX, QMtoPM can change
  110.      all the script filenames to end with ".CMD".  The other option is to
  111.      leave all the script names blank.  Then QMtoPM will ask you if you
  112.      want to over-write (obliterate) the original PMCOMM.FON file (if it
  113.      exists), or to append the Qmodem records to whatever existed in the
  114.      PMCOMM.FON file already.  This is useful if you kept several Qmodem
  115.      FON files due to the 200-entry limitation.  Remember not to make any
  116.      duplicate entry names when appending new .FON files!!!
  117.  
  118.      Errata...
  119.  
  120.      There's almost no error checking.  Tough.  Write your own.  Not much
  121.      can happen unless you mis-type a filename or answer "Overwrite"
  122.      when you really meant "Append".  If you can't be trusted to avoid
  123.      duplicate dialing entry names, you probably couldn't have read this
  124.      text by yourself anyway.  Make backups of your .FON files in case
  125.      you missed a duplicate entry.
  126.  
  127.      The only known anomoly (sort of), is encountered when over-writing a
  128.      PMCOMM.FON file with a smaller PMCOMM.FON file.  The file will be
  129.      the original, larger size.  REXX is unable to truncate a file and I
  130.      didn't like the way "ADDRESS CMD 'DEL PMCOMM.FON'" looked.  This is
  131.      harmless, as PMcomm uses a blank last record to detect end-of-file.
  132.      The first time you load the file and then press the "SAVE" button in
  133.      PMcomm, the file size will be corrected.
  134.  
  135.      Multiple runs of QMtoPM will append password data to the password
  136.      file, when that feature is selected with the "Y" switch.  Under no
  137.      circumstances will it be over-written in that case.  You may specify
  138.      the "Y" switch even if no previous .FON file exists.  You may feel
  139.      safer using QMtoPM in this manner.
  140.  
  141.      The password file will have a heading.  That heading by default only
  142.      appears once, but can be requested for every (n) lines by editing
  143.      the "maxlines" variable near the beginning of the program.
  144.  
  145.      Useless details.
  146.  
  147.      At least to some.  But I'll discuss the coding anyway.  BRQM breaks
  148.      the Qmodem records into straight REXX text and numeric variables.
  149.      It uses C2D (REXX) for numeric conversions and TP2R (mine) for the
  150.      text.  The main record-reading loop does all the conversions into
  151.      PMcomm's format using D2C (REXX) for numeric conversions and R2CS
  152.      (mine) for text.  The dual-conversions make debugging easier with
  153.      negligable effect on speed.  PUPM concatenates those conversions
  154.      into one record and writes the record.  PRLI formats and writes the
  155.      records to the password/note file.  LFHD prints the password file
  156.      headings and can be used every n lines by setting the "maxlines"
  157.      variable as needed.  The main loop puts nuls (blanks) into PMcomm
  158.      fields which have no equivalent in Qmodem, set the PMcomm prefix
  159.      numbers to "1" (the PMcomm default), converts script filenames to
  160.      *.CMD or blanks them out, translates protocol codes as best as it
  161.      can, translates the TPASCAL time to CTIME mathematically and does
  162.      straightforward conversions of the rest.
  163.  
  164.      Begging?
  165.  
  166.      Nah, but I should know better.  This software is distributed under
  167.      the Shareware premise.  That is, if it worked, and you're satisfied
  168.      with and using the results of it, you're obligated to pay for it
  169.      under the terms of the following license agreement.
  170.  
  171.      If you are using this in a commercial setting, you WILL pay a modest
  172.      sum for my efforts.  Non-commercial users are allowed free use but
  173.      are encouraged to heed their terrible feelings of guilt and loyalty
  174.      every time they open their checkbooks.  Send enough to ease your
  175.      guilt without insulting me.  Commercial licensing is a paltry $10
  176.      per copy, with site license and network discounts for over 100
  177.      copies (20% per 100 copies).  The single commercial license allows
  178.      use of one copy of this software on one machine at one time.  Backup
  179.      copies are encouraged.  Technical support can be had through the
  180.      Compuserve Information Service, the OS/2 conferences on Ilink and
  181.      SmartNet and via the Multi-Net BBS (see the PMcomm documentation).
  182.      Urgent (!) questions can phone or FAX but you're unlikely to be able
  183.      to reach me directly.  It's your dime...
  184.  
  185.      Warning!
  186.  
  187.      Violation of the license agreement is illegal and immoral.  Those
  188.      who perpetrate this heinous crime will be afflicted by the powers
  189.      that be, such that their genitalia will turn black and fall off or
  190.      fuse closed.  Continued violations will result in the most unsightly
  191.      failure of the perpetrator's digestive system.
  192.  
  193.      "Your love gives me such a thrill, but it won't pay my bills..."
  194.  
  195.      Brad Berson
  196.      Psycho Psoftware
  197.      #2 Chaparral Road
  198.      Chestnut Ridge, NY  10977
  199.      (212) 887-4216 voice
  200.      (212) 887-2154 FAX
  201.      CIS: 71631,132
  202.  
  203.      The end.
  204.  
  205.