home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / os2 / pmcommac.arj / QMTOPM.DOC < prev    next >
Encoding:
Text File  |  1991-09-23  |  6.7 KB  |  145 lines
  1. ====================================================================
  2.         QMtoPM, Copyright 1991 Brad Berson, Insane Software
  3.                  Version 1.00, September 22, 1991
  4. ====================================================================
  5.  
  6.  
  7. Warranties...
  8.  
  9. Warranties, Guarantees, golf tees, herbal teas, phooey.  There ARE
  10. NONE!!!  You use this software at your own risk.  I will not be held
  11. in any way responsible for damage incurred by this software for any
  12. reason whatsoever.  Period.  And please, read the instructions for
  13. goodness' sakes.
  14.  
  15. I hate writing documentation.  Can you tell?
  16.  
  17. QMtoPM began as a quick-n-dirty little utility to help me convert my
  18. Qmodem phone dialing file (QMODEM.FON) to the equivalent PMCOMM.FON
  19. file for PMcomm.  Re-typing 150 entries by hand was a tedious enough
  20. task to keep me from actually making the switch from DOS to OS/2!
  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. And I blew about an hour writing this, er, documentation.
  26.  
  27. Could you care less?
  28.  
  29. Fine.  If you weren't using Qmodem before PMcomm, worry not.  There
  30. are at least two or three utilities that convert most of the popular
  31. communications software's phone directories to the Qmodem format.
  32. You may then use QMtoPM for the translation to the PMcomm format.
  33. If you can't find the converter you need, write me about it.  If you
  34. have the money, I have the time.
  35.  
  36. Bored?
  37.  
  38. Don't be.  Watch out for a few things.  Entry names longer than 20
  39. characters will be truncated.  Qmodem prefix information will have
  40. to be re-done with PMcomm's approach.  There's no room for your
  41. passwords in the PMCOMM.FON file (keep reading).  Scripts and their
  42. filenames will need attention (again, keep reading). PMcomm doesn't
  43. allow for notes attached to directory entries.  Some xfer protocol
  44. codes may not convert (particularly Qmodem "external" protocols).
  45. If you have unusual echo/duplex settings, forget them.  And this is
  46. important:  Make sure your Qmodem directory has no duplicate entry
  47. names.  Make each one at least slightly unique - and changing case
  48. won't help.  PMcomm can't handle duplicate entry names and will
  49. promptly corrupt the newly made .FON file.
  50.  
  51. QMtoPM will optionally create a text file with your directory entry
  52. names and respective passwords.  QMtoPM will also optionally change
  53. your script filename extensions to ".CMD", needed by OS/2 & PMcomm.
  54.  
  55. QMtoPM will translate the protocol letters A (Ascii), X (Xmodem),
  56. C (Xmodem-CRC), R (Relaxed Xmodem), O (Xmodem-1K), Y (Ymodem Batch),
  57. Z (Zmodem), F (Zmodem-1K/G), G (Ymodem/G Batch), B (Compuserve CISB)
  58. and K (Kermit).  All other codes will default to Xmodem.
  59.  
  60. Anxiety attacks?
  61.  
  62. If you try to give PMcomm duplicate dialing entry names, PMcomm will
  63. make your computer belch molten lava and summon the beast to wreak
  64. irreperable havoc upon your PMcomm data file and startup info.  Your
  65. Qmodem FON file can't be harmed unless your machine is possessed,
  66. but at your command a pre-existing PMCOMM.FON file will be happily
  67. and permanently obliterated.  Ya' been warned.
  68.  
  69. Get down to business!
  70.  
  71. Fire up QMtoPM (from DOS or the OS/2 DOS box) and press just one key
  72. to answer each question (possible answers are in <> brackets).  You
  73. will be asked if you want a password list to be created from the
  74. password field in Qmodem.  If you used that field in Qmodem you will
  75. want to answer "Y".  The file PASWORDS.LST will be created in the
  76. default directory.  You will then be asked how you want to handle
  77. the script names in Qmodem's script field.  If you never entered
  78. anything here, it doesn't matter how you answer.  If you have or
  79. will be converting your scripts for PMcomm/REXX, QMtoPM can change
  80. all the script filenames to end with ".CMD".  The other option is to
  81. leave all the script names blank.  Then QMtoPM will ask you if you
  82. want to over-write (obliterate) the original PMCOMM.FON file (if it
  83. exists), or to append the Qmodem records to whatever existed in the
  84. PMCOMM.FON file already.  This is useful if you kept several Qmodem
  85. FON files due to the 200-entry limitation.  Remember not to make any
  86. duplicate entry names!  The last questions will be the path and file
  87. names of your Qmodem and PMcomm FON files.  By default, those are
  88. QMODEM.FON and PMCOMM.FON, respectively, in the current directory.
  89. Press the "Return" key to accept each default, or type in the paths
  90. only (include a trailing backslash, ie "\TURD\TOILET\"), or the full
  91. path\filename (ie "D:\SEWAGE\TREATMNT\FORBNYUK.FON"), followed by
  92. the "Return" key.
  93.  
  94. Errata...
  95.  
  96. There's almost error checking.  Tough.  Write your own.  Not much
  97. can happen unless you mis-type a filename or answer "Overwrite"
  98. when you really meant "Append".  If you can't be trusted to avoid
  99. duplicate dialing entry names, you probably couldn't have read this
  100. text by yourself anyway.
  101.  
  102. Begging?
  103.  
  104. Nah, but I should know better.  This software is distributed under
  105. the Shareware premise.  That is, if it worked, and you're satisfied
  106. with and using the results of it, you're obligated to pay for it
  107. under the terms of the following license agreement.
  108.  
  109. If you are using this in a commercial setting, you WILL pay a modest
  110. sum for my efforts.  Non-commercial users are allowed free use but
  111. are encouraged to heed their terrible feelings of guilt and loyalty
  112. every time they open their checkbooks.  Send enough to ease your
  113. guilt without insulting me.  Commercial licensing is a paltry $10
  114. per copy, with site license and network discounts for over 100
  115. copies (10% per 100 copies).  The single commercial license allows
  116. use of one copy of this software on one machine at one time.  Backup
  117. copies are encouraged.  The source code (written in QuickBASIC -
  118. don't laugh) is available on separate terms.  Technical support can
  119. be had through Compuserve, the OS/2 conferences on Ilink and
  120. SmartNet and via the Multi-Net BBS (see the PMcomm documentation).
  121. Urgent (!) questions can phone or FAX but you're unlikely to be able
  122. to reach me directly.  It's your dime...
  123.  
  124. Warning!
  125.  
  126. Violation of the license agreement is illegal and immoral.  Those
  127. who perpetrate this heinous crime will be afflicted by the powers
  128. that be, such that their genitalia will turn black and fall off or
  129. fuse closed.  Continued violations will result in the most unsightly
  130. failure of the perpetrator's digestive system.
  131.  
  132. "Your love gives me such a thrill, but it won't pay my bills..."
  133.  
  134. Brad Berson
  135. Insane Software, c/o
  136. Capital Cities/ABC-TV, Inc.
  137. 47 West 66th Street, B1
  138. New York, NY  10023
  139. (212) 887-4216 voice
  140. (212) 887-2154 FAX
  141. CIS: 71631,132
  142.  
  143. The end.
  144.  
  145.