home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / lan / os2you22.arj / OS2YOU.DOC < prev    next >
Text File  |  1991-06-07  |  56KB  |  1,207 lines
  1. OS2YOU 2.2  (read OS/2 to you) 1991-06-06         (c) 1990 Mikael Wahlgren
  2. ==========================================================================
  3.  
  4.  
  5. Introduction
  6. ============
  7. Os2You is a communication software to allow remote operation of any
  8. OS/2 full screen text session and the DOS compatibility box, over
  9. an asynchronous line (by cable or modem), a pipe or a remote pipe (over
  10. a LAN).  The program can be used with many different terminals and
  11. allows high speed file transfers between host and remote.  The program
  12. may be used in two different ways.  You can run the program as it is stand
  13. alone, but it is also possible to call the program from your own program,
  14. allowing your own programs to offer remote operation.
  15.  
  16. Some different ideas on how to use Os2You:
  17.  
  18.     *   Installed on your office PC, it is possible to run the
  19.         PC and access the files from home using a PC or LapTop or even
  20.         a simple terminal.
  21.  
  22.     *   Installed in a BBS, it is possible to run most character based
  23.         programs on line in the BBS (like on line games), or run
  24.         maintenance programs.
  25.  
  26.     *   Installed in a LAN, it is possible to run programs on a different
  27.         machine on the network.  It makes it possible for DOS requesters
  28.         to run OS/2 character applications, without installing OS/2 on them.
  29.  
  30.     *   Installed in a LAN, it is possible to access asynchronous ports
  31.         for outgoing traffic both from OS/2 and DOS requesters, using
  32.         included programs, or any character based OS/2 communication package.
  33.  
  34.     *   Installed on your customers systems, it makes it easy for
  35.         you to service these by running their system on line.
  36.  
  37.  
  38.  
  39. The program can directly replace the program MaxPipe (from Peter Fitzsimmons),
  40. and will be compatible with more programs than MaxPipe.
  41.  
  42. The program is only tested with OS/2 1.3 SE, but should work OK with
  43. OS/2 1.2 and OS/2 2.0.  It does NOT work with OS/2 1.0.
  44.  
  45. If you have got the distribution files packed in a ZIP-file, you should
  46. unpack them first.  Files included in this package:
  47.  
  48. OS2YOU.EXE           The remote software
  49. OS2YOU.DOC           This documentation
  50. SPECS.DOC            Specification for the pipe protocol
  51. ORDER.DOC            Printable Order/Invoice form
  52. LANTERM.EXE          Terminal program using DOS on a LAN or modem.
  53. LANTERM2.EXE         Terminal program using OS/2 on a LAN or modem.
  54. LANBRIDG.EXE         LAN Bridge, to access OS/2 Requesters remote over LAN
  55. LANREL.EXE           Program to temporarily suspend Os2You to free port
  56. DOS2YOU.EXE          Program to access DOS compatibility box
  57. DOSREDIR.EXE         DOS-program required to use DOS compatibility box remote
  58. MODEM.PRM            Modem description file
  59. ????????.PRM         Terminal description files for different terminals
  60. SZ.CMD               Command file to initiate Zmodem file transfer from
  61.                      host to remote using M2Zmodem (not included).
  62. RZ.CMD               Command file to initiate Zmodem file transfer from
  63.                      remote to host using M2Zmodem (not included).
  64.  
  65. If you don't think this is the most current version of Os2You, you could
  66. send a formatted diskette and four International Post reply coupons
  67. (Coupon-Réponse International, Union Postale Universelle) to my address
  68. mentioned last in this documentation.
  69.  
  70.  
  71.  
  72.  
  73. Index
  74. =====
  75. The following search strings may be of help if you are looking for specific
  76. information in this file.  Use a text editor and search for these strings
  77. and you will be located at the correct entry point (ignoring the index
  78. entry itself).
  79.  
  80.  
  81. Terminal emulation        - how to define which terminal to emulate
  82. Configuring modem         - how to configure Os2You for your modem
  83. Sharing ports             - how to use a port occupied by Os2You
  84. keystrokes                - how Os2You treats different keystrokes
  85. DOS-compatibility         - how to run DOS-box remote
  86. File transfer             - how to do file transfer via Os2You
  87. network                   - how to use Os2You over a network
  88. Maximus                   - how to use Os2You with Maximus BBS
  89. license                   - how to get a license to use Os2You
  90.  
  91.  
  92.  
  93.  
  94.  
  95. Stand alone installation
  96. ========================
  97. You should copy all the distributed files to a subdirectory on your hard
  98. disk.  The directory should be specified in your PATH and DPATH environment
  99. variables.  Assuming you have copied the files to subdirectory called
  100. "C:\Remote" this is done by the command:
  101.  
  102. SET PATH=%PATH%C:\Remote;
  103. SET DPATH=%DPATH%C:\Remote;
  104.  
  105. To configure the program in stand alone mode, you run the program OS2YOU
  106. from an OS/2 Command Prompt, without any parameters.  You will get a
  107. configuration menu with different options.  When you have configured the
  108. modem, you can either enter host mode operation or exit the program.
  109.  
  110. Note that you should always use a Full Screen text session for the programs.
  111. The asynchrous support device driver COM0x.SYS driver should also be loaded
  112. in your CONFIG.SYS file.
  113.  
  114. To start the program with an existing configuration file, you start the
  115. program by typing "Os2You -c <cfg-file>" at the OS/2 Command Prompt
  116. (you replace <cfg-file> with the configuration filename you want to use).
  117. For more command line start options see separate section below or enter
  118. "Os2You -?" at the prompt.
  119.  
  120. The program will now put the modem into auto answer mode (if your modem is
  121. supported by the program), and wait for an incomming call, and answer
  122. it.  When the connection is established, the caller will be asked for
  123. an ID and password and validate them with your configuration file.
  124.  
  125. If you have specified a callback number for the caller, the connection
  126. will be closed, and the Os2You program will call the phone number in
  127. the userlist entry (note that you should only include the phone number
  128. in the user list entry and not the Hayes command prefix "ATD", but if
  129. you want, it is possible to include any dialling command in the entry).
  130. The caller will be asked for the password once again, and will then
  131. be spawned to an OS/2 full screen text session.
  132.  
  133. If you have OS/2 1.2 or later, it is recommended to put the line
  134. "AUTOFAIL=YES" in your CONFIG.SYS file.  This will cause the operating
  135. system NOT to generate pop-up error messages, which would cause the Os2You-
  136. program to hang (or actually be suspended while waiting for a keystroke
  137. from the "real" keyboard).
  138.  
  139. With the default priority (priority set to 14), the screen update thread
  140. has exactly the same priority as the executed program.  This results
  141. in a regular screen updates in most situations.  Sometimes however a
  142. higher value may result in smother operation.  If you find that the
  143. screen update performance is not at all what you expected, you may
  144. try to change this value.  Note that sometimes, a higher priority
  145. means that the thread will steal too much CPU, resulting in much worse
  146. performance.
  147.  
  148.  
  149.  
  150.  
  151.  
  152. Using Os2You with pipes or remote pipes with a LAN
  153. ==================================================
  154. It is possible to use Os2You in a LAN, in two different ways.  You can
  155. install Os2You on a OS/2 network SERVER, and access it remote from any
  156. workstation in the LAN.  You can also install Os2You on a network
  157. REQUESTER, and access the requester from any workstation in the LAN,
  158. but this will require that the LanBridge program is installed on an
  159. network server.
  160.  
  161. If you want to use Os2You in a LAN on a SERVER, you should configure Os2You
  162. for stand alone operation (se above), but replace the communication device
  163. with a remote pipe name like "\Pipe\Os2You1".
  164.  
  165. If you want to use Os2You in a LAN on a REQUESTER, you should configure
  166. Os2You for stand alone operation (se above), but replace the communication
  167. device with a remote pipe name like "\\Servername\Pipe\Os2You1".  You will
  168. also have to install LanBridge (LANBRIDG.EXE) on the LAN SERVER specified
  169. in the pipe name.  You install LanBridge like:
  170.  
  171.    LanBridg \Pipe\Os2You1 \Pipe\LanTerm1
  172.  
  173. Regardless of how you have installed Os2You, you have to use the LanTerm
  174. or LanTerm/2 programs to access Os2You over a LAN.  The program LanTerm
  175. is used on workstations running DOS and LanTerm/2 is used on workstations
  176. running DOS.  The programs are started with just one parameter specifying
  177. which pipe to use for communication.  Suppose you configured the system
  178. with the pipe name mentioned above.  In this case you start LanTerm or
  179. LanTerm/2 by typing:
  180.  
  181.       LanTerm \\Servername\Pipe\Os2You1
  182.       LanTerm2 \\Servername\Pipe\Os2You1
  183.  
  184. at the command line prompt.  The LanTerm and LanTerm/2 programs are
  185. automaticly terminated when you exit the remote session.  If you terminate
  186. LanTerm or LanTerm2 abnormally (like pressing Ctrl-Break), the host session
  187. will be closed at once, and Os2You will wait for the next "caller" and
  188. LanTerm or LanTerm/2 will be terminated.
  189.  
  190. If no parameter is specified when starting the LanTerm or LanTerm/2 program,
  191. it will look for an Os2You.CFG file and try to configure itself using the
  192. information specified in the file (using the Install.EXE program).  LanTerm/2
  193. (but not LanTerm) may be used for asynchronous communication devices as well
  194. as pipes.
  195.  
  196. With LanTerm and LanTerm/2 most keys that is possible to emulate with Os2You,
  197. are mapped to their correct keys, except <Esc> that you have to press twice,
  198. for compatibility reasons.  All Esc-sequences used over the asynchronous line
  199. will work with LanTerm and LanTerm/2 too.
  200.  
  201. It is possible to start multiple sessions with Os2You using the same Pipe-
  202. name.  Each running copy of Os2You will be ready to receive a connect
  203. request from a remote user, and the user will be connected to the first
  204. free instance of Os2You.  It isn't even necessary that the Os2You program
  205. is started from the same machine in a LAN.  You may start Os2You with
  206. the same pipe name from any LAN station, and a connect request will be
  207. directed to the first free instance.
  208.  
  209. Note, that early versions of OS/2 LAN Server did not work properly with
  210. remote named pipes, especially not from DOS Requestors.  This software
  211. is tested with OS/2 Lan Server 1.2 CSD 4093, and worked on this configuration
  212. both from OS/2 requestors and DOS requesters.  But when tested with CSD 4063
  213. the program did not work with DOS Requesters, but was OK with OS/2 Requesters.
  214.  
  215. This is a chart of how Os2You and LanTerm is configured to work together:
  216.  
  217.  
  218.    ╔═════════════════════════╗             ╔═════════════════════════════════╗
  219.    ║ OS/2 Async. host        ║             ║ DOS Remote (terminal)           ║
  220.    ╟─────────────────────────╫───modems────╫─────────────────────────────────╢
  221.    ║ Os2You <- <comport> ... ║      │      ║ LanTerm <comport> <baudrate>    ║
  222.    ╚═════════════════════════╝      │      ╚═════════════════════════════════╝
  223.                                     │      ╔═════════════════════════════════╗
  224.                                     │      ║ OS/2 Remote (terminal)          ║
  225.                                     └──────╫─────────────────────────────────╢
  226.                                            ║ LanTerm2 <comport> <baudrate>   ║
  227.                                            ╚═════════════════════════════════╝
  228.  
  229.  
  230.    ╔═════════════════════════╗             ╔═════════════════════════════════╗
  231.    ║ LAN Server (host)       ║             ║ DOS Requester (terminal)        ║
  232.    ╟─────────────────────────╫─────LAN─────╫─────────────────────────────────╢
  233.    ║ Os2You <- \Pipe\Os2You1 ║      │      ║ LanTerm \\Srvname\Pipe\Os2You1  ║
  234.    ╚═════════════════════════╝      │      ╚═════════════════════════════════╝
  235.                                     │      ╔═════════════════════════════════╗
  236.                                     │      ║ OS/2 Requester (terminal)       ║
  237.                                     └──────╫─────────────────────────────────╢
  238.                                            ║ LanTerm2 \\Srvname\Pipe\Os2You1 ║
  239.                                            ╚═════════════════════════════════╝
  240.    ╔══════════════════════════════════╗
  241.    ║ OS/2 Requester (host)            ║
  242.    ╟──────────────────────────────────╢
  243.    ║ Os2You <- \\Srvname\Pipe\Os2You1 ║
  244.    ╚══════════════╤═══════════════════╝
  245.                   │
  246.                   │
  247.    ╔══════════════╧═══════════════╗        ╔═════════════════════════════════╗
  248.    ║ LAN Server (bridge)          ║        ║ DOS Requester (terminal)        ║
  249.    ╟──────────────────────────────╫───LAN──╫─────────────────────────────────╢
  250.    ║ LanBridg                     ║    │   ║ LanTerm \\Srvname\Pipe\Lanterm1 ║
  251.    ║ \Pipe\Os2You1 \Pipe\LanTerm1 ║    │   ╚═════════════════════════════════╝
  252.    ╚══════════════════════════════╝    │   ╔═════════════════════════════════╗
  253.                                        │   ║ OS/2 Requester (terminal)       ║
  254.                                        └───╫─────────────────────────────────╢
  255.                                            ║ LanTerm2 \\Srvname\Pipe\LanTerm1║
  256.                                            ╚═════════════════════════════════╝
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263. Sharing ports with other communication programs
  264. ===============================================
  265. If you have set up Os2You in HOST mode to answer incoming calls, it is
  266. possible to temporarily suspend Os2You, to let other communication programs
  267. access the port.  To do this you have to enter a pipe name in the
  268. configuration parameter "Port request pipe" (like "\PIPE\RELEASE").
  269.  
  270. Then you run the program LanRel with one of the following syntaxes:
  271.  
  272.    LanRel \Pipe\Release
  273.    LanRel \\Srvname\Pipe\Release
  274.  
  275. if the port request pipe was called "\Pipe\Release".  It is possible to use
  276. both local and remote pipes, so you can suspend Os2You on your local or
  277. LAN Os2You HOST.  The pipe name may also be a pipe bridged by the LanBridg
  278. software.
  279.  
  280. When Os2You gets a port request, it releases the communication port and
  281. halts for one (1) minute, leaving the port available.  By using LanRel
  282. you will have 1 minute to start any other communication program accessing
  283. the port, and Os2You will remain suspended until the port is available again.
  284. Os2You automaticly detects when the port is available again, and will resume
  285. its operation again.  The port is re-initialized when operation is resumed.
  286.  
  287. It is also possible to access the port directly with LanTerm or LanTerm2
  288. by starting these programs with the "Port request pipe" name as a parameter
  289. to the LanTerm(2) program.  It isn't possible to do file transfers over
  290. pipes though.
  291.  
  292.  
  293.  
  294.  
  295.  
  296. Terminal emulation
  297. ==================
  298. The included files should be run in an OS/2 full screen text session,
  299. and will allow you to connect to it by modem or cable.  In addition
  300. to this program, you will need a terminal emulation program, that
  301. is capable of emulating one of the included terminal emulation modes
  302. available with Os2You.  It doesn't matter which operating system your
  303. terminal emulator is running.
  304.  
  305. If you use OS/2 or DOS you may use the LanTerm2 (for OS/2) or LanTerm
  306. (for DOS) programs for both terminal emulation over a network using
  307. named pipes, or as an asynchronous terminal program.  It will
  308. remap the keys to their corresponding Esc-sequences, and is also
  309. compatible with the Os2You binary mode (when running over a Pipe), which
  310. sometimes are faster than the terminal emulation mode, when used on fast
  311. connections.
  312.  
  313. If you want to run LanTerm2 or LanTerm on a asynchronous connection, you
  314. should start LanTerm2 with the following syntax:
  315.  
  316.    LanTerm2 <COM-device> [baudrate]
  317.    LanTerm  <COM-device> [baudrate]
  318.  
  319. The device name MUST begin with "COM" (like COM1).  If no baudrate is
  320. specified the program uses the default baudrate.  When used in this
  321. mode, the programs always sets the COM-device to 8 databits, 1 stop-
  322. bits and no parity.  The LanTerm program for DOS, requires that ANSI.SYS
  323. is loaded in your CONFIG.SYS file.  The DOS-mode program will only work
  324. with COM1 and COM2 serial ports.  The programs are terminated by pressing
  325. Ctrl-Break.
  326.  
  327. The following terminals are supported by Os2You currently
  328. (ANSI is default if none selected):
  329.  
  330. Terminal                         Description file
  331. ===============================  =================================
  332. ANSI/VT100/VT102                 ANSI.PRM (same as default)
  333. Hazeltine 1500                   HAZEL.PRM (not tested)
  334. IBM 3101                         IBM3101.PRM
  335. Tandberg TDV 2116                TANDBERG.PRM
  336. Televideo 910-955/ADM 5/Wyse 50  TELEVID.PRM
  337. VT52/Heath/Zenith/ADDS VP        VT52.PRM
  338.  
  339. If you want to select another terminal emulation than the default
  340. ANSI terminal, you should add "-t <term-file>" as a command line
  341. start option.  Note that the description files only alter the
  342. screen output, and does not care about different keystroke combinations
  343. used by different terminals, except the ANSI escape keysequences.  Also
  344. note that some terminals will work better if you run Os2You in a screen
  345. with only 24 lines (MODE CO80,24) instead of the more common 25 lines.
  346.  
  347. If your terminal is not supported with a terminal description file,
  348. you may define your own terminal, by starting OS2YOU without any
  349. parameters, and select "Terminal definitions" in the configuration
  350. menu displayed.  See section 'Defining your own terminal' below.
  351.  
  352. The program automaticly detects how many columns and lines the
  353. OS/2 session contains, but you have to configure your terminal program
  354. for a screen size with at least the same amount of columns/lines (it doesn't
  355. matter if the terminal program uses more columns/lines than the OS/2 session).
  356. It is possible to alter the screen size with the MODE-command, while
  357. connected to Os2You, as long as the screen will fit on the remote screen.
  358.  
  359. To "emulate" different keystrokes, Esc sequences are used.  The following
  360. Esc sequences are valid (note that upper/lower case letters are
  361. significant):
  362.  
  363. Ch. Result   Ch. Result    Ch. Result    Ch. Result    Ch. Result (?????)
  364. === ======   === ======    === ======    === ======    === ==================
  365.  A  Alt-A     N  Alt-N     Esc Escape     1  F1         !  Shift/Ctrl/Alt-F1
  366.  B  Alt-B     O  Alt-O      t  BackTab    2  F2         @  Shift/Ctrl/Alt-F2
  367.  C  Alt-C     P  Alt-P                    3  F3         #  Shift/Ctrl/Alt-F3
  368.  D  Alt-D     Q  Alt-Q      w  Arr up     4  F4         $  Shift/Ctrl/Alt-F4
  369.  E  Alt-E     R  Alt-R      <  Arr left   5  F5         %  Shift/Ctrl/Alt-F5
  370.  F  Alt-F     S  Alt-S      >  Arr right  6  F6         ^  Shift/Ctrl/Alt-F6
  371.  G  Alt-G     T  Alt-T      z  Arr down   7  F7         &  Shift/Ctrl/Alt-F7
  372.  H  Alt-H     U  Alt-U                    8  F8         *  Shift/Ctrl/Alt-F8
  373.  I  Alt-I     V  Alt-V      c  Ctrl-Break 9  F9         (  Shift/Ctrl/Alt-F9
  374.  J  Alt-J     W  Alt-W                    0  F10        )  Shift/Ctrl/Alt-F10
  375.  K  Alt-K     X  Alt-X                    -  F11        _  Shift/Ctrl/Alt-F11
  376.  L  Alt-L     Y  Alt-Y                    =  F12        +  Shift/Ctrl/Alt-F12
  377.  M  Alt-M     Z  Alt-Z
  378.                                                         s  Set F-key to Shift
  379.  i  Insert    h  Home       u  PageUp                   l  Set F-key to Ctrl
  380.  d  Delete    e  End        n  PageDown                 a  Set F-key to Alt
  381. =============================================================================
  382. Tab    Task list                          b  Toggle binary mode
  383. Break  Force Os2You to exit               p  Toggle physical screen
  384. Space  Force Os2You to update screen      ?  Status information
  385.  
  386. The above screen is showed if you press Esc without any character following
  387. within approx. one second.  You may select any keystroke from the menu, and
  388. the menu exits, ans Os2You sends the selected keystroke to your application.
  389. If Esc is pressed and directly followed by another character, the selected
  390. keystroke is sent directly to your application, without showing the help
  391. screen.
  392.  
  393. ANSI escape sequences for cursor movements are mapped to their corresponding
  394. arrow key.
  395.  
  396. All characters, except Esc, are translated directly to the corresponding
  397. keystroke.  ASCII 01H is translated to Ctrl-A, ASCII 02H to Ctrl-B and so
  398. on.
  399.  
  400. To emulate Shift, Ctrl and Alt function keys, you have to first select which
  401. mode you want by pressing Esc-s, Esc-l resp. Esc-a first followed by the
  402. appropriate function key Esc-code.  In the upper right corner of the help
  403. menu the current state of the function keys is written.
  404.  
  405. The above table means that you should press Esc FIRST and THEN a
  406. character.  "Esc-i" means that you should press "Esc" first and then
  407. followed by "i".  Note that you have to press "Esc" twice, if you want
  408. to emulate a "Esc" keystroke.
  409.  
  410.  
  411.  
  412.  
  413.  
  414. Task list
  415. =========
  416. By pressing Esc-tab (first <Esc> and then <Tab> 1bH, 09H) you will get
  417. a list of programs currently running.  It might look like this:
  418.  
  419. Os2You Task List
  420. ================
  421. A  Switch to
  422. B  OS/2 window
  423. C  OS/2 window
  424. D  Group - Applications
  425. E  Group - Bookshelf
  426. F  Group - Utilities
  427. G  Group - Toolkit Editors
  428. H  Group - Compilers
  429. I  Group - Communication
  430. J  M2ZMODEM.EXE
  431. K  Os2You.EXE
  432. L  TS.EXE
  433. M  Group - Main
  434. N  PM Diary
  435. O  Desktop Manager
  436. >  Next entries
  437.  
  438. Z  Return to original session
  439.  
  440.  
  441. The task list displayes all running programs.  If the list is too long
  442. for the screen, you may scroll up and down with the '<' and '>' keys.
  443. You enter the character displayed before the program you want to switch
  444. to.  If you want to return to the original session (the one you started
  445. from) you should select 'Z'.
  446.  
  447. You can only switch to programs running in an OS/2 full screen text
  448. session.  If you try to switch to another session, you will get an
  449. error message.  If you run another session than your original one,
  450. some limitations will exist.  The screen size is assumed to 80 columns
  451. and 25 rows, and is not adjusted to the real size of the running session
  452. On some VERY unusual conditions the program won't be able to figure out
  453. if the program is running in monochrome or color mode.
  454.  
  455. Note that the session you select is switched to the foreground at the
  456. host machine, and will interrupt any user running another session at
  457. the machine from the keyboard.  It will also interrupt any other user
  458. running the same host through Os2You running other session than their
  459. original session.  The session you selected should NOT be switched to
  460. the background, while you are connected to it, as you will lose all output
  461. from the connected session, while running in the background.
  462.  
  463. The task switcher requires OS/2 1.2 or compatible to work.
  464.  
  465.  
  466.  
  467.  
  468.  
  469. File transfer
  470. =============
  471. If you have M2Zmodem version 2.09 or later (another program from the
  472. same source), you may use it to up/download between the host and remote.
  473. This solution also allows auto Zmodem uploads.  I suggest that you copy
  474. the M2Zmodem.EXE and M2Zmodem.MSG-files into the same directory you used
  475. for Os2You.  Then you should include this directory in your PATH and DPATH.
  476.  
  477. It is now possible to receive files from host to remote (download) by just
  478. typing "Sz <files>" at the command prompt (any wildcards allowed).  If you
  479. run LanTerm/2 or LanTerm as terminal program at the remote (or any other
  480. terminal program with Zmodem autodownload), the file transfer will be
  481. automaticly started at the terminal side too, if not, you have to request
  482. download in your terminal program.
  483.  
  484. If you use LanTerm (for DOS), you should get DSZ file transfer program
  485. (shareware from Omen Technology).  If you use LanTerm/2 (for OS/2), you
  486. should get M2Zmodem file transfer program (shareware from the same place
  487. you got Os2You).  Both programs should be installed in the same directory
  488. as LanTerm(/2), or in a directory specified in your path.
  489.  
  490. To send files from remote to host (upload) just type "Rz" at the command
  491. prompt.  When you request upload in your terminal program, you should enter
  492. which files to send.  If you have called your receive batch file "Rz.Cmd"
  493. you don't even have to start the batch file before starting your send
  494. procedure, because the Rz command is executed automaticly by the Zmodem
  495. initializing procedure, if you are at the command line when you start the
  496. send procedure (auto Zmodem download).
  497.  
  498. The described configuration uses the fast and reliable Zmodem protocol for
  499. file transfers.  If you want to use another, like Xmodem, Xmodem-1K, Ymodem
  500. or Ymodem-G, you could just alter the CMD-files to change your protocol.
  501. The parameters for M2Zmodem are described further in the M2Zmodem.DOC file,
  502. or written to screen, if you just enter M2ZModem at the command prompt.
  503.  
  504. If you don't know how to get M2Zmodem, you could send a formatted diskette
  505. and four International Post reply coupons (Coupon-Réponse International,
  506. Union Postale Universelle) to my address mentioned last in this documentation.
  507.  
  508.  
  509.  
  510.  
  511. DOS-compatibility box
  512. =====================
  513. When you run the OS/2 session remote, you may enter the command
  514. "Dos2You" at the command line, and you will get access to the DOS-box
  515. (if available).  Note that any user running at the physical screen
  516. will be interruptet when the DOS-box is entered.  The cursor position
  517. won't be set correctly when running the DOS session.
  518.  
  519. Dos2You requires OS/2 version 1.2 or later, and the DOS.SYS driver must
  520. be loaded.
  521.  
  522. Note that your AUTOEXEC.BAT file should NOT contain any statements that
  523. would require any keyboard input, as the Dos2You program gets control of
  524. the DOS-box AFTER the AUTOEXEC.BAT file is executed, which means that any
  525. user input in the AUTOEXEC.BAT is taken from the "real" keyboard.
  526.  
  527. To enable Dos2You, you should copy the DOSREDIR.EXE file to a directory
  528. in your DOS-path, or load the DOSREDIR-program in your AUTOEXEC.BAT file.
  529. The DOSREDIR-program is a resident program that will communicate with the
  530. Os2You-program, allowing Os2You to control the DOS session.  The DOSREDIR
  531. program requires that a printer port is installed in the system, and will
  532. demand IOPL (put the line "IOPL=YES" in your CONFIG.SYS file).  The DOSREDIR
  533. program MAY conflict with the printer stream, but should not cause any other
  534. serious conflicts in your system.
  535.  
  536. The keyboard won't accept extended keycodes (like function keys).
  537.  
  538. When returning from the DOS-box you have to press Esc-P to reset Os2You to
  539. not use the physical screen area.  No extended keys like function keys will
  540. work in the DOS-box.
  541.  
  542.  
  543.  
  544.  
  545. Configuring modem
  546. =================
  547. Os2You used the Data Carrier Detect (DCD) signal to detect an incoming
  548. call.  You should ensure that your modem and cable is configured to
  549. reflect the true status of DCD.
  550.  
  551. If you configure Os2You for an automatic (HAYES) modem, Os2You looks at
  552. the file MODEM.PRM for different commands.  Os2You uses the following
  553. commands:
  554.  
  555.     Initializing (should put modem into auto answer)
  556.     Shutdown (sent before Os2You exits)
  557.     No auto answer (sent when Os2You wants to prevent incoming calls)
  558.     Dial command prefix (sent to trigger dial command)
  559.     Dial command suffix (sent after phone number to finish dial command)
  560.     Hang up (sent to put line on hook)
  561.  
  562. The command string may not containg any ";"-characters as this marks
  563. beginning of comments.  The following special characters may be used
  564. in modem command strings:
  565.  
  566.     ^ (5eH)    Send a CR
  567.     ~ (7eH)    Pause for one second
  568.     ≥ (f2H)    Lower DTR signal
  569.     ≤ (f3H)    Restore DTR signal
  570.     ; (3bH)    Comment
  571.  
  572. If Os2You is configured for an automatic mode and MODEM.PRM is not present
  573. Os2You will use default commands suitable for HAYES compatible modems.
  574.  
  575.  
  576.  
  577. Defining your own terminal
  578. ==========================
  579. If your terminal is not supported by a terminal definition file, you may
  580. create your own by starting OS2YOU without any parameters and select
  581. "Terminal definitions" in the configuration menu displayed.  The program
  582. will ask for a file name for the terminal  definition file.  Enter the
  583. the terminal definition file you want to create or alter.  The program
  584. will show a menu with different terminal setting. When not otherwise stated
  585. you should enter the hexadecimal values separated by spaces (max 20 values)
  586. corresponding to the ASCII-code for the characters to be sent.  Note that
  587. ALL values should be give in HEX-form (spaces will be replaced by under-
  588. score characters).
  589.  
  590. The program asks for the following:
  591.  
  592. 1. Initializing string.  String to initialize the terminal to selected
  593.    mode.  In most cases should this string be left blank.
  594.  
  595. 2. Cursor position; command.  String to begin a cursor position command.
  596.  
  597. 3. Cursor position; separator.  String to separate row and column
  598.    parameters in cursor position command.
  599.  
  600. 4. Cursor position; end.  String to end cursor position command.
  601.  
  602. 5. Cursor position; column first.  Select 'Yes' if the column should be sent
  603.    as the first parameter, otherwise enter 'No', and the row will be sent
  604.    first.
  605.  
  606. 6. Cursor position; column offset.  Value with which the column is added
  607.    with, before the cursor position command is sent.  The left most column
  608.    is treated as column 0.
  609.  
  610. 7. Cursor position; row offset.  Value with which the row is added
  611.    with, before the cursor position command is sent.  The top row is
  612.    treated as row 0.
  613.  
  614. 8. Cursor position; binary address.  Select 'Yes' if the row and column
  615.    parameters should be sent as binary values, using one byte each.
  616.  
  617. 9. Cursor position; maximum parameter length.  Enter the length the
  618.    row and column parameters may be assigned at most.  This value should
  619.    be set to 1 if binary address is selected.
  620.  
  621. 10.Cursor position; zero pad Col and Row parameters.  Select 'Yes' if
  622.    the row and column parameters should be padded with leading zeros
  623.    up to the length indicated by the above parameter.
  624.  
  625. 11.Scroll screen up; init string.  String sent to initiate a scroll
  626.    operation.
  627.  
  628. 12.Scroll screen up; each row.  String sent following the init string
  629.    to scroll the screen up one row each time.  It doesn't matter if
  630.    the cursor is moved during this command, as the cursor position will
  631.    be restored automaticly by the program. If no special scroll command
  632.    is available with your terminal, you should enter a string that places
  633.    the cursor at the bottom row, and advance one row.
  634.  
  635. 13.Clear to end of line.  String sent to clear the remaining (or all)
  636.    of the line the cursor is positioned at.  The line should ONLY be
  637.    cleared, NOT deleted.  Currently it doesn't matter if the whole line
  638.    is cleared, or only the end of it.
  639.  
  640. 14.Clear screen.  String sent to clear the entire screen, and position
  641.    the cursor at the home (upper left) position.
  642.  
  643. 15.Use ANSI colors.  Set to YES if you want Os2You to send color attributes
  644.    with ANSI escape sequences.  If set to NO, no color information will be
  645.    transfered.
  646.  
  647. 16.Strip control characters.  Set to YES if you want Os2You to replace all
  648.    visible control characters (between 0 and 31) on the host screen with
  649.    space characters instead.  This is usable if you use a terminal that
  650.    won't display control characters, but treat them as control information.
  651.  
  652. 17.Strip high order characters.  Set to YES if you want Os2You to replace
  653.    all high order characters (between 127 and 255) on the host screen with
  654.    space characters instead.  This is usable if you use a terminal that
  655.    does not support the PC character set, or if you use 7 databit connections.
  656.  
  657. Some terminals require a short "breath" after some commands like
  658. clearing the screen and positioning the cursor.  This may be
  659. accomplished by entering trailing zeros after the command strings.
  660. Os2You will send these null characters, but your terminal will
  661. in most cases ignore these characters and get their pause.
  662.  
  663.  
  664.  
  665.  
  666. Command line options
  667. ====================
  668. If you want to start the program from the OS/2 Command prompt without
  669. the phone answering capabilities, or want to call the program from
  670. your own application, the program is started with some parameters.
  671. The program may use a "hot" file handle (already opened).
  672.  
  673. It is the callers responsibility to set the communication port as
  674. wanted, and Os2You will use the current settings when called.
  675.  
  676. When the program exits, it restores the communication port to it's previous
  677. state.  If a program was successfully spawned the program will exit with
  678. Exit-code set to zero.  If the program failed by any reason, the Exit-code
  679. will be set to a non zero value.
  680.  
  681. The parameters may be entered at the command line or/and set in the
  682. environment variable "OS2YOU".  If both the environment variable and
  683. a command line is entered, the environment variable will be parsed first
  684. and the command line after that, making command line parameters override
  685. any settings in the environment variable.  The environment variable is
  686. set by the "SET OS2YOU=xxx xxxx xxxx xxx" command.  The following parameters
  687. are available (note that they should be lower case).
  688.  
  689. -c    <fname>   Use the configuration file <fname>.  This option is only
  690.                 valid if you use the HOST-mode or callback processing.
  691.                 Default is "OS2YOU.CFG".
  692.  
  693. -d              Do NOT detect carrier loss.  Normally the program monitors
  694.                 the carrier and close the remote session if carrier is lost.
  695.                 By adding this parameter you override this beaviour.
  696.  
  697. -e    <fname>   Execute program <fname> for the remote session (typically
  698.                 CMD.EXE).  This parameter is the last one read by Os2You.
  699.                 All following parameters are sent to the called program.
  700.                 Default is "CMD.EXE".
  701.  
  702. -f    <decint>  Delay between screenupdates with <decint> milliseconds.
  703.                 Default is 100 mSecs (0.1 seconds).
  704.  
  705. -i    <decint>  Exit if keyboard inactive in <decint> seconds.  If set
  706.                 to zero no inactivity timeout is used.  Note that only
  707.                 the keyboard activity is monitored, and that the inactivity
  708.                 counter is active even if the screen alters.
  709.                 Default is zero (no inactivity counter).
  710.  
  711. -l    <dname>   Use device <dname> for communication.  If <dname> is
  712.                 replaced by a percent sign and a decimal value (for
  713.                 example "%5"), the program will use the device handle
  714.                 (5 in the example) for communication.  The program may
  715.                 also use pipes handles for communication.
  716.                 This parameter has no default value, and if the parameter
  717.                 is omitted, the program will start up in HOST mode.
  718.  
  719. -n    <uname>   Use parameters for user <uname> in the configuration file,
  720.                 including callback processing to <uname>.  This parameter
  721.                 is only valid if you do NOT start the program in HOST mode.
  722.                 If you want to include spaces in the <uname> you should
  723.                 replace the space by an underscore "_", or surround the
  724.                 parameter with double quotes.
  725.                 Default is to not use any entries in the configuration
  726.                 file.
  727.  
  728. -p              Use physical screen area for remote.  If this parameter
  729.                 is specified the program will use the physical screen
  730.                 area for remote, and NOT the screen area owned by the
  731.                 session.  If this parameter is specified you can't use
  732.                 the "-s" parameter.
  733.                 Default is to use the session screen area.
  734.  
  735. -prty <decint>  Screen update priority <decint> 0-39.  This parameter
  736.                 sets the priority for the remote screen update thread.
  737.                 Zero is the lowest priority and 39 the highest.
  738.                 Priority 0-9 executes with IDLE priority, 10-19 has
  739.                 REGULAR priority, 20-29 HIGH priority and 30-39 TIME
  740.                 CRITICAL priority.  If priority is set to 14 the screen
  741.                 update thread has the exact same priority as the executed
  742.                 program.
  743.                 Default is 14 giving the update thread exactly the same
  744.                 priority as the executing program.  Setting the priority
  745.                 to a higher value (15) may result in smother operation.
  746.  
  747. -s              Disable the built in task switcher and physical screen.
  748.                 If you don't want the remote user to be able to switch
  749.                 between running tasks, you should disable this feature.
  750.                 If this parameter is specified you can't use the "-p"
  751.                 parameter.
  752.                 Default is to enable the task switcher.
  753.  
  754. -t    <fname>   Use terminal definition file <fname>.  The file extension
  755.                 ".PRM" is added if no extension is included.
  756.                 This parameter has no default value, instead the program
  757.                 has a built in table for ANSI terminal emulation.
  758.  
  759. Examples:
  760.  
  761. Os2You -l COM1 -f 1000 -i 300 -e CMD.EXE /K DIR
  762.  
  763. This command will tell Os2You to use COM1 and update the screen each 1000
  764. millisecond.  If no remote keystroke is received within 300 seconds the
  765. program will be forced to exit.  CMD.EXE is loaded for remote operation
  766. with the parameters "/K DIR" (which will tell CMD.EXE to display a
  767. directory list).
  768.  
  769. Os2You -l %4 -f 100 -i 0 -d -e CMD.EXE
  770.  
  771. This command will tell Os2You to use device handle 4 (decimal value) and
  772. update the screen each 100 millisecond.  If carrier i lost the program will
  773. be terminated. but no inactivity timer is set.
  774.  
  775. Os2You -l %4 -f 100 -i 0 -d -n Mikael_Wahlgren
  776.  
  777. This command is similar to the previous example, except that the program
  778. will spawn the program and use the parameters indicated by the username
  779. "Mikael Wahlgren" in the configuration file.  By using the "-n" option it
  780. is possible to spawn different session depending on username.
  781.  
  782.  
  783. To be compatible with MaxPipe (TM of Peter Fitzsimmons) an alternate calling
  784. syntax is automaticly invoked, if the first parameter does not begin with a
  785. minus sign "-".  In this case, the syntax will be like:
  786.  
  787. Os2You <device> <programname> <parm1> ... <parmN>
  788.  
  789. <device>            Tells which communication device to use.  It is
  790.                     possible to pass a "hot" device handle by replace
  791.                     the device name with a number corresponding to a
  792.                     the device handle decimal coded (like %4).  The
  793.                     device name may be replaced by a pipe name, but special
  794.                     care should be taken, when using this possibility.  The
  795.                     best choice when using pipes is to use the stand alone
  796.                     interface.
  797.  
  798. <programname>       Tells which program to load for remote operation.
  799.                     (Typically CMD.EXE).
  800.  
  801. <parm1> ... <parmN> The remaining parameters are optional and are passed as
  802.                     parameters to <programname>.
  803.  
  804. All other values are set to their default when using this syntax.
  805.  
  806.  
  807. To select which communication parameters to use, you should use the MODE-
  808. program, included with the operating system.  See more in the documentation
  809. for the operating system to see how to configure your communication line.
  810. All communication parameters set with MODE, will be used with Os2You.
  811.  
  812. Example:
  813.  
  814. MODE COM1:2400,N,8,1,OCTS=ON,DTR=ON,RTS=HS,BUFFER=ON
  815.  
  816. This command will tell Os2You to use baud rate 2400, no parity, 8 data bits,
  817. 1 stop bit, hardware handshaking CTS/RTS and use the extended hardware
  818. buffering capabilities.
  819.  
  820.  
  821. If you want to install Os2You with Maximus (TM) BBS, these lines may be of
  822. help:
  823.  
  824. UsrRemote Xtern_Run \OSB\OS2YOU.EXE_-l_%P_-f_1000_-i_300_-t_ANSI Sysop "/OS-2"
  825.  
  826. Update delay 1 second, inactivity timeout 300 seconds, terminal ANSI, spawn
  827. a CMD.EXE session.
  828.  
  829.  
  830. UsrRemote Xtern_Run \OSB\OS2YOU.EXE_-l_%P_-e_MyProg.EXE Sysop "/OS-2"
  831.  
  832. Use Os2You defaults, spaw program "MyProg.EXE".
  833.  
  834.  
  835.  
  836.  
  837.  
  838. Multi user configuration
  839. ========================
  840. By using Os2You you may actually use OS/2 in a multi user like manner.  Note
  841. that Os2You lacks any sort of security control for file managing, which a
  842. "normal" multi user operating system includes.
  843.  
  844.  
  845.  
  846.  
  847. Compatibility with other programs
  848. =================================
  849. The following programs are tested and seems to work with Os2You.  Note
  850. that some tests was rather brief and compatibility is not guaranteed
  851. (if not other noted, programs are OS/2 versions):
  852.  
  853. CMD.EXE 1.30 (IBM OS/2 1.30) and all full screen programs included with OS/2
  854. Brief 3.0
  855. JPI TopSpeed environment and VID
  856. MS C 6.00, PWB and other compiler components (CVP program output fails)
  857. Hack 1.03
  858. NetHack 3.0
  859. IBM Lan Server 1.3 (NET-program)
  860. M2Zmodem
  861. TE/2
  862. Logicomm
  863. Ckoker (Kermit)
  864. Os2You (and included programs like LanTerm and LanTerm2)
  865. MsgEd 2.06
  866. Binkley term 2.30
  867. Ommm 1.40
  868. ConfMail 2.0/3.31
  869. Mountain FileSafe streamer software
  870. PKZip 1.02 (and included programs)
  871. Zoo 1.51
  872. LHarc 1.13
  873. DDump 0.01 hex editor
  874.  
  875.  
  876. The following programs are tested and do NOT work with Os2You:
  877.  
  878. Lotus 1-2-3 3.0 (keyboard input works but no screen output)
  879.  
  880.  
  881. Note:  The above programs are trademarks of their respective company.
  882.  
  883.  
  884.  
  885.  
  886. Commonly asked questions and problems
  887. =====================================
  888. Q1.  What terminal program should I use to communicate with Os2You and which
  889.      terminal emulation mode?
  890.  
  891. A1.  For the best possible emulation, you should use the included LanTerm
  892.      (for DOS) or LanTerm2 (for OS/2).  If you want to use your favourite
  893.      terminal program you should select ANSI-BBS emulation if it is available
  894.      and the built in or ANSI.PRM terminal mode in Os2You.
  895.  
  896. Q2.  When started in HOST-mode and modem, Os2You loops around, asking
  897.      for <Enter> and eventually logon parameters, even if no user are
  898.      calling.
  899.  
  900. A2.  Os2You relies entirely on the DCD (Data Carrier Detect) signal on
  901.      the RS232-interface to reflect the real carrier state.  DCD is a signal
  902.      that tells the computer that the modem is connected to another modem.
  903.      You have to verify that the signal on the RS232 interface is connected
  904.      to the signal at the modems interface, and that the modem is configured
  905.      to reflect the real carrier state.
  906.  
  907. Q3.  When logging on to Os2You HOST mode, I first get a lot of garbage
  908.      characters, before I get the "Press Enter" message.
  909.  
  910. A3.  This is normal, if you have configured Os2You for multiple baud rates.
  911.      Os2You tries to find the correct baud rate for you.
  912.  
  913. Q4.  When logging on to Os2You HOST mode, the modems RD (Receive Data)
  914.      signal is blinking all the time, even when nothing appears on the
  915.      screen.
  916.  
  917. A4.  This is normal.  Os2You continously sends characters to the remote
  918.      when logging on, of technical reasons.
  919.  
  920. Q5.  The screen doesn't scroll correctly.
  921.  
  922. A5.  Scrolling has proved to be the hardest part to implement.  This has
  923.      to do with the fact that the Os2You program has no way to find out
  924.      how many lines your terminal program on the remote has.  The built
  925.      in ANSI driver in Os2You sends a command to move the cursor down
  926.      999 lines and sends a LF.
  927.  
  928.      If the built in ANSI terminal doesn't work, you should modify ANSI.PRM
  929.      (or the terminal definition file that is appropriate for your terminal),
  930.      and alter the scroll sequences.
  931.  
  932. Q6.  Background colors are not displayed correctly at the remote screen,
  933.      using ANSI colors.
  934.  
  935. A6.  When Os2You sends a ClrEol (Clear to end of line) sequence, it
  936.      assumes that the line is cleared with the attribute currently in
  937.      use.  This is how it works in the ANSI driver for OS/2.  Some terminal
  938.      emulators though, fill the cleared line with the standard attribute
  939.      in opposite to the currently used attribute.
  940.  
  941. Q7.  When running some programs, I don't get any output from it.
  942.  
  943. A7.  Os2You is not compatible with programs running in Presentation
  944.      Manager.  Some programs running in OS/2 full screen text sessions
  945.      require the physical screen buffer.  Those programs won't be
  946.      100% compatible with Os2You, but you might to be able to run the
  947.      program if you use the task switcher and switch to the offending
  948.      program, as programs selected by the task switcher will run in
  949.      the foreground and have the physical screen adressable.
  950.  
  951. Q8.  When running some programs, I get output from the program, but
  952.      the keyboard doesn't seem to work.
  953.  
  954. A8.  The programs keyboard handling is not compatible with Os2You.  Please
  955.      report the problem to me, and if possible, send a copy of the offending
  956.      program.
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965. RELEASE NOTES
  966. =============
  967. Only bugs and improvements not described elsewhere are documented
  968. in this section.
  969.  
  970. 1.0:  First release.
  971.  
  972. 1.1:  The program could terminate with a GP error when run on a PS/2
  973.       system.  The port-parameters was not correctly restored.  This
  974.       is now corrected.
  975.  
  976. 1.2:  Improvements
  977.  
  978. 1.3:  Improvements
  979.  
  980. 1.4:  Improvements
  981.  
  982. 1.5:  Bug, that made the program incompatible with some programs
  983.       (especially programs polling the keyboard) is fixed.
  984.  
  985. 1.6   Improvements
  986.  
  987. 1.7   Some scancodes adjusted to make the CTRL-key, Enter-key and some
  988.       other special keys more compatible with some programs.
  989.  
  990.       The command line syntax is altered.
  991.  
  992. 1.8   LAN/Pipe operation fixed again.  Previous LanTerm2 didn't work
  993.       due to a serious compiler bug.
  994.  
  995.       The configuration file is opened in "Deny Write" mode for security
  996.       reasons.  This makes it impossible to modify the configuration file
  997.       during an session.
  998.  
  999. 1.9   The "Allow Task Switch" option in the login table is now used
  1000.       to disable the task switch and the Break-functions.
  1001.  
  1002.       If the "-s" option is used or "Allow Task Switch" option is
  1003.       set to NO in the user profile, the user won't be able to use
  1004.       the Esc-c, Esc-Break sequences (to end the session abnormally).
  1005.  
  1006.       Now Break scancodes are also sent.
  1007.  
  1008.       Lanterm.EXE (LAN-operation for DOS workstations) are now included
  1009.       again.
  1010.  
  1011.       Better shutdown operation, when a program gets stuck, or user lost
  1012.       carrier.  REXX-sessions are shutdown correctly.
  1013.  
  1014.       Terminal configurable in user table.
  1015.  
  1016.       The configuration file is optionally (configurable) opened in
  1017.       "Deny Read/Write" mode.
  1018.  
  1019. 1.91  Fix to get the program work with LAN Server 1.2 CSD 4093 and
  1020.       DOS Requesters.  Also tested successfully using Novell server
  1021.       and remote named pipes.
  1022.  
  1023.       LanBridge added, to run OS/2 LAN Requesters remote over LAN.
  1024.  
  1025.       If program can't be killed, when exiting the session, Os2You will
  1026.       go back to login screen.  Next user will probably get confused,
  1027.       because the previous program is still alive.
  1028.  
  1029.       "-s" (disable task list) is default when using MaxPipe parameter
  1030.       syntax.
  1031.  
  1032.       LanTerm and LanTerm2 programs are altered, to change the behaviour
  1033.       of the Esc-key.  If the Esc-key in LanTerm(/2) is pressed the program
  1034.       will send double Esc-codes making Os2You send one Esc-sequence to the
  1035.       application.  If you press Shift-Esc in the LanTerm(/2) program will
  1036.       send just one Esc-code, making Os2You to wait for an Esc-sequence (or
  1037.       displaying the help screen).
  1038.  
  1039. 2.0   Color attributes are now transfered to the remote screen, by using
  1040.       ANSI color escape sequences.  It is default to use ANSI colors when
  1041.       no terminal definition file or an old definition is loaded.  To
  1042.       upgrade your old terminal definition files, select terminal definition
  1043.       from the Os2You menu, and modify the ANSI color entry.  Your other
  1044.       definitions will be intact.
  1045.  
  1046.       The screen update handling is altogether rewritten.  In some respects
  1047.       it is faster, but in some situations it might also be slower than
  1048.       before.  The terminal does not need to wrap at end of lines anymore.
  1049.       The program now supports different screen widthes and heights.  The
  1050.       program assumes that you are running the application in color mode
  1051.       (two bytes per character cell).  If this is not the case, the program
  1052.       will transfer false attributes (converting underline/highlights to
  1053.       colors).
  1054.  
  1055.       The "-n" option now allows Os2You to directly spawn different
  1056.       sessions depending on the username.  The callback, shell, terminal
  1057.       and switch parameters are used from the login table.
  1058.  
  1059.       The COM-buffers are flushed by reading all available characters, in
  1060.       addition to a DosDevIOCtl call, as the DosDevIOCtl call didn't seem
  1061.       to work in some networking environments.
  1062.  
  1063.       The option to strip control characters (0-31) and high order
  1064.       characters (127-255) are added in the terminal definition file.
  1065.       The default, if no terminal definition file or an old definition
  1066.       is used, is to strip control characters but leave high order
  1067.       characters.
  1068.  
  1069.       LanTerm/2 (for OS/2) and LanTerm (for DOS) are modified to accept
  1070.       COM-ports from the command line.  Both program can be started with
  1071.       the syntax "LanTerm <COM-port> <baudrate>".  The COM-port must have
  1072.       a name beginning with "COM", and for the DOS-version only COM1 and
  1073.       COM2 are valid.  LanTerm (for DOS) requires that ANSI.SYS is loaded
  1074.       in your CONFIG.SYS file.  Both programs take advantage of the FIFO
  1075.       buffered 16550 UART if available.
  1076.  
  1077.       LanTerm/2 and LanTerm now have Zmodem AUTO download/upload capability.
  1078.       To transfer files between host and remote, just issue a file transfer
  1079.       command on the host (use the Rz or Sz command files and M2Zmodem), and
  1080.       the file transfer program will start on both host and remote.  If
  1081.       you upload from remote to host, you will asked for a filename/pattern.
  1082.       LanTerm/2 uses M2Zmodem, and LanTerm uses DSZ as file transfer
  1083.       programs, and these programs much be available in the current
  1084.       directory or in a path.
  1085.  
  1086. 2.1   Fixed bug that left shifted the remote screen one column in some
  1087.       situations.
  1088.  
  1089.       Modem commands now configurable and stored in file MODEM.PRM.
  1090.  
  1091.       Box draw characters and special characters are translated into
  1092.       available "look alike" characters (codepage 437), when terminal
  1093.       definition file says to filter characters between 127-255.
  1094.  
  1095.       Keyboard emulation much enhanced with correct scan codes.  Now
  1096.       works with programs like CodeView (TM) and MSC PWB.
  1097.  
  1098.       Dos2You program altered to exit by sending a Ctrl-C (03H).  Program
  1099.       now exits "clean" and returns to Os2You correctly.
  1100.  
  1101. 2.2   DTR control added in modem commands.
  1102.  
  1103.       Fixed bug that sent garbage modem commands, when modem commands
  1104.       was of zero length.
  1105.  
  1106.       LanRel program addedd, to let other programs temporarily suspend
  1107.       Os2You HOST-mode, to let other communication programs use the
  1108.       same port/modem, while Os2You is waiting for an incoming call.
  1109.       It is also possible to use LanTerm or LanTerm2 to access the
  1110.       port for outgoing traffic port Os2You is using, by running these
  1111.       programs with the port request pipe name as a parameter.
  1112.  
  1113.       Os2You now also acts as asynchronous communication server.  IF
  1114.       Os2You is installed on a network, it is possible to connect to
  1115.       the COM device Os2You uses, with Lanterm(2) programs, by starting
  1116.       these program with the port request pipe name as a parameter.
  1117.       File transfer doesn't work though.
  1118.  
  1119.       Cursor positioning works even if you don't run your original
  1120.       session.
  1121.  
  1122.       M2Zmodem would hang Os2You and COM-device on some systems
  1123.       (like Comp. 386/SX 20 Mhz and MS-OS/2 1.21).  This wasn't
  1124.       fixed in the preliminary release.
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130. Planned enhancements
  1131. ====================
  1132. The following is a list a enhancements planned in a future release.  It
  1133. isn't sure that the next release of the program will include these
  1134. enhancements though.  Any adjustments necessary for Os2You to work
  1135. with OS/2 2.0 will be made, when OS/2 has been released.
  1136.  
  1137. 1.  The DOS-box will be improved when OS/2 2.0 is out.  No further effort
  1138.     to improve the DOS-box before that will be made, as the method probably
  1139.     will have to be changed anyhow.
  1140.  
  1141. 2.  LanTerm and LanTerm2 will have autodial, dialling directory and auto
  1142.     login.
  1143.  
  1144. 3.  M2-Zmodem file transfers will work with pipes as well.
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150. Copyright notes
  1151. ===============
  1152. OS/2     is a trademark of IBM Corporation.
  1153. PS/2     is a registered trademark of IBM Corporation.
  1154. IBM      is a registered trademark of International Business Machines
  1155.          Corporation.
  1156. DSZ      is a trademark of Omen Technology Incorporated.
  1157. 386/SX   might be a trademark of Intel Corporation.
  1158. Novell   is a trademark of Novell Inc.
  1159. Hayes    is a trademark of Hayes Microcomputer Products.
  1160.  
  1161.  
  1162.  
  1163. Important license information
  1164. =============================
  1165. It is illegal (or at least unethical) to patch the program in any way.
  1166. Any reverse engineering (disassembling or monitoring) is not an approved
  1167. use of the application.
  1168.  
  1169. If you register the software with at least 300 SEK (about $50), you will
  1170. get a license file and a copy of the most recent version of the program.
  1171. In this case, you will also get rid of the registration screen during logon.
  1172. In the future this registration file may enable features in the program
  1173. not available in unregistered configurations, but currently all functionality
  1174. is available in unregistered copies.  Note, that the registration file you
  1175. get is valid for any future release of this program, and that you will
  1176. be treated as registered to any future release.
  1177.  
  1178. If you use the program on a regular basis, or in commercial use, you must
  1179. register with minimum the above mentioned sum for each machine running
  1180. the Os2You program.  The LanTerm, LanTerm2 and LanBridg programs don't
  1181. need any further registration, and may be used in unlimited instances, but
  1182. an extra registration per each 20th instance of LanTerm or LanTerm2 is
  1183. appriciated.
  1184.  
  1185. The sourcecode (in Modula-2 and C) of the program is available,
  1186. on special terms.  Please contact me if this is of interest.
  1187.  
  1188. You are encouraged to spread this program (without registration file)
  1189. to anyone that might be interested.
  1190.  
  1191. If you want to register, send swedish banknotes, bank cheque or let bank
  1192. transfer money to my account by SWIFT (note that you should send all money
  1193. in swedish currency).
  1194.  
  1195. ╔═══════════════════════════════╦═══════════════════════════════════════╗
  1196. ║  My bank account is:          ║  My address is:                       ║
  1197. ╠═══════════════════════════════╬═══════════════════════════════════════╣
  1198. ║  Account no: 414 46 44-4      ║  Mikael Wahlgren                      ║
  1199. ║  PostGirot Sweden Inter.      ║  Kransen 4E                           ║
  1200. ║  S-105 06 STOCKHOLM           ║  S-416 72  GOTHENBURG                 ║
  1201. ║  Sweden                       ║  Sweden                               ║
  1202. ║                               ║                                       ║
  1203. ║  SWIFT: PGSI SE SS            ║  Fidonet: Mikael Wahlgren 2:203/302.5 ║
  1204. ║  Telex: 10185 pgint S         ║  Internet: d9mikael@dtek.chalmers.se  ║
  1205. ╚═══════════════════════════════╩═══════════════════════════════════════╝
  1206.  
  1207.