home *** CD-ROM | disk | FTP | other *** search
/ The Devil's Doorknob BBS Capture (1996-2003) / devilsdoorknobbbscapture1996-2003.iso / Dloads / OTHERUTI / MIC2-1.ZIP / MP2 / README.TXT < prev   
Text File  |  1991-09-09  |  15KB  |  390 lines
  1. ReadMe.txt for MicroPhone II for Windows.
  2. September 6, 1991
  3.  
  4.  
  5. USING NOTEPAD TO VIEW ON-LINE DOCUMENTS
  6. =======================================
  7.  
  8.   *  If you enlarge Notepad to its maximum size, this document 
  9.      will be easier to read. Just type Alt-space followed by X. 
  10.  
  11.   *  If you have not yet installed MicroPhone II, you may do so 
  12.      now by exiting Notepad and following the instructions on the
  13.      "Getting Started" card included in your MicroPhone II package.
  14.      
  15.   *  To exit Notepad and return to Windows, double-click the 
  16.      Control-menu or choose Exit from the File menu.
  17.  
  18.  
  19. CONTENTS
  20. ========
  21.  
  22. This document contains important information not included in the
  23. printed documentation. These are the topics covered:
  24.  
  25.   *  Installing MicroPhone II
  26.  
  27.   *  After Installation
  28.  
  29.   *  Color Icons Library
  30.  
  31.   *  Incorrect Settings Cause Lost Data
  32.  
  33.   *  Windows Communication Driver (COMM.DRV)
  34.  
  35.   *  Differences from the Macintosh version
  36.  
  37.   *  Addendum to the documentation
  38.  
  39.      +  AutoSize - Control-menu Command
  40.      +  New Settings - Replace Existing Document Option
  41.      +  Using DDE - Quotation Marks
  42.      +  Script Command - Move Cursor to ...
  43.      +  Script Command - Repeat
  44.      +  Script Command - Set Term Param Connection Parameter
  45.      +  Script Command - Signal Send IOCTL
  46.  
  47.   *  Contacting Software Ventures
  48.  
  49.  
  50. INSTALLING MICROPHONE II
  51. ========================
  52.  
  53. Instructions for installing MicroPhone II are provided in "Getting
  54. Started," Chapter 1 of the User's Guide. A short version is
  55. provided on the "Getting Started" card included in your MicroPhone
  56. II package. Information about using MicroPhone II's installer and
  57. the location of MicroPhone II files is provided in the Install.txt
  58. file on the MicroPhone II program disk.
  59.  
  60.  
  61. AFTER INSTALLATION
  62. ==================
  63.  
  64. The tutorial chapters in the User's Guide provide information about
  65. using MicroPhone II. The Reference Manual provides explanations of
  66. MicroPhone II's menu and script commands. Below is an outline of
  67. where to look for instructions on using MicroPhone II.
  68.  
  69.  
  70. If you have never used a modem:
  71. ______________________________
  72.  
  73. Start at the beginning of the User's Guide. The "Getting Started"
  74. chapter helps you set up your system. The "Connecting
  75. Automatically" chapter leads you through a tutorial that explains
  76. how to connect to a remote computer.
  77.  
  78.  
  79. Configuring MicroPhone II to work with any remote computer:
  80. __________________________________________________________
  81.  
  82. Follow the steps in the "Exchanging Files" chapter of the User's
  83. Guide. The tutorial shows how to set MicroPhone II with the
  84. correct baud rate and other settings. This chapter assumes you
  85. understand the basic concepts of telecommunications explained in
  86. previous chapters.
  87.  
  88.  
  89. Transferring files between computers:
  90. ____________________________________
  91.  
  92. Follow the steps in the "Exchanging Files" chapter of the User's
  93. Guide. Once you set MicroPhone II to communicate with the remote
  94. computer, you can exchange files. This chapter explains how to send
  95. and receive files created in any application. More information
  96. about file transfer protocols is provided in "The Transfer Menu"
  97. chapter of the Reference Manual. These chapters assume you
  98. understand the basic concepts of telecommunications explained in
  99. the beginning chapters of the User's Guide.
  100.  
  101.  
  102. Automating telecommunications with MicroPhone II scripts:
  103. ________________________________________________________
  104.  
  105. Begin with "Building a Script with Watch Me" in the User's Guide.
  106. You will learn how MicroPhone II records your telecommunications
  107. activities and then plays them back, sending commands to the
  108. remote computer. The "Editing a Script" chapter provides
  109. instructions for editing scripts in MicroPhone II. "The Script
  110. Commands" and "Expressions, Operators, and Functions" chapters of
  111. the Reference Manual provide details about the script language.
  112.  
  113.  
  114. Setting your computer so you can call it from anywhere:
  115. ______________________________________________________
  116.  
  117. Follow the steps in the "Using the Mini BBS" chapter of the User's
  118. Guide. Following the step-by-step instructions, you will learn to
  119. set your computer so you can call from another computer to access
  120. your files. You can also set it so other people can send electronic
  121. mail and exchange files.
  122.  
  123.  
  124. Writing a MicroPhone II interface to an electronic mail service:
  125. _______________________________________________________________
  126.  
  127. Follow the steps in the "Building Custom Interfaces" chapter of the
  128. User's Guide.  Following the step-by-step instructions, you will
  129. create a custom electronic mail interface to CompuServe using the
  130. MicroPhone II Interface Template. By following the instructions for
  131. CompuServe, you will learn the scripting principles for developing
  132. interfaces to other electronic information service.
  133.  
  134.  
  135. More Information:
  136. ________________
  137.  
  138. The first chapter of each book provides more information about
  139. what is covered in the documentation.
  140.  
  141.  
  142. COLOR ICONS LIBRARY
  143. ===================
  144.  
  145. The MicroPhone II application (MP2.EXE) contains color icons that
  146. can be assigned to settings documents (or any other file) as part
  147. of a Windows 3.0 group. Review your Windows 3.0 documentation for
  148. details on assigning icons and group items.
  149.  
  150.  
  151. INCORRECT SETTINGS CAUSE LOST DATA
  152. ==================================
  153.  
  154. Sometimes characters from the remote computer may not appear in
  155. MicroPhone II's terminal window. This is usually caused by
  156. incorrect communications settings, particularly baud rate and
  157. parity.
  158.  
  159. The most common settings are Bits per Character - 8, Parity - None
  160. and Stop Bits - 1. (Set stop bits to Auto in MicroPhone II.) The
  161. next most common settings combination is Bits per Character - 7,
  162. Parity - Even and Stop Bits - 1.
  163.  
  164. If characters do not appear on the screen properly, the remote
  165. computer is using different settings than the local computer.
  166. Check your settings and try the other combination shown above. If
  167. this does not correct the problem, contact the system
  168. administrator, SYSOP or customer service for the remote computer
  169. and verify the correct communications settings.
  170.  
  171. Data can be lost at baud rates of 19,200 and above because most PC
  172. communications hardware is unable to maintain communications at
  173. those speeds. This can be fixed by using serial communications
  174. hardware designed for high speed transfers. Contact our BBS at
  175. (510) 849-1912 for the latest information.
  176.  
  177.  
  178. WINDOWS COMMUNICATIONS DRIVER (COMM.DRV)
  179. ========================================
  180.  
  181. The Windows 3.0 Communications Driver (COMM.DRV) does not support
  182. baud rates above 19,200 baud. MicroPhone II uses COMM_SVC.DRV, a
  183. modified version of COMM.DRV, to support higher data transfer
  184. rates. There aren't any other modifications in COMM_SVC.DRV.
  185.  
  186. MicroPhone II's installer automatically installs COMM_SVC.DRV and
  187. modifies SYSTEM.INI to identify the new driver. It will be used
  188. by all Windows Communications applications after you restart
  189. Windows.
  190.  
  191. To disable the modified driver and return to the standard Windows
  192. Driver, change the SYSTEM.INI entry from COMM_SVC.DRV to COMM.DRV.
  193.  
  194.  
  195. DIFFERENCES FROM THE MACINTOSH VERSION
  196. ======================================
  197.  
  198. MicroPhone II for Windows differs slightly from MicroPhone II for 
  199. the Macintosh. Appendix G of the Reference Manual explains the 
  200. differences. Read this appendix before converting scripts from the
  201. Macintosh to Windows.
  202.  
  203.  
  204. ADDENDUM TO THE DOCUMENTATION
  205. =============================
  206.  
  207. The new script commands and features added to the program after
  208. the manuals were completed are documented below.
  209.  
  210.  
  211. AUTOSIZE - Control-menu Command
  212. ______________________________
  213.  
  214. The Autosize command was added to the Control-menu. Choosing this
  215. command will resize MicroPhone II's window to show all lines and
  216. columns of the terminal window. This size is normally 80 columns
  217. by 24 rows, but it can be adjusted by the rows, columns and font
  218. settings in the Terminal Settings dialog box.
  219.  
  220. If the MicroPhone II window on your screen is shorter than the
  221. Rows setting of your terminal, the cursor will move below the
  222. window, and you will not see new text as it is received. Click the
  223. scroll bar to move to the window's bottom where text is being
  224. received. You can also use the Autosize command in the
  225. Control-menu to resize the window to match the terminal settings.
  226.  
  227.  
  228. TURNKEY STARTUP - Keep Connection Open Preference
  229. _________________________________________________
  230.  
  231. MicroPhone II's default setting causes the communications port to
  232. be opened when a settings document is opened. This creates a
  233. conflict if another settings document is open and trying to use
  234. the same connections. If this occurs, a message indicating the
  235. conflict will appear and script execution will pause. When you
  236. dismiss the message, the connection is closed and script execution
  237. will continue.
  238.  
  239. If the script expects the connection to be open, it may not work
  240. properly until you correct the port conflict and open the
  241. connection. You can avoid the conflict by deselecting the Keep
  242. Connection Open option in the Preferences dialog box. With this
  243. change, the connection is not automatically opened when the
  244. settings document is opened; however, using Dial Service will
  245. attempt to open the connection.
  246.  
  247. For more information about Keep Connection Open, see "The Settings
  248. Menu" chapter in the Reference Manual.
  249.  
  250.  
  251. NEW SETTINGS - Replace Existing Document Option
  252. _______________________________________________
  253.  
  254. When you choose New Settings from the File menu, MicroPhone II
  255. closes the current settings document before creating a new one. If
  256. you want MicroPhone II to open a new window for the new document
  257. and leave the other document open, place "New Settings=1" in the
  258. Preferences section of the MicPhone.ini file. Removing the entry
  259. will reset MicroPhone II to the default behavior.
  260.  
  261.  
  262. USING DDE - Quotation Marks
  263. ___________________________
  264.  
  265. MicroPhone II can be linked to other applications using DDE.
  266. Scripts can be used to connect to an information service like
  267. CompuServe, collect stock quotes, and pass the information to
  268. Microsoft Excel. Documents prepared in Microsoft Word can be
  269. directed to MicroPhone II through a Word macro, sending the
  270. documents directly to a service bureau for printing. The beginning
  271. of "The Script Commands" chapter in the Reference Manual provides
  272. more information about using DDE with MicroPhone II.
  273.  
  274. Using parenthesis instead of quotation marks is an additional
  275. feature to help DDE scripting. Normally a script command
  276. expression must be enclosed by double quotes. Also, literal strings
  277. in expressions are enclosed by single quotes. Restrictions on the
  278. use of quotes by the application creating the DDE message adds to
  279. the confusion. To alleviate this, substitute parenthesis for the
  280. double quotes enclosing a script command expression. For example:
  281.  
  282. DDE * Execute MPServer "'[Alert * OK (''The year is ''& year)]'"
  283.  
  284. is equivalent to 
  285.  
  286. DDE * Execute MPServer "'[Alert * OK "''The year is ''& year"]'"
  287.  
  288. This substitution can be used anywhere double quotes bound a
  289. MicroPhone II script command expression.
  290.  
  291.  
  292. SCRIPT COMMAND - Move Cursor to ...
  293. ___________________________________
  294.  
  295. The "Move Cursor to" script command moves the insertion point with
  296. the cursor. This causes incoming text to appear at the same
  297. location as the cursor. This may lead to confusing screens because
  298. the cursor may not be where the remote computer expects it.
  299.  
  300. To avoid this problem, use the CursorRow and CursorCol script
  301. functions to save the position of the cursor before the move. Use
  302. Move Cursor to Absolute Row/Column to restore its position.
  303.  
  304.  
  305. SCRIPT COMMAND - Repeat
  306. _______________________
  307.  
  308. The example provided for the Repeat script command (Reference
  309. Manual page 214) has an error in the last line. It should be:
  310.  
  311. Until Expression "done"
  312.  
  313.  
  314. SCRIPT COMMAND - Set Term Param Connection Parameter
  315. ____________________________________________________
  316.  
  317. This is a subcommand of Set Term Param ...
  318.  
  319. SYNTAX: Set Term Param Connection Parameter []
  320.  
  321. ARGUMENT:
  322. String - A comma-delimited string specifying the parameter
  323. settings used to configure the current connection port. The comma
  324. is omitted if there is only one parameter. This string uses the
  325. same format returned by the ConnectionParameter script function.
  326.  
  327. RESULT:
  328. The contents of the string are assigned to the connection port
  329. specific parameters of the Communications Settings dialog box.
  330.  
  331.  
  332. SCRIPT COMMAND - Signal Send IOCTL
  333. __________________________________
  334.  
  335. The description for the Signal Send IOCTL script command in the
  336. Reference Manual does not discuss sending NUL characters
  337. (binary zero) from a MicroPhone II expression. MicroPhone II is
  338. unable to imbed NUL characters within a literal string. Since
  339. this can be required of the IOCTL string, an alternative is
  340. provided for the Signal Send IOCTL script command.
  341.  
  342. To imbed a NUL character within a literal string, use '\x0'. It
  343. may be easier to write the entire string using hexadecimal
  344. characters in this format. For instance,
  345.  
  346. Signal Send IOCTL "'\x00\x07\x00\x03\x0\x0\x0\x0\x0'"
  347.  
  348. sends an IOCTL WRITE for 9600 bps, parity none, 8 data bits,
  349. 1 stop bit, break OFF, and 0 of 1/18.2 seconds count if the
  350. current connection port is through Egberto Willies's device
  351. driver, COMM-DRV.
  352.  
  353. Signal Send IOCTL "'\x00\x08\x00\x03\x0\x0\x0\x0\x0'"
  354.  
  355. sends an IOCTL WRITE for 19,200 bps, parity none, 8 data bits,
  356. 1 stop bit, break OFF, and 0 of 1/18.2 seconds count if the
  357. current connection port is through Egberto Willies's device
  358. driver, COMM-DRV.
  359.  
  360. For more information about the meaning of the string, review your
  361. device driver's documentation. The '\xnn' syntax will not work in
  362. the expressions of any other script command.
  363.  
  364.  
  365. CONTACTING SOFTWARE VENTURES
  366. ============================
  367.  
  368. The last page in each manual lists the ways to contact Software
  369. Ventures Corporation. If you are having any difficulties, call
  370. Technical Support at (510) 644-1325 (9am to 4:30pm PST, weekdays).
  371.  
  372. You may also post messages to Software Ventures Technical Support
  373. on the following electronic services:
  374.  
  375. AppleLink (SVCTECH)
  376. BIX (SVC)
  377. CompuServe (76004,2161)
  378. GEnie (SVCTECH)
  379. InterNet (microphone@svcdudes.com)
  380. MacNet (PERSEPHONE)
  381. MCI (286-6859)
  382. Telex (650 286-6859)
  383.  
  384. When you call the Software Ventures BBS, you will find the latest
  385. information, technical support, public domain and shareware files,
  386. as well as new scripts, settings documents and modem drivers. The
  387. number is (510) 849-1912.
  388.  
  389. Welcome to the world of MicroPhone II. Have a fascinating journey!
  390.