home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 2 / ctrom_ii_b.zip / ctrom_ii_b / OS2 / DATACOM / PM2UB12 / OS2YOU.INF (.txt) < prev    next >
OS/2 Help File  |  1993-11-06  |  80KB  |  2,506 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Why you should register this product ΓòÉΓòÉΓòÉ
  3.  
  4. Why you should register this product 
  5.  
  6.  This program is released as shareware. This means that you have the software 
  7. for a trial period, and after a reasonable evaluation time, you register the 
  8. product by paying a fee to the author, if you find the program of use.  Some 
  9. limitations on how you can use this program exists (see the section Important 
  10. license information for more about this).  By registering this product you 
  11. support the further development of this program.
  12.  
  13.  You will get the following benefits if you register: 
  14.  
  15. o You will get the most recent versions of Os2You and M2Zmodem. 
  16.  
  17. o You will get rid of the introduction screen with the delay, when logging on 
  18.   to the host. 
  19.  
  20. o You will get a utility making it possible for Os2You to use baudrates as high 
  21.   as 38400, 57600 or 115200 bauds, using the standard communication device 
  22.   drivers included with OS/2. 
  23.  
  24. o You will be sleeping good tonight, without any bad conscience haunting you... 
  25.  
  26.  
  27. ΓòÉΓòÉΓòÉ 2. Introduction ΓòÉΓòÉΓòÉ
  28.  
  29. Introduction 
  30.  
  31.  Os2You is a communication software allowing remote operation of any OS/2 full 
  32. screen text session or DOS full screen text session, over an asynchronous line 
  33. (by cable or modem), NetBIOS session, a pipe or a remote pipe (over a LAN). 
  34. The program can be used with many different terminals and allows high speed 
  35. file transfers between host and remote.  The program may be used in two 
  36. different ways.  You can run the program as it is stand alone, but it is also 
  37. possible to call the program from your own program, allowing your own programs 
  38. to offer remote operation. 
  39.  
  40. Some different ideas on how to use Os2You: 
  41.  
  42. o Installed on your office PC, it is possible to run the PC and access the 
  43.   files from your home using a PC, LapTop or even a simple terminal. 
  44.  
  45. o Installed in a BBS, it is possible to run most character based programs 
  46.   on-line in the BBS (like on-line games), or run maintenance programs. 
  47.  
  48. o Installed in a LAN with NetBIOS, it is possible to mirror the output of an 
  49.   OS/2 machine to any amount of terminals over a network (classroom operation). 
  50.  
  51. o Installed in a LAN, it is possible to run programs on different machines on 
  52.   the network. This makes it possible for DOS requesters to run OS/2 character 
  53.   applications without installing OS/2 on them. 
  54.  
  55. o Installed in a LAN, it is possible to access asynchronous ports for outgoing 
  56.   traffic both from OS/2 and DOS requesters, using included programs, or any 
  57.   character based OS/2 communication package. 
  58.  
  59. o Installed on your customers systems, it makes it easy for you to service 
  60.   these by running their system on-line. 
  61.  
  62. o You could turn your OS/2 machine into a multi-user system, except that you 
  63.   might miss some security control, normally available on multi-user systems. 
  64.  
  65. The program can directly replace the program MaxPipe (from Peter Fitzsimmons), 
  66. and will be compatible with more programs than MaxPipe. 
  67.  
  68. The program is only tested with OS/2 1.3 and OS/2 2.0, but should work OK with 
  69. OS/2 1.2.  It does NOT work with OS/2 1.0.  There is a special limited release 
  70. of Os2You, that can be run on OS/2 1.1 with or without Presentation Manager. 
  71. This can not do task switching, and is only distributed on special request. 
  72.  
  73. If you have got the distribution files packed in a ZIP-file, you should unpack 
  74. them first.  Files included in this package: 
  75.  
  76. OS2YOU.EXE          The remote software 
  77.  
  78. SETBAUD.EXE         Program used by Os2You 
  79.  
  80. SETUP.EXE           Setup program for Os2You, invoked by Os2You 
  81.  
  82. SRV_NBIO.EXE        NetBIOS NB30/ACSNETB protocol interface driver, invoked by 
  83.                     Os2You, LanTerm2 and Term2 
  84.  
  85. SRV_API.EXE         NetBIOS Submit/NETAPI protocol interface driver, invoked by 
  86.                     Os2You, LanTerm2 and Term2 
  87.  
  88. SRV_MSLT.EXE        Mailslot protocol interface driver, invoked by Os2You, 
  89.                     LanTerm2 and Term2 
  90.  
  91. DOS_SRV.EXE         Program to access DOS compatibility boxes in OS/2 2.0 
  92.  
  93. KBFILTER.COM        Resident program for the DOS-box, to use function keys 
  94.                     remote 
  95.  
  96. FTPSHOW.EXE         Program to display file transfer progress 
  97.  
  98. OS2FTP.EXE          File transfer program 
  99.  
  100. OS2FTP.DOC          Documentation for the file transfer program 
  101.  
  102. SZ.CMD              Command file to initiate Zmodem file transfer from host to 
  103.                     remote using M2Zmodem (not included) 
  104.  
  105. RZ.CMD              Command file to initiate Zmodem file transfer from remote 
  106.                     to host using M2Zmodem (not included) 
  107.  
  108. FAX.CMD             Command file to initiate FAX receive 
  109.  
  110. MODEM.SET           Modem definitions 
  111.  
  112. ????????.PRM        Terminal description files for different terminals 
  113.  
  114. OS2YOU.INF          This documentation 
  115.  
  116. ORDER.DOC           Printable Order/Invoice form 
  117.  
  118. LANTERM.EXE         Terminal program using DOS on a LAN or modem. 
  119.  
  120. LANTERM2.EXE        Terminal program using OS/2 on a LAN or modem. 
  121.  
  122. WINTERM.EXE         Terminal program using Windows 3.0 on a LAN or modem. 
  123.  
  124. LANBRIDG.EXE        LAN Bridge, to access OS/2 Requesters remote over LAN 
  125.  
  126. LANREL.EXE          Program to temporarily suspend Os2You to free port 
  127.  
  128. TERM2.EXE           Terminal program using OS/2 PM on a LAN or modem (only to 
  129.                     registered users) 
  130.  
  131. TERM2_V.EXE         Submodule for TERM2.  Required with TERM2 (only to 
  132.                     registered users) 
  133.  
  134. If you don't think this is the most current version of Os2You, you could send a 
  135. formatted diskette and four International Post reply coupons (Coupon-R╨Æponse 
  136. International, Union Postale Universelle) to my address mentioned last in this 
  137. documentation. 
  138.  
  139.  
  140. ΓòÉΓòÉΓòÉ 3. Stand alone installation ΓòÉΓòÉΓòÉ
  141.  
  142. Stand alone installation 
  143.  
  144.  You should copy all distributed files should be copied to a subdirectory on 
  145. your hard disk.  Before running Os2You, you must make that subdirectory the 
  146. current directory (Working Directory).  Assuming you have copied the files to 
  147. subdirectory called C:\Remote this is done by the command:
  148.  
  149.  CD \Remote
  150.  
  151.  To configure the program in stand alone mode, you run the program OS2YOU from 
  152. an OS/2 Command Prompt, without any parameters. Os2You will load a 
  153. configuration utility running with Presentation Manager.  Note, that you should 
  154. always start Os2You in a full screen session.
  155.  
  156.  The CONFIG.SYS file should be altered to include the following lines: 
  157.  
  158. IOPL=YES                                (if you plan to use baudrates higher 
  159.                                         than 19200 bauds with OS/2 1.3) 
  160.  
  161. DEVICE=C:\OS2\COM01.SYS                 (if you have an AT class machine and 
  162.                                         use serial line) 
  163.  
  164. DEVICE=C:\OS2\COM02.SYS                 (if you have an MCA class machine and 
  165.                                         use serial line) 
  166.  
  167. DEVICE=C:\OS2\COM.SYS                   (if you have OS/2 2.0 and use serial 
  168.                                         line) 
  169.  
  170. AUTOFAIL=YES                            To avoid pop-up error messages 
  171.  
  172. To start the program with an existing configuration file, you start the program 
  173. by typing Os2You -c <cfg-file> at the OS/2 Command Prompt (you replace 
  174. <cfg-file> with the configuration filename you want to use, like Os2You.CFG). 
  175. For more command line start options see separate section below or enter Os2You 
  176. -? at the prompt.
  177.  
  178.  The program will now put the modem into auto answer mode (if your modem is 
  179. supported by the program), and wait for an incoming call, and answer it.  When 
  180. the connection is established, the caller will be asked for an ID and password 
  181. and validate them with your configuration file.
  182.  
  183.  If you have specified a callback number for the caller, the connection will be 
  184. closed, and the Os2You program will call the phone number in the userlist entry 
  185. (note that you should only include the phone number in the user list entry and 
  186. not the Hayes command prefix ATD, but if you want, it is possible to include 
  187. any dialling command in the entry).  The caller will be asked for the password 
  188. once again, and will then be spawned to an OS/2 full screen text session.
  189.  
  190.  Os2You is IEMSI compatible, which means that if your terminal program has the 
  191. IEMSI capability, you can specify user name and password in your terminal 
  192. program, and you will automaticly be logged on.  Note that user name and 
  193. password is the only information accepted from the IEMSI profile for security 
  194. reasons. 
  195.  
  196.  
  197. ΓòÉΓòÉΓòÉ 4. What is a Named Pipe, NetBIOS and Mailslots? ΓòÉΓòÉΓòÉ
  198.  
  199. What is a named pipe and NetBIOS?
  200.  
  201.  The Named pipe specification is a powerful high level communication interface, 
  202. for communication between two programs.  Program using named pipes can 
  203. communicate with one another locally, or they can have their requests 
  204. redirected across a network.  The transport media is not significant for the 
  205. programs using the named pipe specification.  A program working locally on an 
  206. OS/2 machine should work equally well across a LAN or a dial up link, as long 
  207. as the transport media supports named pipes.  IBM Lan Server, Microsoft Lan 
  208. Manager and Novell Netware are different LANs supporting named pipes.
  209.  
  210.  In addition to being independent of the transport media, the named pipe 
  211. specification is working across different hardware and operating system platforms.
  212.  
  213.  NetBIOS is a communications interface used mostly on LANs, and is available on 
  214. most networks.  In most cases you should use Named Pipes, but on some networks 
  215. (like IBM Lan Server) you could use NetBIOS instead, if you want to communicate 
  216. between two requesters, as the Named Pipe interface on IBM Lan Server does not 
  217. support Named Pipes between workstations.  MS Lan Manager on the other hand, 
  218. supports Named Pipes between workstations.
  219.  
  220.  Mailslots are similar to NetBIOS.  It operates over some networks.  The 
  221. special feature of Mailslots is that it they allow communication between many 
  222. different nodes.  By using Mailslots, you can can have any amount of terminals 
  223. sending keystrokes to an OS2You session, and any amount of terminals can 
  224. receive the OS2You output at the same time.  Mailslots are currently only 
  225. supported by LanTerm2 and Terminal/2.
  226.  
  227.  
  228. ΓòÉΓòÉΓòÉ 5. Using Os2You with pipes or remote pipes with a LAN ΓòÉΓòÉΓòÉ
  229.  
  230. Using Os2You with pipes or remote pipes with a LAN 
  231.  
  232.  It is possible to use Os2You in a Local Area Network (LAN) environment, by 
  233. using Named Pipes or NetBIOS.  Os2You should run on any network compatible with 
  234. the Named Pipe or NetBIOS interface, like Microsoft Lan Manager, IBM Lan Server 
  235. and Novell Netware.  By installing Os2You in a LAN, you can access an OS/2 
  236. machine remote from a workstation connected to the LAN.
  237.  
  238.  You will use the program LanTerm or WinTerm if you want to access the remote 
  239. machine from a DOS workstation (not supported with NetBIOS) LanTerm2 or 
  240. Terminal/2 if you will access the remote machine from an OS/2 workstation. 
  241. LanTerm (for DOS) can be installed as a Terminate and Stay Resident (TSR) 
  242. program, allowing you to switch between the remote OS/2 session and the local 
  243. DOS session.  LanTerm(2) will terminate when you logout from the remote 
  244. session, or if you press Ctrl-Break.  If you terminate the programs during a 
  245. remote session, the remote session will be closed, and Os2You will wait for 
  246. another logon.  The LanTerm (for DOS) program, requires that ANSI.SYS is loaded 
  247. in your CONFIG.SYS file (on the DOS machine).
  248.  
  249.  Os2You must be installed on a machine, supporting the Named Pipe Server 
  250. interface.  Some networks (like IBM Lan Server) only allows a file server to 
  251. act as a Named Pipe Server, while other networks (like Novell NetWare and MS 
  252. Lan Manager) allows both file servers and requesters to act as Named Pipe 
  253. Servers.  This would mean that Os2You only can be installed on a file server on 
  254. a network like IBM Lan Server.  If you want to install Os2You on a requester in 
  255. IBM Lan Server, you must use either the LanBridg program (see below), or use 
  256. the NetBIOS interface instead (see below).
  257.  
  258.  If you want to use Os2You in a LAN on a machine supporting Named Pipe Server 
  259. applications, you should configure Os2You for stand alone mode, but select a 
  260. named pipe as your communications device instead, like \Pipe\Os2You as 
  261. communications device.  Assuming you have installed Os2You on a machine called 
  262. MyComputer, you access Os2You from a remote workstation on the LAN by starting 
  263. the LanTerm(2) program like this:
  264.  
  265.  LanTerm \\MyComputer\Pipe\Os2You
  266.  
  267.  If you want to use Os2You in LAN on a machine that only supports Named Pipe 
  268. Requester applications, you will have to install a program called LanBridg on 
  269. any other OS/2 machine on the network supporting Named Pipe Server 
  270. applications.  You install LanBridg on the Named Pipe Server machine, like this:
  271.  
  272.  LanBridg \Pipe\Os2You \Pipe\LanTerm
  273.  
  274.  On the OS/2 machine you want to run remote, you install Os2You for stand alone 
  275. mode, by select a named pipe as your communications device instead.  Assuming 
  276. you have installed LanBridg on a machine called MyServer, you should install 
  277. Os2You to use the pipe name \\MyServer\Pipe\Os2You as your communications 
  278. device.  To access the machine from a remote machine on the LAN, you start the 
  279. LanTerm(2) program like this:
  280.  
  281.  LanTerm \\MyServer\Pipe\LanTerm
  282.  
  283.  It is possible to start multiple sessions with Os2You using the same Pipe 
  284. name.  Each running copy of Os2You will be ready to receive a connect request 
  285. from a remote user, and the user will be connected to the first free instance 
  286. of Os2You.
  287.  
  288.  Note, that early versions of IBM LAN Server did not work properly with remote 
  289. named pipes, especially not from DOS Requesters.  This software is tested with 
  290. OS/2 Lan Server 1.2 CSD 4093, and worked on this configuration both from OS/2 
  291. requesters and DOS requesters.  But when tested with CSD 4063 the program did 
  292. not work with DOS Requesters, but was OK with OS/2 Requesters.
  293.  
  294.  This is a chart of how Os2You and LanTerm is configured to work together: 
  295.  
  296. ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù         ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  297. Γòæ OS/2 Async. Host      Γòæ         Γòæ DOS Remote (terminal)        Γòæ
  298. ΓòƒΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓò½ΓöÇmodemsΓöÇΓöÇΓò½ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòó
  299. Γòæ Os2You <- <comport>...Γòæ    Γöé    Γòæ LanTerm <comport> <baudrate> Γòæ
  300. ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥    Γöé    ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  301.                              Γöé    ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  302.                              Γöé    Γòæ OS/2 Remote (terminal)       Γòæ
  303.                              ΓööΓöÇΓöÇΓöÇΓöÇΓò½ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòó
  304.                                   Γòæ LanTerm2 <comport> <baudrate>Γòæ
  305.                                   ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  306.  
  307.  
  308. ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù      ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  309. Γòæ LAN Server (host)     Γòæ      Γòæ DOS Requester (terminal)      Γòæ
  310. ΓòƒΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓò½ΓöÇLANΓöÇΓöÇΓò½ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòó
  311. Γòæ Os2You <- \Pipe\Os2YouΓòæ  Γöé   Γòæ LanTerm \\Srvname\Pipe\Os2You Γòæ
  312. ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥  Γöé   ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  313.                            Γöé   ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  314.                            Γöé   Γòæ OS/2 Requester (terminal)     Γòæ
  315.                            ΓööΓöÇΓöÇΓöÇΓò½ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòó
  316.                                Γòæ LanTerm2 \\Srvname\Pipe\Os2YouΓòæ
  317.                                ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  318.  
  319.  
  320. ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  321. Γòæ OS/2 Requester (host)            Γòæ
  322. ΓòƒΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòó
  323. Γòæ Os2You <- \\Srvname\Pipe\Os2You  Γòæ
  324. ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòñΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  325.                Γöé
  326.                Γöé
  327. ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòºΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù     ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  328. Γòæ LAN Server (bridge)       Γòæ     Γòæ DOS Requester (terminal)       Γòæ
  329. ΓòƒΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓò½ΓöÇLANΓöÇΓò½ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòó
  330. Γòæ LanBridg                  Γòæ  Γöé  Γòæ LanTerm \\Srvname\Pipe\Lanterm Γòæ
  331. Γòæ \Pipe\Os2You \Pipe\LanTermΓòæ  Γöé  ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  332. ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥  Γöé  ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  333.                                Γöé  Γòæ OS/2 Requester (terminal)      Γòæ
  334.                                ΓööΓöÇΓöÇΓò½ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòó
  335.                                   Γòæ LanTerm2 \\Srvname\Pipe\LanTermΓòæ
  336.                                   ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  337.  
  338.  
  339. ΓòÉΓòÉΓòÉ 6. Using Os2You with NetBIOS in a LAN ΓòÉΓòÉΓòÉ
  340.  
  341. Using Os2You with NetBIOS in a LAN 
  342.  
  343.  On some networks (like IBM Lan Server), you can not communicate with Named 
  344. Pipes between two workstations (requesters).  One solution is using LanBridg 
  345. (see above), another solution is to use the NetBIOS interface instead, which 
  346. allows communication between two requesters. NetBIOS also allows one-two-many 
  347. operation, i.e. OS2You can send its output to any amount of terminals over a 
  348. network.  Only one terminal (the first connected) can act as a keyboard 
  349. console.  NetBIOS operation is currently only supported by OS/2 machines.
  350.  
  351.  The NetBIOS capability works in combination with the Named Pipe capability. If 
  352. you specify a NetBIOS connection, OS2You will accept connections from both 
  353. Named Pipes and NetBIOS.  To install Os2You for NetBIOS operation you select a 
  354. "NetBIOS connection" as your modem in the Device configuration dialog in SETUP. 
  355. In the "Device name" field you should specify a pipe name name for Os2You, as 
  356. if you were running with pipes.  In the modem configuration profile, you can 
  357. change the NetBIOS entry, to set the NetBIOS name, LAN adapter number and other parameters.
  358.  
  359.  You should assure that the program SRV_NBIO.EXE is available in a path or in 
  360. the current directory, on both the Os2You (host) machine and the terminal machine.
  361.  
  362.  To connect to the Os2You session, you must use LanTerm, WinTerm, LanTerm2 OR 
  363. Terminal/2.  To start LanTerm/LanTerm2 you just issue the command:
  364.  
  365.  LanTerm2 OS2YOU 
  366.  
  367.  If you want to use Terminal/2 (version 1.4 or higher), you should create a 
  368. phonebook entry and specify "OS2YOU" as your NetBIOS host name, and select 
  369. "NetBIOS" as your communications device type.
  370.  
  371.  Note that it can take some time (up to approx. ten seconds) to connect to an 
  372. Os2You NetBIOS session.
  373.  
  374.  
  375. ΓòÉΓòÉΓòÉ 6.1. Classroom operation (one-to-many operation) ΓòÉΓòÉΓòÉ
  376.  
  377. Classroom operation (one-to-many operation)
  378.  
  379.  When using NetBIOS connections, it is possible to connect several terminals to 
  380. the same OS2You session.  The first terminal connected with OS2YOU will have a 
  381. both-way communication link (can both see and type).  The following terminals 
  382. will have a one-way communication link (can only see the OS2You session, but 
  383. not affect it).  This setup is typically useful for classroom situations.  To 
  384. enable this feature, you edit the NetBIOS modem profile, and enable the "Allow 
  385. slaves" check box and enter a unique group name for the slaves (a NetBIOS name).
  386.  
  387.  Note that each terminal is connected to the session "on the fly".  This means 
  388. that if you connect a slave to OS2You, you will have to request a redraw of the 
  389. whole screen (Esc-space) to synchronize all terminals.
  390.  
  391.  The slave terminals are connected to OS2You via an unreliable link.  This 
  392. means that OS2You does not check that the slave terminals actually get the 
  393. screen output.  OS2You just sends the output to the slaves, and it is up to the 
  394. slave terminals to ensure that they catch it as it comes. 
  395.  
  396.  
  397. ΓòÉΓòÉΓòÉ 7. Using the configuration utility ΓòÉΓòÉΓòÉ
  398.  
  399. Using the configuration utility 
  400.  
  401.  If you start Os2You without any parameters, or run the program Setup the 
  402. configuration utility will be loaded.  This is a Presentation Manager program 
  403. with pull down menus.  Each section under this header, describes a 
  404. corresponding pull down menu.
  405.  
  406.  By clicking on the plus sign on the left of this item in the main menu, you 
  407. will get help on the different steps in the setup utility. 
  408.  
  409.  
  410. ΓòÉΓòÉΓòÉ 7.1. Device configuration ΓòÉΓòÉΓòÉ
  411.  
  412. Device configuration 
  413.  
  414.  This choice gives you a dialog panel to configure the communications device 
  415. you want to use.  Parameters in this panel are: 
  416.  
  417. Device         This parameter specifies which communication device Os2You 
  418.                should use.  You may select an asynchronous device or a named 
  419.                pipe. Remote named pipes (between different computers in a 
  420.                network) have the syntax \\ComputerName\Pipe\AnyName
  421.  
  422.                 By clicking on the down array to the right, you will get some 
  423.                pre-defined devices commonly used.
  424.  
  425.                 Note that you should not include the local ComputerName in the 
  426.                pipe name, as the pipe is always created locally as default.
  427.  
  428.                 If you want to use the NetBIOS interface, this field should 
  429.                specify an unique name on the network up to maximum 16 
  430.                characters long. 
  431.  
  432. Modem          This parameter specifies what modem you have connected to the 
  433.                device.  The currently selected modem is displayed in this 
  434.                field.  By clicking on the down array to the right, you will get 
  435.                a list with the modem configurations available.
  436.  
  437.                 You should select the entry NetBIOS connection, if you want to 
  438.                use the NetBIOS interface.
  439.  
  440.                 You should select the entry Pipe connection, if you are 
  441.                communicating via a named pipe.
  442.  
  443.                 If you are communicating via a cable connection (null modem) or 
  444.                a manual modem, you should select Cable connection in the list, 
  445.                and alter the definition to suit your needs.
  446.  
  447.                 To alter the modem configurations, you should select Modem from 
  448.                the action bar. 
  449.  
  450. Databits       This parameter specifies how many databits Os2You should use for 
  451.                the communication device.  Usually you should select 8 or 7. 
  452.                This option is only significant if you use an asynchronous 
  453.                device. 
  454.  
  455. Stopbits       This parameter specifies how many stopbits Os2You should use. 
  456.                Usually you should select 1 stop bit.  This option is only valid 
  457.                if you use an asynchronous device. 
  458.  
  459. Parity         This parameter specifies which parity to use. Usually you should 
  460.                for 8 data bits) or EVEN (for 7 data bits). This option is only 
  461.                valid for asynchronous devices. 
  462.  
  463. FIFO buffer    This option specifies if Os2You should use the enhanced 
  464.                buffering capabilities (if available) in some asynchronous 
  465.                devices. This option should be set to enabled except for some 
  466.                rare situations. 
  467.  
  468.  
  469. ΓòÉΓòÉΓòÉ 7.2. Special settings ΓòÉΓòÉΓòÉ
  470.  
  471. Special settings 
  472.  
  473.  This choice give you a dialog panel to configure some settings on how Os2You 
  474. should work.  Parameters in this panel are: 
  475.  
  476. Inactivity timeout       This parameter specifies for how long a user can be 
  477.                          inactive (not using the keyboard) before he is 
  478.                          automaticly logged off. 
  479.  
  480. Screen update delay      This parameter specified how often the remote display 
  481.                          will be updated.  Between each screen update, Os2You 
  482.                          waits for some time, before it updates the screen 
  483.                          again.  This delay is typically set to 100 ms, but 
  484.                          could be lowered to enhance the response time, or 
  485.                          higher to minimize the overhead caused by Os2You. 
  486.  
  487. Cursor update delay      When accessing sessions via the task switcher, the 
  488.                          cursor position updates must be done in a special way, 
  489.                          that cause screen flicker on the Os2You host machine. 
  490.                          This parameter specifies how often the cursor position 
  491.                          will be updated on the remote screen.  If set to 0 
  492.                          (zero) cursor position updates will be disabled.  This 
  493.                          parameter does not affect cursor updates for sessions 
  494.                          started by Os2You. 
  495.  
  496. Execution priority       This parameter specifies which priority the screen 
  497.                          update procedure should have.  The higher the priority 
  498.                          the more power the program has to fulfill its task. 
  499.                          But if the priority is set too high, other programs 
  500.                          don't get any power to execute at all (including the 
  501.                          one you will execute remote).  This parameter is 
  502.                          usually set to NORMAL/4, and should be altered only if 
  503.                          you experience severe performance problems. 
  504.  
  505. Detect carrier loss      This parameter specifies if loss of carrier should 
  506.                          cause an automatic logoff.  When two modems are 
  507.                          connected, there is a signal present called carrier, 
  508.                          to show this.  If the carrier suddenly disappears, 
  509.                          this means the connection was lost.  To prevent anyone 
  510.                          else to connect to the computer, it is possible to 
  511.                          logoff the user if this case happens.  This option is 
  512.                          only valid for asynchronous devices. 
  513.  
  514. Lock configuration file  This option tells if Os2You should lock the 
  515.                          configuration/login file, to prevent a logged on user, 
  516.                          to read or alter the configuration or other users 
  517.                          passwords. If set, it is im possible to read or alter 
  518.                          the configuration/login file while a user is logged 
  519.                          on. 
  520.  
  521. Printer port             This parameter specifies which device Os2You should 
  522.                          redirect to the remote printer. 
  523.  
  524. Printer redirection      This parameter specifies how printer redirection will 
  525.                          work.  If you select Local no redirection will take 
  526.                          place, and printer output will go to the host printer. 
  527.                          If you select Remote printer output will be redirected 
  528.                          to the remote printer.  If you select Both printer 
  529.                          output will be redirected to the remote printer, but 
  530.                          also sent to the local (host) printer. 
  531.  
  532. Port request pipe        This option specified which pipe name to use for port 
  533.                          requests.  It is possible to request Os2You to 
  534.                          temporarily release the asynchronous port, while the 
  535.                          program is waiting for an incoming call, to allow 
  536.                          other communication tasks to use the port.  These 
  537.                          requests are sent via this pipe.  If you leave this 
  538.                          entry empty the function will be disabled.  Named 
  539.                          pipes have the syntax \Pipe\Request 
  540.  
  541. Show file at login       This parameter specifies which file to display as 
  542.                          information before a user logs in.  This could be a 
  543.                          logo or a help text for example.  The file may contain 
  544.                          any character, including control characters and escape 
  545.                          sequences.  If you leave this entry empty, or the file 
  546.                          does not exists, no file will be displayed. 
  547.  
  548. Log file                 This parameter specifies which file to log messages 
  549.                          in.  In the log file Os2You stores information about 
  550.                          the logon progress.  If you leave this entry empty, no 
  551.                          logging will take place.
  552.  
  553.                           If you insert the line "SET DEBUG=ON" in your 
  554.                          CONFIG.SYS, Os2You will go into debug mode, writing 
  555.                          much more extensive information in the log file. 
  556.  
  557.  
  558. ΓòÉΓòÉΓòÉ 7.3. Modem configuration ΓòÉΓòÉΓòÉ
  559.  
  560. Modem configuration 
  561.  
  562.  This choice will give you a list with modem definitions.  The two first 
  563. entries are reserved for special purpose.  The first entry Pipe connection, 
  564. should be used if you are communicating via a named pipe.
  565.  
  566.  If you are communicating via a cable connection (null modem) or a manual modem 
  567. the Cable connection definition should be used, and be altered to suit your 
  568. needs.  The only valid entries in this configuration panel are the Baudrates 
  569. and handshaking parameters.  These entries specify which baudrates you want to 
  570. use over the cable, and what kind of handshaking to use.  Se below for more 
  571. specific information about the next panel.
  572.  
  573.  If you are communicating via an automatic modem, like a Hayes compatible 
  574. modem, you should select one of the listed modems, best matching your modem.
  575.  
  576.  You can add, change, copy or delete modem definitions.  If you select add, 
  577. change or copy, you will get the modem configuration panel.  The modem 
  578. configuration panel has the following parameters: 
  579.  
  580. Description                   A description of the modem type. 
  581.  
  582. Initializing string           This parameter is sent to the modem each time 
  583.                               Os2You initializes the modem.  This command 
  584.                               should put the modem into auto answer mode. 
  585.                               Modem control characters may be used. 
  586.  
  587. Dial command prefix           This parameter is sent by Os2You to dial a phone 
  588.                               number.  The dial command is composed by a lot of 
  589.                               different parameters.  This parameter is sent 
  590.                               first, to initialize the dial command. The phone 
  591.                               number is sent between the dial prefix and 
  592.                               suffix.  Modem control characters may be used. 
  593.  
  594. Dial command suffix           This parameter is sent by Os2You to dial a phone 
  595.                               number.  The dial command is composed by a lot of 
  596.                               different parameters.  This parameter is sent 
  597.                               last, to finish the dial command.  The phone 
  598.                               number is sent between the dial prefix and 
  599.                               suffix.  Modem control characters may be used. 
  600.  
  601. Turn off auto answer          This parameter is sent by Os2You to turn off auto 
  602.                               answer.  Modem control characters may be used. 
  603.  
  604. Hang up command               This parameter is sent by Os2You to hang up the 
  605.                               line and close the connection.  Modem control 
  606.                               characters may be used. 
  607.  
  608. Shutdown string               This parameter is sent by Os2You before Os2You is 
  609.                               exiting.  Modem control characters may be used. 
  610.  
  611. Connect string 1-6            These strings are expected from the modem when 
  612.                               the modem has successfull established a 
  613.                               connection with another modem.  Os2You inspects 
  614.                               the result strings from the modem, and selects 
  615.                               the correct baudrate.  Os2You tries to match the 
  616.                               result strings from the modem with the connect 
  617.                               strings beginning with connect string 1 and 
  618.                               ending with string 6.  Therefore, if the result 
  619.                               strings are beginning equally, you should specify 
  620.                               the longer first.  A string like CONNECT 1200 
  621.                               should be specified 
  622.  
  623. Fax connect string            This string is expected from the modem when the 
  624.                               modem has established a fax connection with 
  625.                               another fax.  OS2You will start the FAX.CMD file 
  626.                               at this event.  A string like CONNECT 1200 should 
  627.                               be specified 
  628.  
  629. Release fax-device            This check-box specifies whether the COM-device 
  630.                               should be closed before starting the FAX.CMD 
  631.                               file.  This box should be checked if the fax 
  632.                               receive program is not written to work in a 
  633.                               configuration like this.  If the fax receive 
  634.                               program is a DOS-program this box should be 
  635.                               checked before the connect string CONNECT. 
  636.                               Os2You always initializes the modem with the 
  637.                               speed corresponding to connect string 1. 
  638.  
  639. Baudrate 1-6                  These values specifies which baudrates the 
  640.                               corresponding connect strings represent.  The 
  641.                               baudrate 1 is always used by Os2You to initialize 
  642.                               the modem. 
  643.  
  644. CTS/RTS handshaking           This parameter specifies if hardware handshaking 
  645.                               using CTS/RTS should be used.  Sometimes the 
  646.                               computer can send away characters faster than 
  647.                               your modem manage to handle.  In this case the 
  648.                               modem uses handshaking signals to tell Os2You to 
  649.                               hold for some time.  If you have a modem with 
  650.                               higher rate between computer and modem, than 
  651.                               between the two connected modems, you may select 
  652.                               this option.  This parameter is only significant 
  653.                               if you use an asynchronous device. 
  654.  
  655. Xon/Xoff handshaking          This parameter specifies if software handshaking 
  656.                               using Xon/Xoff should be used.  Sometimes the 
  657.                               computer can send away characters faster than 
  658.                               your modem manage to handle.  In this case the 
  659.                               modem uses handshaking signals to tell Os2You to 
  660.                               hold for some time. If you have a modem with 
  661.                               higher rate between computer and modem, than 
  662.                               between the two connected modems, you may select 
  663.                               this option.  This parameter is only significant 
  664.                               if you use an asynchronous device. 
  665.  
  666.  
  667. ΓòÉΓòÉΓòÉ 7.4. User table ΓòÉΓòÉΓòÉ
  668.  
  669. User table 
  670.  
  671.  This choice will give you a list with user profiles.  You can add, change, 
  672. copy or delete user definitions.  If you select add, change or copy, you will 
  673. get the user profile panel.  Note that no entries in the user profile should 
  674. ever contain the character ";" (semicolon)  The user profile panel has the 
  675. following parameters: 
  676.  
  677. User name                This entry specifies the name of the user. This entry 
  678.                          is case insensitive, mikael and MIKAEL are treated 
  679.                          equally by Os2You. 
  680.  
  681. User password            This entry specifies the password for the user. This 
  682.                          field may be left blank, in which case the user entry 
  683.                          isn't protected by password.  In this case any 
  684.                          password is accepted and the password is written to 
  685.                          the log file.  This field is case sensitive, secret 
  686.                          and SECRET are treated differently. 
  687.  
  688. Callback number          This entry specifies the phone number for callback. If 
  689.                          you specify a callback number, Os2You will close the 
  690.                          connection after a successful logon, and call the 
  691.                          specified number and establish the connection once 
  692.                          again.  This enhance the safety in the system much, 
  693.                          and is also a way to get the phone bills on the other 
  694.                          account.  If you don't want callback operation, you 
  695.                          just leave this field empty.  Callback operation is 
  696.                          not possible on pipe or cable connections. 
  697.  
  698. Shell command            This entry specifies which program to execute when the 
  699.                          user has logged on to the system.  This may be any 
  700.                          executable program which is compatible with Os2You. 
  701.                          Note that you should include the file extension. This 
  702.                          entry is typically set to CMD.EXE to get an OS/2 
  703.                          command shell. Os2You can pass symbolic parameters. 
  704.  
  705. Startup session          This entry specifies what session to activate 
  706.                          initially when the user has logged in.  This entry 
  707.                          must exactly match (case sensitive) an entry in the 
  708.                          task list.  This can be both an OS/2 Full Screen 
  709.                          session or a DOS Full Screen session.  It is allowed 
  710.                          to specify a startup session, even if the user hasn't 
  711.                          access to the task switching normally.  In this case, 
  712.                          the user won't be able to alter task.  If this entry 
  713.                          is left blank the spawned session will be initially 
  714.                          displayed. 
  715.  
  716. Allow taskswitching      This entry specifies if the user is allowed to switch 
  717.                          between different tasks, and access other tasks than 
  718.                          the one specified in the login table.  If the user is 
  719.                          not allowed to task switch some other functions in 
  720.                          Os2You are unavailable to the user of security reasons 
  721.                          (like the Ctrl-Break operation). 
  722.  
  723. Protected files list     This entry indicates what files should be access 
  724.                          protected.  See Protected files list 
  725.  
  726. Manual authorization     If this entry is checked the user can logon only if 
  727.                          someone at the physical console (keyboard) at the host 
  728.                          is accepting the login request. 
  729.  
  730. Allowed sessions list    Not implemented yet. 
  731.  
  732. Terminal definition      This entry specifies which terminal definition to use 
  733.                          for the user.  The user should use a terminal matching 
  734.                          this definition.  If this field is left empty, Os2You 
  735.                          will use a built in ANSI terminal protocol.  You may 
  736.                          click at the arrow down on the right, to get a list of 
  737.                          available terminal definitions. 
  738.  
  739.  
  740. ΓòÉΓòÉΓòÉ 7.5. Terminal definitions ΓòÉΓòÉΓòÉ
  741.  
  742. Terminal definitions 
  743.  
  744.  This choice will give you a list with terminal definitions.  You can add, 
  745. change, copy or delete terminal definitions.  If you select add, change or 
  746. copy, you will get the terminal definition panel. 
  747.  
  748. Terminal file                 Name of the terminal definition.  It should have 
  749.                               the suffix PRM, and including the suffix, not be 
  750.                               longer than 12 characters. 
  751.  
  752. Initializing                  This parameter is sent by Os2You to initialize 
  753.                               the terminal.  Normally no initializing is 
  754.                               required, in which case this field should be left 
  755.                               empty.  This entry expects an array of 
  756.                               hexadecimal digits. 
  757.  
  758. Set cursor command            This parameter is sent by Os2You to position the 
  759.                               cursor.  The cursor position command is composed 
  760.                               by several different parameters.  This parameter 
  761.                               is sent first.  This entry expects an array of 
  762.                               hexadecimal digits. 
  763.  
  764. Set cursor col ofs            This parameter specifies the offset for the 
  765.                               column value.  This parameter expects a decimal 
  766.                               constant.  The first column is zero. 
  767.  
  768. Set cursor col first          This parameter specifies if the column or row 
  769.                               value should be sent first. 
  770.  
  771. Set cursor separator          This parameter is sent between the row and column 
  772.                               values.  This entry expects an array of 
  773.                               hexadecimal digits. 
  774.  
  775. Set cursor row ofs            This parameter specifies the offset for the row 
  776.                               value.  This parameter expects a decimal 
  777.                               constant.  The first row is zero. 
  778.  
  779. Set cursor binary             This parameter specifies if the column and row 
  780.                               values should be sent as binary values or as 
  781.                               ASCII strings. 
  782.  
  783. Set cursor terminator         This parameter is sent by Os2You to position the 
  784.                               cursor. The cursor position command is composed 
  785.                               by several different parameters.  This parameter 
  786.                               is sent last.  This entry expects an array of 
  787.                               hexadecimal digits. 
  788.  
  789. Set cursor pad length         This parameter specifies how long each column and 
  790.                               row value should be if the Zero pad (see below) 
  791.                               parameter is set.  This parameter expects a 
  792.                               decimal constant. 
  793.  
  794. Set cursor zero pad           This parameter specifies if the column and row 
  795.                               values should be justified with leading zeros to 
  796.                               fit the pad length. This parameter is not valid 
  797.                               if you have selected binary column and row 
  798.                               values. 
  799.  
  800. Scroll up initializing        This parameter is sent by Os2You to scroll the 
  801.                               screen up.  The scroll command is composed by two 
  802.                               different parameters.  This parameter is sent 
  803.                               first, before any scrolling, to initialize the 
  804.                               scrolling sequence.  This entry expects an array 
  805.                               of hexadecimal digits. 
  806.  
  807. Scroll screen up each row     This parameter is sent one time for each row to 
  808.                               scroll.  This entry expects an array of 
  809.                               hexadecimal digits. 
  810.  
  811. Clear screen                  This parameter is sent by Os2You to clear the 
  812.                               screen and position the cursor in home position. 
  813.                               This entry expects an array of hexadecimal 
  814.                               digits. 
  815.  
  816. Clear line                    This parameter is sent by Os2You to clear the 
  817.                               remaining of the current row.  This entry expects 
  818.                               an array of hexadecimal digits. 
  819.  
  820. TAB length                    This parameter specifies with what interval 
  821.                               tabulator stops are placed.  A tab character is 
  822.                               expanded to spaces by the terminal.  If you want 
  823.                               to disable the use of tab character to replace 
  824.                               multiple spaces you should set this value to 
  825.                               zero.  Often terminals does not advance to the 
  826.                               tab stop with spaces but instead only advances 
  827.                               the cursor.  In this case you must set this 
  828.                               parameter to zero.  This parameter expects a 
  829.                               decimal constant. 
  830.  
  831. ANSI Colors                   This parameter specifies if ANSI color sequences 
  832.                               should be used.  This should only be set to YES, 
  833.                               if the terminal is compatible with ANSI/BBS 
  834.                               colors.  If this parameter is not set, colors 
  835.                               will be ignored. 
  836.  
  837. Strip control chars           This parameter specifies that Os2You should 
  838.                               ignore any control characters visible on the 
  839.                               screen and send spaces instead. 
  840.  
  841. Strip high chars              This parameter specifies that Os2You should 
  842.                               ignore any characters with a higher ASCII value 
  843.                               than 126 (decimal), except for some characters 
  844.                               (like box-drawing) which are translated to look 
  845.                               alike characters. 
  846.  
  847.  
  848. ΓòÉΓòÉΓòÉ 7.6. Protected file list ΓòÉΓòÉΓòÉ
  849.  
  850. Protected file list 
  851.  
  852.  This choice will give you a list with protected file lists.  You can add, 
  853. change, copy or delete user definitions.  If you select add, change or copy, 
  854. you will get the protected file list editor.  The protected file list indicates 
  855. what files should be locked for access for the logged in user.  A sample list 
  856. could look like this: 
  857.  
  858. C:\CONFIG.SYS /RW
  859. C:\OS2\*.* /W /S
  860. C:\IN\*.* /R /S
  861.  
  862. The first row would mean that C:\CONFIG.SYS is locked for both read and write access.
  863.  
  864.  The second row means that all files in the C:\OS2 directory including sub- 
  865. directories are protected against modification/deletion (protected against 
  866. write access).
  867.  
  868.  The third row means that all files in the C:\IN directory including sub- 
  869. directories are protected against read access.
  870.  
  871.  
  872. ΓòÉΓòÉΓòÉ 7.7. Exit setup ΓòÉΓòÉΓòÉ
  873.  
  874. Exit setup 
  875.  
  876.  This choice gives you a sub-menu that lets you choice between: 
  877.  
  878. Save and exit       The configuration is saved in the file OS2YOU.CFG, and 
  879.                     Os2You is started (if the setup program was invoked by 
  880.                     Os2You). 
  881.  
  882. Discard and exit    Any changes in the configuration will be discarded, and 
  883.                     Os2You is started (if the setup program was invoked by 
  884.                     Os2You).  Note, that changes in the modem or terminal 
  885.                     definitions have been saved anyhow. 
  886.  
  887. Resume              The program will continue with the setup. 
  888.  
  889.  
  890. ΓòÉΓòÉΓòÉ 8. Terminal emulation ΓòÉΓòÉΓòÉ
  891.  
  892. Terminal emulation 
  893.  
  894.  To access the remote Os2You machine over an asynchronous line (cable or 
  895. modem), you will need a terminal emulation program (or a terminal), with one of 
  896. the terminal emulation modes supported by Os2You.  It doesn't matter which 
  897. operating system your terminal emulator is running.
  898.  
  899.  If you use OS/2 or DOS you may use the LanTerm2 (for OS/2) or LanTerm (for 
  900. DOS) programs for both terminal emulation over a network using named pipes, or 
  901. as an asynchronous terminal program. It will remap the keys to their 
  902. corresponding Esc-sequences, and is also compatible with the Os2You binary mode 
  903. (when running over a Pipe), which sometimes are faster than the terminal 
  904. emulation mode, when used on fast connections.
  905.  
  906.  If you don't want to use LanTerm(2), you may use any other terminal program 
  907. supporting one of the terminal emulation modes supported by Os2You.  Currently 
  908. the following terminals are supported by Os2You (ANSI is default if none 
  909. selected). 
  910.  
  911. Terminal                                          Description file 
  912.  
  913. ANSI/VT100/VT102                                  ANSI.PRM (not same as 
  914.                                                   default) 
  915.  
  916. Hazeltine 1500                                    HAZEL.PRM (not tested) 
  917.  
  918. IBM 3101                                          IBM3101.PRM 
  919.  
  920. Tandberg TDV 2116                                 TANDBERG.PRM 
  921.  
  922. Televideo 910-955/ADM 5/Wyse 50                   TELEVID.PRM 
  923.  
  924. VT52/Heath/Zenith/ADDS VP                         VT52.PRM 
  925.  
  926. Note that the description files only alter the screen output, and does not care 
  927. about different keystroke combinations used by different terminals, except the 
  928. ANSI escape keysequences. Also note that some terminals will work better if you 
  929. run Os2You in a screen with only 24 lines (MODE CO80,24) instead of the more 
  930. common 25 lines.  The following terminal programs are tested and seems to work 
  931. with Os2You (except when otherwise indicated): 
  932.  
  933. OS/Program                    Os2You terminal definition to use / comments 
  934.  
  935. DOS LanTerm                   Use built in ANSI (ANSI.SYS should be loaded) 
  936.  
  937. DOS Telix 3.15                Use built in ANSI (disable status line in Telix) 
  938.  
  939. DOS Procomm+ 1.0              Use external ANSI, use only 24 lines in Os2You, 
  940.                               screen color backgrounds won't be correct 
  941.  
  942. DOS Procomm+ 2.0              Use external ANSI, use only 24 lines in Os2You 
  943.                               (if you use the standard 25 line mode in 
  944.                               Procomm+) 
  945.  
  946. OS2 LanTerm2                  Use built in ANSI 
  947.  
  948. OS2 LogiComm 2.20S            Use built in ANSI 
  949.  
  950. OS2 M2Zmodem 2.11             Use built in ANSI 
  951.  
  952. OS2 HyperAccess 5/2           Use external ANSI, use only 24 lines in Os2You 
  953.  
  954. OS2 TE/2 1.10A                Use built in ANSI 
  955.  
  956. OS2 CKOKER 4E(070)            Use external ANSI, use only 24 lines in Os2You 
  957.  
  958. PM  PMTerm                    Use built in ANSI 
  959.  
  960. PM  Term2                     Use built in ANSI 
  961.  
  962. PM  PMComm 1.07               Won't work with Os2You. Very strange scrolling 
  963.                               handling. 
  964.  
  965. PM  XKOKER 5A(119)            Use external ANSI, use only 24 lines in Os2You 
  966.  
  967. If your terminal is not supported with a terminal description file, you may 
  968. define your own terminal, by starting the setup utility and select Terminal in 
  969. the configuration menu. The program automatically detects how many columns and 
  970. lines the OS/2 session contains, but you have to configure your terminal 
  971. program for a screen size with at least the same amount of columns/lines (it 
  972. doesn't matter if the terminal program uses more columns/lines than the OS/2 
  973. session). It is possible to alter the screen size with the MODE-command, while 
  974. connected to Os2You, as long as the screen will fit on the remote screen.
  975.  
  976.  To "emulate" different keystrokes, Esc sequences are used. The following Esc 
  977. sequences are valid (note that upper/lower case letters are significant):
  978.  
  979. Ch. Result Ch. Result Ch. Result    Ch. Res Ch. Result (?????)
  980. === ====== === ====== === ======    === === === =====================
  981.  A  Alt-A   N  Alt-N  Esc Escape     1  F1   !  Shift/Ctrl/Alt-F1
  982.  B  Alt-B   O  Alt-O   t  BackTab    2  F2   @  Shift/Ctrl/Alt-F2
  983.  C  Alt-C   P  Alt-P                 3  F3   #  Shift/Ctrl/Alt-F3
  984.  D  Alt-D   Q  Alt-Q   w  Arr up     4  F4   $  Shift/Ctrl/Alt-F4
  985.  E  Alt-E   R  Alt-R   <  Arr left   5  F5   %  Shift/Ctrl/Alt-F5
  986.  F  Alt-F   S  Alt-S   >  Arr right  6  F6   ^  Shift/Ctrl/Alt-F6
  987.  G  Alt-G   T  Alt-T   z  Arr down   7  F7   &  Shift/Ctrl/Alt-F7
  988.  H  Alt-H   U  Alt-U                 8  F8   *  Shift/Ctrl/Alt-F8
  989.  I  Alt-I   V  Alt-V   c  Ctrl-Break 9  F9   (  Shift/Ctrl/Alt-F9
  990.  J  Alt-J   W  Alt-W                 0  F10  )  Shift/Ctrl/Alt-F10
  991.  K  Alt-K   X  Alt-X                 -  F11  _  Shift/Ctrl/Alt-F11
  992.  L  Alt-L   Y  Alt-Y                 =  F12  +  Shift/Ctrl/Alt-F12
  993.  M  Alt-M   Z  Alt-Z
  994.                                              s  Set F-key to Shift
  995.  i  Insert  h  Home    u  PageUp             l  Set F-key to Ctrl
  996.  d  Delete  e  End     n  PageDown           a  Set F-key to Alt
  997. =====================================================================
  998. Tab    Task list                     b  Toggle binary mode
  999. Break  Force Os2You to exit          p  Toggle physical screen
  1000. Space  Force Os2You to update screen ?  Status information
  1001.                                      y  Service functions
  1002.  
  1003. The above screen is showed if you press Esc without any character following 
  1004. within approx. one second.  You may select any keystroke from the menu, and the 
  1005. menu exits, and Os2You sends the selected keystroke to your application.  If 
  1006. Esc is pressed and directly followed by another character, the selected 
  1007. keystroke is sent directly to your application, without showing the help screen.
  1008.  
  1009.  ANSI escape sequences for cursor movements are mapped to their corresponding 
  1010. arrow key.
  1011.  
  1012.  All characters, except Esc, are translated directly to the corresponding 
  1013. keystroke.  ASCII 01H is translated to Ctrl-A, ASCII 02H to Ctrl-B and so on.
  1014.  
  1015.  To emulate Shift, Ctrl and Alt function keys, you have to first select which 
  1016. mode you want by pressing Esc-s, Esc-l resp. Esc-a first followed by the 
  1017. appropriate function key Esc-code. In the upper right corner of the help menu 
  1018. the current state of the function keys is written.
  1019.  
  1020.  The above table means that you should press Esc first and then a character. 
  1021. Esc-i means that you should press Esc first and then followed by i.  Note that 
  1022. you have to press Esc twice, if you want to emulate a Esc keystroke.
  1023.  
  1024.  
  1025. ΓòÉΓòÉΓòÉ 9. LanTerm(2) terminal emulators ΓòÉΓòÉΓòÉ
  1026.  
  1027. LanTerm(2) terminal emulators 
  1028.  
  1029.  If you use OS/2 or DOS you may use the LanTerm2 (for OS/2) or LanTerm (for 
  1030. DOS) programs for both terminal emulation over a network using named pipes, or 
  1031. as an asynchronous terminal program. It will remap the keys to their 
  1032. corresponding Esc-sequences, and is also compatible with the Os2You binary mode 
  1033. (when running over a Pipe), which sometimes are faster than the terminal 
  1034. emulation mode, when used on fast connections.
  1035.  
  1036.  If you want to run LanTerm2 or LanTerm on a asynchronous connection, you 
  1037. should start LanTerm2 with the following syntax:
  1038.  
  1039.  LanTerm2 <COM-device> <baudrate> <PRN-device> <Script-file>
  1040.  
  1041.  LanTerm  <COM-device> <baudrate> <PRN-device> <Script-file> <TSR>
  1042.  
  1043.  Example:
  1044.  
  1045.  LanTerm COM1 19200 LPT1 MY_SCRIPT.TXT TSR 
  1046.  
  1047.  The device name must begin with COM (like COM1).  All other parameters are 
  1048. optional, but must be specified in the above order if specified at all.  If no 
  1049. baudrate is specified the program uses the default baudrate. The PRN-device 
  1050. parameter specifies which device redirected printer output should be sent to 
  1051. (see Printer redirection). When used for asynchronous communication, the 
  1052. programs always sets the COM-device to 8 databits, 1 stopbits and no parity. 
  1053. The LanTerm program for DOS, requires that ANSI.SYS is loaded in your 
  1054. CONFIG.SYS file.  The DOS-mode program will only work with COM1 and COM2 serial 
  1055. ports.  The programs are terminated by pressing Ctrl-Break.  LanTerm (for DOS), 
  1056. may be installed as a Terminate and Stay Resident (TSR) program, allowing you 
  1057. to switch between the remote OS/2 machine and the local DOS machine.
  1058.  
  1059.  If you use LanTerm(2), you don't have to use the Esc sequences, as LanTerm(2) 
  1060. will map the keystrokes to the correct Esc sequences directly.  If you 
  1061. specially want to use any of the Esc sequences above, you will have to press 
  1062. RightShift-Esc followed by the keycode.
  1063.  
  1064.  Scripting:
  1065.  
  1066.  LanTerm, LanTerm2 and Terminal/2 are capable of simple scripting (type of 
  1067. batch file processing for communications).  Script files are simple text files 
  1068. you create with a text editor.  The following commands are available:
  1069.  
  1070.  RESPOND "xxxxx" "yyyyy"
  1071.  
  1072.  DELAYED RESPOND "xxxxx" "yyyyy" "zzz"
  1073.  
  1074.  QUIT "xxxxx"
  1075.  
  1076.  INITIAL "xxxxx"
  1077.  
  1078.  EXIT
  1079.  
  1080. RESPOND                  Each time the string "xxxxx" is received "yyyyy" is 
  1081.                          sent as response 
  1082.  
  1083. DELAYED RESPOND          Each time the string "xxxxx" is received "yyyyy" is 
  1084.                          sent after "zzz" seconds delay (zzz is a decimal 
  1085.                          value) 
  1086.  
  1087. QUIT                     When "xxxxx" is received the script file is 
  1088.                          terminated. 
  1089.  
  1090. INITIAL                  When scripting begins the "xxxxx" string is sent. 
  1091.  
  1092. The ^ character is treated as an <Enter>.  Following is an example script file:
  1093.  
  1094.  INITIAL "ATDT 123456^"
  1095.  
  1096.  RESPOND "Press Enter to continue" "^"
  1097.  
  1098.  RESPOND "User name" "Mikael Wahlgren^"
  1099.  
  1100.  RESPOND "Password" "secret^"
  1101.  
  1102.  QUIT "Loading"
  1103.  
  1104.  EXIT
  1105.  
  1106.  
  1107. ΓòÉΓòÉΓòÉ 10. Printer redirection ΓòÉΓòÉΓòÉ
  1108.  
  1109. Printer redirection 
  1110.  
  1111.  Printer output may be redirected from one device to a remote printer.  Note 
  1112. that all output to the selected device is redirected, even output from other 
  1113. sessions to this device.  You can select to direct printer output either to the 
  1114. local printer, remote printer or both.  To redirect the printer output from one 
  1115. device to a remote printer, you should install a printer driver for the remote 
  1116. printer on the selected device.
  1117.  
  1118.  Example: 
  1119.  
  1120. o You have a IBM Proprinter 4201 connected to LPT1 on the remote computer 
  1121.   running LanTerm, LanTerm2 or Terminal/2. 
  1122.  
  1123. o Install the IBM Proprinter 4201 printer driver for LPT2 on the host computer. 
  1124.  
  1125. o Install Os2You to redirect LPT2 to remote computer. 
  1126.  
  1127. o All output to LPT2 on the host will now be redirected to the remote printer. 
  1128.   Other printer devices, like LPT1, will be unaffected. 
  1129.  
  1130. Printer redirection requires that the terminal program on the remote computer 
  1131. is capable of handling this feature.  To use this feature, you will have to use 
  1132. LanTerm, LanTerm2 or Terminal/2.
  1133.  
  1134.  If you use a terminal program that can't handle this feature, and have 
  1135. installed Os2You to redirect printer output to remote printer, all printing 
  1136. will be put on hold.
  1137.  
  1138.  
  1139. ΓòÉΓòÉΓòÉ 11. File transfer ΓòÉΓòÉΓòÉ
  1140.  
  1141. File transfer 
  1142.  
  1143.  By entering the Os2You Service Functions menu by pressing Esc-y, you can send 
  1144. and receive files to/from the Os2You host.  Os2You will ask you for filenames 
  1145. to send or directory to place received files in.  You may select multiple files 
  1146. by using standard wild cards.  Os2You will use standard Ymodem-Batch protocol 
  1147. for these types of file transfers.
  1148.  
  1149.  If you have Terminal/2, LanTerm2 or WinTerm, the file transfer protocol will 
  1150. automaticly be invoked.  If you use any other terminal program, you will be 
  1151. requested to start the file transfer procedure.
  1152.  
  1153.  There is also a batch file transfer capability included called OS2Ftp.  It 
  1154. supports file transfers with several different file transfer protocols, like 
  1155. Xmodem, Xmodem-1K, Ymodem, Ymodem-G, Zmodem and Kermit (for Zmodem or Kermit, 
  1156. it requires the existence of M2Zmodem and CKermit).  Examples:
  1157.  
  1158.  OS2FTP -s*.*
  1159.  
  1160.  OS2FTP -rC:\Download
  1161.  
  1162.  OS2FTP -XMODEM -sMYFILE.DAT
  1163.  
  1164.  OS2FTP -XMODEM -rMYFILE.DAT
  1165.  
  1166.  If you have M2Zmodem version 2.09 or later (another program from the same 
  1167. source), you may use it to up/download between the host and remote.  File 
  1168. transfers using M2Zmodem is faster, by using standard Zmodem protocol, and is 
  1169. invoked from the command line. This solution also allows auto Zmodem uploads. 
  1170. I suggest that you copy the M2Zmodem.EXE and M2Zmodem.MSG files into the same 
  1171. directory you used for Os2You. Then you should include this directory in your 
  1172. PATH and DPATH.
  1173.  
  1174.  It is now possible to receive files from host to remote (download) by just 
  1175. typing Sz <files> at the command prompt (any wildcards allowed).  If you run 
  1176. LanTerm2 or LanTerm as terminal program at the remote (or any other terminal 
  1177. program with Zmodem autodownload), the file transfer will be automatically 
  1178. started at the terminal side too, if not, you have to request download in your 
  1179. terminal program.
  1180.  
  1181.  If you use LanTerm (for DOS), you should get DSZ file transfer program 
  1182. (shareware from Omen Technology).  If you use LanTerm2 (for OS/2), you should 
  1183. get M2Zmodem file transfer program (shareware from the same place you got 
  1184. Os2You).  Both programs should be installed in the same directory as 
  1185. LanTerm(2), or in a directory specified in your path.
  1186.  
  1187.  To send files from remote to host (upload) just type Rz at the command prompt. 
  1188. When you request upload in your terminal program, you should enter which files 
  1189. to send.  If you have called your receive batch file Rz.Cmd you don't even have 
  1190. to start the batch file before starting your send procedure, because the Rz 
  1191. command is executed automatically by the Zmodem initializing procedure, if you 
  1192. are at the command line when you start the send procedure (auto Zmodem download).
  1193.  
  1194.  If you don't know how to get M2Zmodem or CKermit, you could send a formatted 
  1195. diskette and four International Post reply coupons (Coupon-R╨Æponse 
  1196. International, Union Postale Universelle) to my address mentioned last in this 
  1197. documentation. 
  1198.  
  1199.  
  1200. ΓòÉΓòÉΓòÉ 12. Task list ΓòÉΓòÉΓòÉ
  1201.  
  1202. Task list 
  1203.  
  1204.  By pressing Esc-tab (first <Esc> and then <Tab> 1bH, 09H) you will get a list 
  1205. of programs currently running.  It might look like this: 
  1206.  
  1207.     ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  1208.     Γòæ -> 1  Return to original session Γòæ
  1209.     Γòæ    2  Switch to                  Γòæ
  1210.     Γòæ    3  OS/2 window                Γòæ
  1211.     Γòæ    4  Group - Communication      Γòæ
  1212.     Γòæ    5  M2ZMODEM.EXE               Γòæ
  1213.     Γòæ    6  Os2You.EXE                 Γòæ
  1214.     Γòæ    7  TS.EXE                     Γòæ
  1215.     Γòæ    8  Group - Main               Γòæ
  1216.     Γòæ    9  PM Diary                   Γòæ
  1217.     ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  1218.  
  1219. The task list displays all running programs.  If the list is too long for the 
  1220. screen, you may scroll up and down with the PgUp and PgDn keys.  You enter the 
  1221. digit displayed before the program you want to switch to, or move the arrow 
  1222. with the cursor keys.  If you want to return to the original session (the one 
  1223. you started from) you should select 1.
  1224.  
  1225.  You can only switch to programs running in an OS/2 Full Screen text session or 
  1226. DOS Full Screen text session (if you run Os2You with OS/2 2.0 or later).  If 
  1227. you try to switch to another session, you will get an error message.  Note that 
  1228. the session you select is switched to the foreground at the host machine, and 
  1229. will interrupt any user running another session at the machine from the 
  1230. keyboard.  It will also interrupt any other user running the same host through 
  1231. Os2You running other session than their original session.  The session you 
  1232. selected should not be switched to the background, while you are connected to 
  1233. it, as the user will be returned to the task-list if the task is switched to background.
  1234.  
  1235.  
  1236. ΓòÉΓòÉΓòÉ 13. DOS-compatibility box ΓòÉΓòÉΓòÉ
  1237.  
  1238. DOS-compatibility box 
  1239.  
  1240.  If you run OS/2 2.0 (or compatible) It is possible to switch to a Full Screen 
  1241. DOS compatibility box in OS/2 2.0.  Note that any user running at the physical 
  1242. screen will be interrupted when the DOS-box is entered. Otherwise you can 
  1243. access the DOS-box just like you access the other OS/2 sessions.
  1244.  
  1245.  For the DOS-box access to work, you must take some extra care to configure 
  1246. your system.  First, the DOS_SRV.EXE program must be located in the directory 
  1247. you installed Os2You in (or in a pathed directory).  If this is not the case 
  1248. you will get a message like "DOS Keyboard emulation not available!".
  1249.  
  1250.  Then you must load the resident program KBFILTER.COM in the DOS-box you want 
  1251. to access remotely, in order to get the function keys to work (other characters 
  1252. will work without this program).  You can either load the program from the 
  1253. remote, when you have switched to the DOS-session, or you can load the program 
  1254. KBFILTER.COM in your AUTOEXEC.BAT file.  The program will require very little 
  1255. memory (less than 1 Kb) and interfere very little with your usual work (the 
  1256. Esc-key can seem a little slow).
  1257.  
  1258.  If you can see the DOS-box screen output, but not send any keystrokes at all, 
  1259. this probably means that DOS_SRV.EXE isn't loaded properly.  If you can send 
  1260. alphanumerical characters, but no function keys, that probably means that 
  1261. KBFILTER.COM isn't loaded properly.
  1262.  
  1263.  Note that KBFILTER.COM could be loaded several times.  This is not recommended.
  1264.  
  1265.  
  1266. ΓòÉΓòÉΓòÉ 14. Sharing ports with other communication programs ΓòÉΓòÉΓòÉ
  1267.  
  1268. Sharing ports with other communication programs 
  1269.  
  1270.  If you have set up Os2You in HOST mode to answer incoming calls, it is 
  1271. possible to temporarily suspend Os2You, to let other communication programs 
  1272. access the port.  To do this you have to enter a pipe name in the configuration 
  1273. parameter Port request pipe (like "\PIPE\RELEASE").  To do this you run the 
  1274. program LanRel with one of the following syntaxes:
  1275.  
  1276.  LanRel \Pipe\Release
  1277.  
  1278.  LanRel \\Srvname\Pipe\Release
  1279.  
  1280.  if the port request pipe was called \Pipe\Release.  It is possible to use both 
  1281. local and remote pipes, so you can suspend Os2You on your local or LAN Os2You 
  1282. Host.  The pipe name may also be a pipe bridged by the LanBridg software.
  1283.  
  1284.  When Os2You gets a port request, it releases the communication port and halts 
  1285. for one (1) minute, leaving the port available.  By using LanRel you will have 
  1286. 1 minute to start any other communication program accessing the port, and 
  1287. Os2You will remain suspended until the port is available again.  Os2You 
  1288. automatically detects when the port is available again, and will resume its 
  1289. operation again.  The port is re-initialized when operation is resumed.
  1290.  
  1291.  It is also possible to access the port directly with LanTerm or LanTerm2 by 
  1292. starting these programs with the Port request pipe name as a parameter to the 
  1293. LanTerm(2) program, instead of the communication device name 
  1294.  
  1295.  
  1296. ΓòÉΓòÉΓòÉ 15. Multi user configuration ΓòÉΓòÉΓòÉ
  1297.  
  1298. Multi user configuration 
  1299.  
  1300.  By using Os2You you may actually use OS/2 in a multi user like manner.  Note 
  1301. that Os2You lacks any sort of security control for file managing, which a 
  1302. "normal" multi user operating system includes.
  1303.  
  1304.  
  1305. ΓòÉΓòÉΓòÉ 16. Compatibility with other programs ΓòÉΓòÉΓòÉ
  1306.  
  1307. Compatibility with other programs 
  1308.  
  1309.  The following programs are tested and seems to work with Os2You (to be run via 
  1310. Os2You remote).  Note that some tests were rather brief and compatibility is 
  1311. not guaranteed (if not otherwise noted, programs are OS/2 versions):
  1312.  
  1313.  CMD.EXE 1.30 (IBM OS/2 1.30) and all full screen programs included with OS/2
  1314.  
  1315.  4OS2.EXE 0.95 (problems with forced termination)
  1316.  
  1317.  Brief 3.0 (some ALT-key combinations will react very slowly)
  1318.  
  1319.  JPI TopSpeed environment and VID 
  1320.  
  1321.  MS C 6.00, PWB and other compiler components (CVP program output fails)
  1322.  
  1323.  IBM Lan Server 1.3 (NET-program)
  1324.  
  1325.  M2Zmodem
  1326.  
  1327.  TE/2
  1328.  
  1329.  Logicomm
  1330.  
  1331.  Ckoker (Kermit)
  1332.  
  1333.  Os2You (and included programs like LanTerm and LanTerm2)
  1334.  
  1335.  MsgEd 2.06
  1336.  
  1337.  Binkley term 2.30
  1338.  
  1339.  Maximus 2.00
  1340.  
  1341.  Ommm 1.40
  1342.  
  1343.  ConfMail 2.0/3.31
  1344.  
  1345.  Mountain FileSafe streamer software 
  1346.  
  1347.  PKZip 1.02 (and included programs)
  1348.  
  1349.  Zoo 1.51
  1350.  
  1351.  LHarc 1.13
  1352.  
  1353.  DDump 0.01 hex editor 
  1354.  
  1355.  Hack 1.03
  1356.  
  1357.  NetHack 3.0
  1358.  
  1359.  Column (tetris like game)
  1360.  
  1361.  Tetris2
  1362.  
  1363.  Cave (adventure game)
  1364.  
  1365.  COMMAND.COM (DOS)
  1366.  
  1367.  WordPerfect 5.0 (DOS)
  1368.  
  1369.  Turbo Pascal 5.0
  1370.  
  1371.  The following programs are tested and do not work with Os2You:
  1372.  
  1373.  Lotus 1-2-3 3.0 (keyboard input works but no screen output)
  1374.  
  1375.  Note:  The above programs are trademarks of their respective company.
  1376.  
  1377.  
  1378. ΓòÉΓòÉΓòÉ 17. Command line options ΓòÉΓòÉΓòÉ
  1379.  
  1380. Command line options 
  1381.  
  1382.  If you want to start the program from the OS/2 Command prompt without the 
  1383. phone answering capabilities, or want to call the program from your own 
  1384. application, the program is started with some parameters.  The program may use 
  1385. a hot file handle (already opened).
  1386.  
  1387.  It is the callers responsibility to set the communication port as wanted, and 
  1388. Os2You will use the current settings when called.
  1389.  
  1390.  When the program exits, it restores the communication port to its previous 
  1391. state.  If a program was successfully spawned the program will exit with 
  1392. Exit-code set to zero.  If the program failed by any reason, the Exit-code will 
  1393. be set to a non zero value.
  1394.  
  1395.  The parameters may be entered at the command line or/and set in the 
  1396. environment variable OS2YOU.  If both the environment variable and a command 
  1397. line is entered, the environment variable will be parsed first and the command 
  1398. line after that, making command line parameters override any settings in the 
  1399. environment variable.  The environment variable is set by the SET OS2YOU=xxx 
  1400. xxxx xxxx xxx command.  The following parameters are available (note that they 
  1401. should be lower case).
  1402.  
  1403. Switch                   Description 
  1404.  
  1405. -c <fname>               Use the configuration file <fname>. This option is 
  1406.                          only valid if you use HOST mode or callback 
  1407.                          processing. 
  1408.  
  1409. -d                       Do not detect carrier loss.  Normally the program 
  1410.                          monitors the carrier and close the remote session if 
  1411.                          carrier is lost.  By adding this parameter you 
  1412.                          override this behavior. 
  1413.  
  1414. -e <fname>               Execute program <fname> for the remote session 
  1415.                          (typically CMD.EXE).  This parameter is the last one 
  1416.                          read by Os2You.  All following parameters are sent to 
  1417.                          the called program. Default is CMD.EXE. 
  1418.  
  1419. -f <decint>              Delay between screen updates with <decint> 
  1420.                          milliseconds.  Default is 100 mSecs (0.1 seconds). 
  1421.  
  1422. -g <session-name>        Go to session <session-name> directly. 
  1423.  
  1424. -h                       Invoke host mode (default if no device name is 
  1425.                          specified). You must specify the "-c" switch in 
  1426.                          combination with this option.  Note that the user 
  1427.                          access information (like task switching access, 
  1428.                          command shell, terminal emulation and so on) are 
  1429.                          retrieved from the configuration file specified with 
  1430.                          the "-c" switch, and parameters on the command line 
  1431.                          are ignored. 
  1432.  
  1433. -i <decint>              Exit if keyboard inactive in <decint> seconds.  If set 
  1434.                          to zero no inactivity time-out is used.  Note that 
  1435.                          only the keyboard activity is monitored, and that the 
  1436.                          inactivity counter is active even if the screen 
  1437.                          alters. Default is zero (no inactivity counter). 
  1438.  
  1439. -l <dname>               Use device <dname> for communication. If <dname> is 
  1440.                          replaced by a percent sign and a decimal value (for 
  1441.                          example %5), the program will use the device handle (5 
  1442.                          in the example) for communication.  The program may 
  1443.                          also use pipes handles for communication. This 
  1444.                          parameter has no default value, and if the parameter 
  1445.                          is omitted, the program will start up in HOST mode. 
  1446.  
  1447. -n <uname>               Use parameters for user <uname> in the configuration 
  1448.                          file, including callback processing to <uname>.  This 
  1449.                          parameter is only valid if you do not start the 
  1450.                          program in HOST mode.  If you want to include spaces 
  1451.                          in the <uname> you should replace the space by an 
  1452.                          underscore "_", or surround the parameter with double 
  1453.                          quotes. Default is to not use any entries in the 
  1454.                          configuration file. 
  1455.  
  1456. -p                       Use physical screen area for remote.  If this 
  1457.                          parameter is specified the program will use the 
  1458.                          physical screen area for remote, and not the screen 
  1459.                          area owned by the session.  If this parameter is 
  1460.                          specified you can't use the -s parameter. Default is 
  1461.                          to use the session screen area. 
  1462.  
  1463. - prn <dname>            Redirect printer output for <dname> to the remote 
  1464.                          printer.  This parameter works in combination with the 
  1465.                          -redir option. 
  1466.  
  1467. -prty <decint>           Screen update priority <decint> 0-39. This parameter 
  1468.                          sets the priority for the remote screen update thread. 
  1469.                          Zero is the lowest priority and 39 the highest. 
  1470.                          Priority 0-9 executes with IDLE priority, 10-19 has 
  1471.                          REGULAR priority, 20-29 HIGH priority and 30-39 TIME 
  1472.                          CRITICAL priority.  If priority is set to 14 the 
  1473.                          screen update thread has the exact same priority as 
  1474.                          the executed program. Default is 14 giving the update 
  1475.                          thread exactly the same priority as the executing 
  1476.                          program.  Setting the priority to a higher value (15) 
  1477.                          may result in smother operation. 
  1478.  
  1479. -redir <decint>          Specifies how printer redirection should work.  If 
  1480.                          <decint> is 1, printer output will go to local (host) 
  1481.                          printer.  If <decint> is 2 printer output will be 
  1482.                          redirected to the remote printer.  If <decint> is 3 
  1483.                          printer output will be redirected to the remote 
  1484.                          printer, but also sent to the local (host) printer. 
  1485.  
  1486. -s                       Disable the built in task switcher and physical 
  1487.                          screen. If you don't want the remote user to be able 
  1488.                          to switch between running tasks, you should disable 
  1489.                          this feature.  If this parameter is specified you 
  1490.                          can't use the -p parameter.  Default is to enable the 
  1491.                          task switcher. 
  1492.  
  1493. -t <fname>               Use terminal definition file <fname>. The file 
  1494.                          extension .PRM is added if no extension is included. 
  1495.                          This parameter has no default value, instead the 
  1496.                          program has a built in table for ANSI terminal 
  1497.                          emulation. 
  1498.  
  1499. Examples:
  1500.  
  1501.  Os2You -l COM1 -f 1000 -i 300 -e CMD.EXE /K DIR 
  1502.  
  1503.  This command will tell Os2You to use COM1 and update the screen each 1000 
  1504. millisecond.  If no remote keystroke is received within 300 seconds the program 
  1505. will be forced to exit. CMD.EXE is loaded for remote operation with the 
  1506. parameters /K DIR (which will tell CMD.EXE to display a directory list).
  1507.  
  1508.  Os2You -l %4 -f 100 -i 0 -d -e CMD.EXE
  1509.  
  1510.  This command will tell Os2You to use device handle 4 (decimal value) and 
  1511. update the screen each 100 millisecond.  If carrier i lost the program will be 
  1512. terminated. but no inactivity timer is set.
  1513.  
  1514.  Os2You -l %4 -f 100 -i 0 -d -n Mikael_Wahlgren
  1515.  
  1516.  This command is similar to the previous example, except that the program will 
  1517. spawn the program and use the parameters indicated by the username Mikael 
  1518. Wahlgren in the configuration file.  By using the -n option it is possible to 
  1519. spawn different session depending on username.
  1520.  
  1521.  To be compatible with MaxPipe (TM of Peter Fitzsimmons) an alternate calling 
  1522. syntax is automatically invoked, if the first parameter does not begin with a 
  1523. minus sign "-".  In this case, the syntax will be like:
  1524.  
  1525.  Os2You <device> <prgname> <parm1> ... <parmN> 
  1526.  
  1527. <device>       Tells which communication device to use.  It is possible to pass 
  1528.                a hot device handle by replace the device name with a number 
  1529.                corresponding to a the device handle decimal coded (like %4). 
  1530.                The device name may be replaced by a pipe name, but special care 
  1531.                should be taken, when using this possibility.  The best choice 
  1532.                when using pipes is to use the stand alone interface. 
  1533.  
  1534. <prgname>      Tells which program to load for remote operation. (Typically 
  1535.                CMD.EXE). 
  1536.  
  1537. <parm1> ...    The remaining parameters are optional and are passed as 
  1538.                parameters to <parmN> ... <prgname>. 
  1539.  
  1540. All other values are set to their default when using this syntax. To select 
  1541. which communication parameters to use, you should use the MODE program, 
  1542. included with the operating system.  See more in the documentation for the 
  1543. operating system to see how to configure your communication line.  All 
  1544. communication parameters set with MODE, will be used with Os2You.
  1545.  
  1546.  Example:
  1547.  
  1548.  MODE COM1:2400,N,8,1,OCTS=ON,DTR=ON,RTS=HS,BUFFER=ON
  1549.  
  1550.  This command will tell Os2You to use baud rate 2400, no parity, 8 data bits, 1 
  1551. stop bit, hardware handshaking CTS/RTS and use the extended hardware buffering capabilities.
  1552.  
  1553.  If you want to install Os2You with Maximus (TM) BBS, these lines may be of help:
  1554.  
  1555.  UsrRemote Xtern_Run OS2YOU.EXE_-l_%%%P_-f_1000_-i_300_-t_ANSI Sysop "/OS-2"
  1556.  
  1557.  Update delay 1 second, inactivity time-out 300 seconds, terminal ANSI, spawn a 
  1558. CMD.EXE session.
  1559.  
  1560.  UsrRemote Xtern_Run OS2YOU.EXE_-l_%%%P_-e_MyProg.EXE Sysop "/OS-2"
  1561.  
  1562.  Use Os2You defaults, spawn program MyProg.EXE
  1563.  
  1564.  
  1565. ΓòÉΓòÉΓòÉ 18. Use within a BBS ΓòÉΓòÉΓòÉ
  1566.  
  1567. Use within a BBS 
  1568.  
  1569.  This program can be used to access the command prompt from your BBS, for 
  1570. maintenance, or to run programs as doors within the BBS.  The following is some 
  1571. examples of how to install Os2You in a BBS (Maximus 2.00)
  1572.  
  1573.  Start a command prompt from Maximus with the following syntax:
  1574.  
  1575.  UsrRemote Xtern_Run Os2You.EXE_-l_%%%P_-f_1000_-s_-t_ANSI_-e_CMD.EXE Normal "Shell"
  1576.  
  1577.  Start an OS/2-program called "MyProg" from Maximus with the following syntax:
  1578.  
  1579.  UsrRemote Xtern_Run Os2You.EXE_-l_%%%P_-f_1000_-s_-t_ANSI_-e_CMD.EXE_/C_MyProg 
  1580. Normal "MyProg"
  1581.  
  1582.  Start a DOS-program called "MyDOS" from Maximus with the following syntax:
  1583.  
  1584.  UsrRemote Xtern_Run 
  1585. Os2You.EXE_-l_%%%P_-f_1000_-s_-t_ANSI_-g_"DOS.BAT"_-e_CMD.EXE_/C_DOS Normal "MyDOS"
  1586.  
  1587.  You should have a batch file called DOS.BAT like this: 
  1588.  
  1589. @echo off
  1590. MYDOS
  1591.  
  1592.  
  1593. ΓòÉΓòÉΓòÉ 19. Commonly asked questions and problems ΓòÉΓòÉΓòÉ
  1594.  
  1595. Commonly asked questions and problems 
  1596.  
  1597.  What terminal program should I use to communicate with Os2You and which 
  1598. terminal emulation mode?
  1599.  
  1600.  For the best possible emulation, you should use the included LanTerm (for DOS) 
  1601. or LanTerm2 (for OS/2).  If you want to use your favorite terminal program you 
  1602. should select ANSI-BBS emulation if it is available and the built in or 
  1603. ANSI.PRM terminal mode in Os2You.
  1604.  
  1605.  When started in HOST-mode configured for a cable connection, Os2You loops 
  1606. around, asking for <Enter> and eventually logon parameters, even if no user are calling.
  1607.  
  1608.  If you have installed Os2You for cable, Os2You relies entirely on the DCD 
  1609. (Data Carrier Detect) signal on the RS232-interface to reflect the real carrier 
  1610. state.  DCD is a signal that tells the computer that the modem is connected to 
  1611. another modem.  You have to verify that the signal on the RS232 interface is 
  1612. connected to the signal at the modems interface, and that the modem is 
  1613. configured to reflect the real carrier state.
  1614.  
  1615.  When logging on to Os2You HOST mode, I first get a lot of garbage characters, 
  1616. before I get the Press Enter message.
  1617.  
  1618.  This is normal, if you use a cable connection and you have configured Os2You 
  1619. for multiple baud rates. Os2You tries to find the correct baud rate for you.
  1620.  
  1621.  The screen doesn't scroll correctly.
  1622.  
  1623.  Scrolling has proved to be the hardest part to implement. This has to do with 
  1624. the fact that the Os2You program has no way to find out how many lines your 
  1625. terminal program on the remote has.  The built in ANSI driver in Os2You sends a 
  1626. command to move the cursor down 999 lines and sends a LF.  If the built in ANSI 
  1627. terminal doesn't work, you should modify ANSI.PRM (or the terminal definition 
  1628. file that is appropriate for your terminal), and alter the scroll sequences.
  1629.  
  1630.  Background colors are not displayed correctly at the remote screen, using ANSI colors.
  1631.  
  1632.  When Os2You sends a ClrEol (Clear to end of line) sequence, it assumes that 
  1633. the line is cleared with the attribute currently in use.  This is how it works 
  1634. in the ANSI driver for OS/2.  Some terminal emulators though, fill the cleared 
  1635. line with the standard attribute in opposite to the currently used attribute.
  1636.  
  1637.  When running some programs, I don't get any output from it.
  1638.  
  1639.  Os2You is not compatible with programs running in Presentation Manager. Some 
  1640. programs running in OS/2 full screen text sessions require the physical screen 
  1641. buffer. Those programs won't be 100% compatible with Os2You, but you might be 
  1642. able to run the program if you use the task switcher and switch to the 
  1643. offending program, as programs selected by the task switcher will run in the 
  1644. foreground and have the physical screen adressable.
  1645.  
  1646.  When running some programs, I get output from the program, but the keyboard 
  1647. doesn't seem to work.
  1648.  
  1649.  The programs keyboard handling is not compatible with Os2You.  Please report 
  1650. the problem, and if possible, send a copy of the offending program.
  1651.  
  1652.  
  1653. ΓòÉΓòÉΓòÉ 20. Hardware information ΓòÉΓòÉΓòÉ
  1654.  
  1655. Hardware information 
  1656.  
  1657.  This section contains some useful technical hardware information, like modem 
  1658. cabling and hardware selection.  If you click at the plus sign on the left of 
  1659. this header in the main menu, you will get a list of available items. 
  1660.  
  1661.  
  1662. ΓòÉΓòÉΓòÉ 20.1. Hardware requirements ΓòÉΓòÉΓòÉ
  1663.  
  1664. Hardware requirements 
  1665.  
  1666.  Os2You should run on any system that can run OS/2 Presentation Manager and 
  1667. OS/2 Full Screen text applications. 
  1668.  
  1669. o Os2You assumes that you use a display card with 2 bytes/character attribute 
  1670.   format, compatible with the CGA/EGA/VGA standards. 
  1671.  
  1672. o Os2You have modest memory requirements, and should run fine with almost any 
  1673.   system that can run OS/2. 
  1674.  
  1675. o Os2You is compatible with any asynchronous port, compatible with the OS/2 
  1676.   specification.  FIFO buffering can be used, and is recommended. 
  1677.  
  1678. o Os2You can use any Hayes compatible modem, and it should be possible to 
  1679.   configure Os2You for almost any automatic modem.  MNP5 or V.42" data 
  1680.   compression is very valuable when using Os2You. 
  1681.  
  1682. o Os2You emulates an enhanced keyboard. 
  1683.  
  1684. Os2You is developed in the following environment: 
  1685.  
  1686. o 486/33, 16 Mb RAM, ATI Graphics Ultra, Adaptec 1542B SCSI controller 
  1687.   (requester) 
  1688.  
  1689. o 386SX/25, 16 Mb RAM, CGA, IDE controller (server). 
  1690.  
  1691. o OS/2 2.0 GA (XR02000) on both machines. 
  1692.  
  1693. o IBM Lan Server 2.0 Entry Version (beta release). 
  1694.  
  1695. o 3Com Etherlink II/16 3C503 Ethernet network adapter (thin ethernet). 
  1696.  
  1697. o Two Octocom OSI 8596 V.32" modems (version 3.20) connected to 16550 UARTs. 
  1698.  
  1699. o JPI TopSpeed Modula-2 3.01, JPI TopSpeed Assembler 3.01, IBM Cset/2 (beta), 
  1700.   IBM Toolkit 2.0 (beta). 
  1701.  
  1702. In addition to the above environment, the network is reconfigured to run Novell 
  1703. OS/2 2.0 NetWare Requester (beta) with the Named Pipe Support (using SPX), for 
  1704. compatibility tests with Os2You. 
  1705.  
  1706.  
  1707. ΓòÉΓòÉΓòÉ 20.2. Creating a null-modem ΓòÉΓòÉΓòÉ
  1708.  
  1709. Creating a null-modem
  1710.  
  1711.  If you use Os2You to access an OS/2 session from a computer or terminal using 
  1712. a cable, this is how such a cable (null-modem) should be configured, to work 
  1713. with Os2You. 
  1714.  
  1715. 25 Dsub             25 Dsub
  1716. TxD  2 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 3  RxD
  1717. RxD  3 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 2  TxD
  1718. RTS  4 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 5  CTS
  1719. CTS  5 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 4  RTS
  1720. GND  7 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 7  GND
  1721. DTR 20 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ 6  DSR
  1722.                 ΓööΓöÇΓöÇ 8  DCD
  1723. DSR 6  ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 20 DTR
  1724. DCD 8  ΓöÇΓöÇΓöÿ
  1725.  
  1726. 9 Dsub              9 Dsub
  1727. TxD  3 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 2  RxD
  1728. RxD  2 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 3  TxD
  1729. RTS  7 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 8  CTS
  1730. CTS  8 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 7  RTS
  1731. GND  5 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 5  GND
  1732. DTR  4 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ 6  DSR
  1733.                 ΓööΓöÇΓöÇ 1  DCD
  1734. DSR  6 ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 4  DTR
  1735. DCD  1 ΓöÇΓöÇΓöÿ
  1736.  
  1737. 9 Dsub              25 Dsub
  1738. TxD  3 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 3  RxD
  1739. RxD  2 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 2  TxD
  1740. RTS  7 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 5  CTS
  1741. CTS  8 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 4  RTS
  1742. GND  5 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 7  GND
  1743. DTR  4 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ 6  DSR
  1744.                 ΓööΓöÇΓöÇ 8  DCD
  1745. DSR  6 ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 20 DTR
  1746. DCD  1 ΓöÇΓöÇΓöÿ
  1747.  
  1748.  
  1749. ΓòÉΓòÉΓòÉ 20.3. Creating a modem cable ΓòÉΓòÉΓòÉ
  1750.  
  1751. Creating a modem cable 
  1752.  
  1753.  If you use Os2You with an asynchronous modem, this is how the cable between 
  1754. your computer and modem should look like to work with Os2You. 
  1755.  
  1756. 25 Dsub             Modem
  1757. TxD  2 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 2
  1758. RxD  3 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 3
  1759. RTS  4 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 4
  1760. CTS  5 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 5
  1761. DSR  6 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 6
  1762. GND  7 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 7
  1763. DCD  8 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 8
  1764. DTR 20 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 20
  1765.  
  1766. 9 Dsub              Modem
  1767. TxD  3 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 2
  1768. RxD  2 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 3
  1769. RTS  7 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 4
  1770. CTS  8 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 5
  1771. DSR  5 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 6
  1772. GND  5 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 7
  1773. DCD  1 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 8
  1774. DTR  4 ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ 20
  1775.  
  1776.  
  1777. ΓòÉΓòÉΓòÉ 21. Programming information ΓòÉΓòÉΓòÉ
  1778.  
  1779. Programming information 
  1780.  
  1781.  This section contains some useful technical programming information. If you 
  1782. click at the plus sign on the left of this header in the main menu, you will 
  1783. get a list of available items. 
  1784.  
  1785.  
  1786. ΓòÉΓòÉΓòÉ 21.1. Communication with pipes ΓòÉΓòÉΓòÉ
  1787.  
  1788. Communication with pipes 
  1789.  
  1790.  Os2You creates a named pipe with unlimited pipe instances possible. The pipe 
  1791. is a full duplex message pipe with no write behind allowed. Os2You tries to 
  1792. allocate a 16 Kbyte output buffer and 1 Kbyte input buffer, but will work with 
  1793. any buffer size actually supplied by the API.
  1794.  
  1795.  If the pipe is broken by Os2You, this will mean that Os2You has ended the 
  1796. conversation with the terminal program.
  1797.  
  1798.  If the pipe is broken by the terminal program during a conversation, Os2You 
  1799. will treat this as a carrier loss, and try to end the running program, and the 
  1800. current remote session.
  1801.  
  1802.  Reading the pipe 
  1803.  
  1804.  A terminal program wishing to communicate with Os2You via pipes should 
  1805. preferable open the pipe in blocking mode and in message read mode.  Note that 
  1806. when coding for a single tasking environment (like DOS), it might be necessary 
  1807. to use non blocking mode, as you have to serve writing, even if you don't get 
  1808. anything reading the pipe.  It is possible to put the Os2You program in "Anti 
  1809. blocking mode", which means that Os2You will send "empty" messages (=Flag set 
  1810. to 0) to prevent blocking when reading the pipe.  This is done by sending first 
  1811. Esc and then zero (1Bh, 00h).  A message will have the following structure: 
  1812.  
  1813.   RECORD
  1814.     Flag     : CHAR;                     (* One byte character *)
  1815.     CurRow   : CARDINAL;                 (* Two byte unsigned integer *)
  1816.     CurCol   : CARDINAL;                 (* Two byte unsigned integer *)
  1817.     Length   : CARDINAL;                 (* Two byte unsigned integer *)
  1818.     Reserved : ARRAY [1..30000] OF CHAR; (* 30000 byte character buffer *)
  1819.   END;
  1820.  
  1821. The message is of variable size.  When a message is received, the Flag 
  1822. character will reflect the type of message received.
  1823.  
  1824.  If Flag is set to 00H this indicates the session begins.  No special action is 
  1825. required of the terminal program, but it might send a Esc-b sequence to set 
  1826. Os2You to binary screen mode.
  1827.  
  1828.  If Flag is set to 01H this indicates a cursor position command.  The CurRow 
  1829. and CurCol parameters will contain the cursor positions the terminal program 
  1830. should set.  If the Length value is non-zero a new message will follow 
  1831. immidiatly, containing a direct image of the video buffer.  The whole message 
  1832. (or as much of it that is allowed by the terminal programs screen size), should 
  1833. be placed in the logical video buffer, and be displayed.  Note, that if CurRow 
  1834. and CurCol both are set to 65535 (all bits set), this means that the Os2You 
  1835. session is ending.
  1836.  
  1837.  If Flag is set to any other value than 00H or 01H, the whole message will 
  1838. contain text that should be displayed at the screen with a ordinary write 
  1839. command.  It might contain ANSI-sequences, so your terminal program should set 
  1840. the ANSI-mode on.
  1841.  
  1842.  If the terminal can't read the pipe in message mode, it is still possible to 
  1843. get all functionality using ordinary byte stream mode, although this will 
  1844. require more coding.  It is recommended to use non blocking mode when writing 
  1845. DOS-applications as DOS is not reentrant and you can't write to the pipe, while 
  1846. the program is blocked in a read operation.  The program should behave in the 
  1847. following manner:
  1848.  
  1849.  Read a block of any size from the pipe.  Scan and retain the position for the 
  1850. first occurance of a 00H byte in the block.  Scan and retain the position for 
  1851. the first occurance of a 01H byte in the block.
  1852.  
  1853.  Write the characters before the first occurance of 00H or 01H byte to screen, 
  1854. using ordinary write-commands.
  1855.  
  1856.  If the position for the 00H byte is less than the position for 01H byte, a 
  1857. Flag of 00H is assumed, and proper action is taken.
  1858.  
  1859.  If the position for the 01H byte is less than 00H byte a Flag of 01H is 
  1860. assumed.  Assure that you have at least six characters following the Flag byte, 
  1861. and map them to the message block showed above.  Set the cursor position 
  1862. according to this.  If the Length value is set in this block, you should read 
  1863. Length bytes further (including any previous read bytes not used yet), and move 
  1864. these bytes directly to video memory.
  1865.  
  1866.  Any trailing characters not yet used by previous decoding, should be rescanned 
  1867. and decoded again, until there are no 00H or 01H bytes in the remaining block. 
  1868. This remaining block should then be displayed using ordinary write commands.
  1869.  
  1870.  Note, that OS/2 1.2 and Lan Server 1.2 didn't work correctly sometimes when 
  1871. reading large messages from a remote pipe.  Therefore you should limit your 
  1872. pipe reads to maximum 4 kByte reads, and merge the next read with the current 
  1873. if you get the ERRROR_MORE_DATA error.
  1874.  
  1875.  Writing to the pipe 
  1876.  
  1877.  To send characters to Os2You, the terminal program should send messages of the 
  1878. length one byte, containing the ASCII-code of the character sent to Os2You.  It 
  1879. is important that no messages longer than 1 byte are sent over the pipe, as 
  1880. Os2You will just ignore the remaining part of the message or treat it as an 
  1881. invalid client, and end the conversation.  The same Esc sequences as described 
  1882. in the documentations are used when using pipes.
  1883.  
  1884.  Examples
  1885.  
  1886.  Here is an example on how the read pipe (message mode) thread looks like in 
  1887. Lanterm2.Mod: 
  1888.  
  1889. LOOP
  1890.   BytesRead := PipeRead();         (* Read Pipe and place result in Buffer *)
  1891.   CASE Buffer.Flag OF
  1892.     | CHR(0) : TempCh := CHR(27);
  1893.                Dos.Write(Handle,ADR(TempCh),1,BytesWritten);
  1894.                TempCh := 'b';
  1895.                Dos.Write(Handle,ADR(TempCh),1,BytesWritten);
  1896.     | CHR(1) : Vio.SetCurPos(Buffer.CurRow,Buffer.CurCol,0);
  1897.                IF Buffer.Length <> 0 THEN
  1898.                  BytesRead := PipeRead();
  1899.                  IF BytesRead > ScrLen THEN
  1900.                    Lib.WordMove(ADR(Buffer),LVBPtr,ScrLen DIV 2);
  1901.                  ELSE
  1902.                    Lib.WordMove(ADR(Buffer),LVBPtr,BytesRead DIV 2);
  1903.                  END;
  1904.                  Vio.ShowBuf(0,ScrLen,0);
  1905.                END;
  1906.       ELSE     Vio.WrtTTY(ADR(Buffer),BytesRead,0);
  1907.   END;
  1908. END;
  1909.  
  1910.  
  1911. ΓòÉΓòÉΓòÉ 21.2. Detecting if OS2You/PM2You is running ΓòÉΓòÉΓòÉ
  1912.  
  1913. Detecting if OS2You/PM2You is running 
  1914.  
  1915.  When a user has logged into OS2You, OS2You will try to open a public semaphore 
  1916. called \Sem\OS2You\Running and clear this semaphore.  When the user logs out 
  1917. the semaphore will be set again by OS2You.  An application that wants to 
  1918. determine if a user is logged in, should create a public semaphore with the 
  1919. name above and issue a DosSemSetWait.  See the example below : 
  1920.  
  1921.   IF Dos.OpenSem(Sem, '\Sem\OS2You\Running') = 0 THEN
  1922.     Dos.SemWait(Sem, -1);
  1923.   ELSE
  1924.     Dos.CreateSem(1, Sem, '\Sem\OS2You\Running')
  1925.     Dos.SemSetWait(Sem, -1);
  1926.   END;
  1927.   IO.WrStr('Running');
  1928.   WHILE Dos.SemWait(Sem, 0) = 0 DO
  1929.     Dos.Sleep(1000);
  1930.   END;
  1931.   IO.WrStr('-Closed');
  1932.  
  1933.  An application that wants to specificly determine if PM2You is running can use 
  1934. the same technique but use the semaphore name \Sem\PM2You\Running instead. 
  1935.  
  1936.  
  1937. ΓòÉΓòÉΓòÉ 22. Important license information ΓòÉΓòÉΓòÉ
  1938.  
  1939. Important license information 
  1940.  
  1941.  It is illegal (or at least unethical) to patch the program in any way.  Any 
  1942. reverse engineering (disassembling or monitoring) is not an approved use of the application.
  1943.  
  1944.  If you register the software with at least 500 SEK (about $75), or 250 SEK for 
  1945. Sysop/BBS use only, you will get a license file and a copy of the most recent 
  1946. version of the program.  By registering you will get the following benefits: 
  1947.  
  1948. o You will get a diskette with the most recent version of Os2You/M2Zmodem. 
  1949.  
  1950. o You will get rid of the introduction/registration screen during logon. 
  1951.  
  1952. o You will be able to run Os2You with 38400, 57600 and 115200 bauds. 
  1953.  
  1954. o You will be treated as registered user for all future release. 
  1955.  
  1956. o You can sleep at the night without having your conscience haunt you. 
  1957.  
  1958. If you use the program on a regular basis, or in commercial use, you must 
  1959. register with minimum the above mentioned sum for each machine running the 
  1960. Os2You program.  The LanTerm, LanTerm2 and LanBridg programs don't need any 
  1961. further registration, and may be used in unlimited instances, but an extra 
  1962. registration per each 20th instance of LanTerm or LanTerm2 is appreciated.
  1963.  
  1964.  Note that the file transfer option requires registration.  Neither the built 
  1965. in file transfer function or the Sz/Rz commands will work without this option.
  1966.  
  1967.  The sourcecode (in Modula-2) of the program is available, on special terms. 
  1968. Please contact me if this is of interest.
  1969.  
  1970.  You are encouraged to spread this program (without registration file) to 
  1971. anyone that might be interested.
  1972.  
  1973.  If you want to register, send Swedish banknotes, bank check (payable in 
  1974. Swedish bank) or pay with VISA or MasterCard by completing the order form 
  1975. printable from the file ORDER.DOC.
  1976.  
  1977.  The address is: 
  1978.  
  1979. Ridax programutveckling
  1980. Att: Mikael Wahlgren
  1981. Kransen 4E
  1982. S-416 72  GOTHENBURG
  1983. Sweden
  1984. Fax: +46 31 196417
  1985. Phone: +46 31 196074
  1986. Fidonet: Mikael Wahlgren 2:203/302.5
  1987. Internet: d9mikael@dtek.chalmers.se
  1988.  
  1989.  Use the following form to register your copy of Os2You and M2Zmodem: 
  1990.  
  1991.                                      INVOICE
  1992.  
  1993.                                                      Date: ___________
  1994.  
  1995.        TO:                                           FROM:
  1996.  
  1997.        Name: ____________________________________    Ridax programutveckling
  1998.                                                      Kransen 4E
  1999.        Company: _________________________________    S-416 72  Gothenburg
  2000.                                                      Sweden
  2001.        Address: _________________________________
  2002.  
  2003.        City, State; _____________________________
  2004.  
  2005.  
  2006.  
  2007.        Diskette format                  5.25" disk ____    3.5" disk ____
  2008.  
  2009.  
  2010.        Specification                             Amount Price Sum
  2011.        ========================================= ====== ===== ===========
  2012.  
  2013.        Os2You remote software (first 1-9)        ______   700  __________
  2014.  
  2015.        Os2You remote software (following 10-19)  ______   600  __________
  2016.  
  2017.        Os2You remote software (following 20-)    ______   400  __________
  2018.  
  2019.        Os2You for Sysops (for BBS use only)      ______   250  __________
  2020.  
  2021.        Os2You/M2Zmodem file transfer option      ______   300  __________
  2022.  
  2023.        WinTerm Windows 3.0 terminal program      ______   300  __________
  2024.  
  2025.        Telnet enhancer                           ______   300  __________
  2026.  
  2027.  
  2028.                                Total                      SEK  __________
  2029.  
  2030.  
  2031.        All prices are in SEK (Swedish crown).  One USD is about 5.50 SEK.
  2032.        The price for Os2You is about $125 and $50 for M2Zmodem.  The
  2033.        prices are valid for orders until January 1993.  For orders after
  2034.        that, please request the current prices.  For orders from Sweden
  2035.        25% Moms (VAT) should be added to the above prices.
  2036.  
  2037.        If you pay with VISA or MasterCard please fill in the following:
  2038.  
  2039.  
  2040.        Cardholders name: ________________________________________
  2041.  
  2042.        Cardholders address: _____________________________________
  2043.  
  2044.        Card number: _____________________________________________
  2045.  
  2046.        Card validy until: _______________________________________
  2047.  
  2048.        Signature: _______________________________________________
  2049.  
  2050.  
  2051.  
  2052.        Send or FAX a copy of this invoice to:
  2053.  
  2054.        Ridax programutveckling
  2055.        Kransen 4E
  2056.        S-416 72  Gothenburg
  2057.        Sweden
  2058.        Fax: +46 31 196417
  2059.        Phone: +46 31 196074
  2060.        Internet: d9mikael@dtek.chalmers.se
  2061.  
  2062.        You can also register by sending a mail via Internet, specifying
  2063.        your MasterCard/VISA credit card number, validy date, address
  2064.        and amount to pay in SEK.
  2065.  
  2066.  
  2067. ΓòÉΓòÉΓòÉ 23. Planned enhancements ΓòÉΓòÉΓòÉ
  2068.  
  2069. Planned enhancements 
  2070.  
  2071.  The following is a list a enhancements planned in a future release.  It isn't 
  2072. sure that the next release of the program will include these enhancements 
  2073. though. 
  2074.  
  2075. o SafeShell.  A menu program there you can install different programs, that you 
  2076.   can give different users access to. 
  2077.  
  2078. o SafeCMD.  A CMD.EXE replacement, that has file and directory security 
  2079.   implemented. 
  2080.  
  2081. o A BBS program, for writing/sending/reading mail, with file transfer 
  2082.   capabilities and much more, running under Os2You.  This program is meant to 
  2083.   be extremely easy to handle, and can be run over a LAN for internal messaging 
  2084.   purpose. 
  2085.  
  2086. o The NetBIOS and Mailslot interfaces are two demonstrations of the easy 
  2087.   interfacing to different protocols.  APPC/X.25 support is hopefully coming. 
  2088.  
  2089. o Support for parallell ports via cable. 
  2090.  
  2091. o PM Graphics Support is planned in the near future.  This will be an add-on to 
  2092.   the OS2You package, and by registering OS2You, you will get a cheap upgrade 
  2093.   path to the PM feature (registering OS2You now and upgrading to the PM 
  2094.   feature when available will be chaper than registering the PM feature only). 
  2095.  
  2096.  
  2097. ΓòÉΓòÉΓòÉ 24. Copyright notes ΓòÉΓòÉΓòÉ
  2098.  
  2099. Copyright notes 
  2100.  
  2101. OS/2      is a trademark of IBM Corporation. 
  2102.  
  2103. PS/2      is a registered trademark of IBM Corporation. 
  2104.  
  2105. IBM       is a registered trademark of International Business Machines 
  2106.           Corporation. 
  2107.  
  2108. DSZ       is a trademark of Omen Technology Incorporated. 
  2109.  
  2110. 386/SX    might be a trademark of Intel Corporation. 
  2111.  
  2112. Novell    is a trademark of Novell Inc. 
  2113.  
  2114. Microsoft is a trademark of Microsoft Corporation. 
  2115.  
  2116. Hayes     is a trademark of Hayes Microcomputer Products. 
  2117.  
  2118.  
  2119. ΓòÉΓòÉΓòÉ 25. Release log ΓòÉΓòÉΓòÉ
  2120.  
  2121. Release log Bugs and improvements not described elsewhere are documented in 
  2122. this section. 
  2123.  
  2124. 1.0       First release 
  2125.  
  2126. 1.1       The program could terminate with a GP error when run on a PS/2 
  2127.           system.  The port-parameters was not correctly restored.  This is now 
  2128.           corrected. 
  2129.  
  2130. 1.2       Improvements 
  2131.  
  2132. 1.3       Improvements 
  2133.  
  2134. 1.4       Improvements 
  2135.  
  2136. 1.5       Bug, that made the program incompatible with some programs 
  2137.           (especially programs polling the keyboard) is fixed. 
  2138.  
  2139. 1.6       Improvements 
  2140.  
  2141. 1.7       Some scancodes adjusted to make the CTRL-key, Enter-key and some 
  2142.           other special keys more compatible with some programs.
  2143.  
  2144.            The command line syntax is altered. 
  2145.  
  2146. 1.8       LAN/Pipe operation fixed again.  Previous LanTerm2 didn't work due to 
  2147.           a serious compiler bug.
  2148.  
  2149.            The configuration file is opened in Deny Write mode for security 
  2150.           reasons.  This makes it impossible to modify the configuration file 
  2151.           during an session. 
  2152.  
  2153. 1.9       The Allow Task Switch option in the login table is now used to 
  2154.           disable the task switch and the Break-functions.
  2155.  
  2156.            If the -s option is used or Allow Task Switch option is set to no in 
  2157.           the user profile, the user won't be able to use the Esc-c, Esc-Break 
  2158.           sequences (to end the session abnormally).
  2159.  
  2160.            Now Break scancodes are also sent.
  2161.  
  2162.            Lanterm.EXE (LAN-operation for DOS workstations) are now included again.
  2163.  
  2164.            Better shutdown operation, when a program gets stuck, or user lost 
  2165.           carrier.  REXX-sessions are shutdown correctly.
  2166.  
  2167.            Terminal configurable in user table.
  2168.  
  2169.            The configuration file is optionally (configurable) opened in Deny 
  2170.           Read/Write mode. 
  2171.  
  2172. 1.91      Fix to get the program work with LAN Server 1.2 CSD 4093 and DOS 
  2173.           Requesters.  Also tested successfully using Novell server and remote 
  2174.           named pipes.
  2175.  
  2176.            LanBridge added, to run OS/2 LAN Requesters remote over LAN.
  2177.  
  2178.            If program can't be killed, when exiting the session, Os2You will go 
  2179.           back to login screen.  Next user will probably get confused, because 
  2180.           the previous program is still alive.
  2181.  
  2182.            -s (disable task list) is default when using MaxPipe parameter syntax.
  2183.  
  2184.            LanTerm and LanTerm2 programs are altered, to change the behaviour 
  2185.           of the Esc-key.  If the Esc-key in LanTerm(/2) is pressed the program 
  2186.           will send double Esc-codes making Os2You send one Esc-sequence to the 
  2187.           application.  If you press Shift-Esc in the LanTerm(/2) program will 
  2188.           send just one Esc-code, making Os2You to wait for an Esc-sequence (or 
  2189.           displaying the help screen). 
  2190.  
  2191. 2.0       Color attributes are now transfered to the remote screen, by using 
  2192.           ANSI color escape sequences.  It is default to use ANSI colors when 
  2193.           no terminal definition file or an old definition is loaded.  To 
  2194.           upgrade your old terminal definition files, select terminal 
  2195.           definition from the Os2You menu, and modify the ANSI color entry. 
  2196.           Your other definitions will be intact.
  2197.  
  2198.            The screen update handling is altogether rewritten.  In some 
  2199.           respects it is faster, but in some situations it might also be slower 
  2200.           than before.  The terminal does not need to wrap at end of lines 
  2201.           anymore. The program now supports different screen widthes and 
  2202.           heights.  The program assumes that you are running the application in 
  2203.           color mode (two bytes per character cell).  If this is not the case, 
  2204.           the program will transfer false attributes (converting 
  2205.           underline/highlights to colors).
  2206.  
  2207.            The -n option now allows Os2You to directly spawn different sessions 
  2208.           depending on the username.  The callback, shell, terminal and switch 
  2209.           parameters are used from the login table.
  2210.  
  2211.            The COM-buffers are flushed by reading all available characters, in 
  2212.           addition to a DosDevIOCtl call, as the DosDevIOCtl call didn't seem 
  2213.           to work in some networking environments.
  2214.  
  2215.            The option to strip control characters (0-31) and high order 
  2216.           characters (127-255) are added in the terminal definition file. The 
  2217.           default, if no terminal definition file or an old definition is used, 
  2218.           is to strip control characters but leave high order characters.
  2219.  
  2220.            LanTerm/2 (for OS/2) and LanTerm (for DOS) are modified to accept 
  2221.           COM-ports from the command line.  Both program can be started with 
  2222.           the syntax LanTerm <COM-port> <baudrate>.  The COM-port must have a 
  2223.           name beginning with COM, and for the DOS-version only COM1 and COM2 
  2224.           are valid.  LanTerm (for DOS) requires that ANSI.SYS is loaded in 
  2225.           your CONFIG.SYS file.  Both programs take advantage of the FIFO 
  2226.           buffered 16550 UART if available.
  2227.  
  2228.            LanTerm/2 and LanTerm now have Zmodem AUTO download/upload 
  2229.           capability. To transfer files between host and remote, just issue a 
  2230.           file transfer command on the host (use the Rz or Sz command files and 
  2231.           M2Zmodem), and the file transfer program will start on both host and 
  2232.           remote.  If you upload from remote to host, you will be asked for a 
  2233.           filename/pattern. LanTerm/2 uses M2Zmodem, and LanTerm uses DSZ as 
  2234.           file transfer programs, and these programs must be available in the 
  2235.           current directory or in a path. 
  2236.  
  2237. 2.1       Fixed bug that left shifted the remote screen one column in some situations.
  2238.  
  2239.            Modem commands now configurable and stored in file MODEM.CFG.
  2240.  
  2241.            Box draw characters and special characters are translated into 
  2242.           available look alike characters (codepage 437), when terminal 
  2243.           definition file says to filter characters between 127-255.
  2244.  
  2245.            Keyboard emulation much enhanced with correct scan codes.  Now works 
  2246.           with programs like CodeView (TM) and MSC PWB.
  2247.  
  2248.            Dos2You program altered to exit by sending a Ctrl-C (03H).  Program 
  2249.           now exits clean and returns to Os2You correctly. 
  2250.  
  2251. 2.2       DTR control added in modem commands.
  2252.  
  2253.            Fixed bug that sent garbage modem commands, when modem commands was 
  2254.           of zero length.
  2255.  
  2256.            LanRel program addedd, to let other programs temporarily suspend 
  2257.           Os2You HOST-mode, to let other communication programs use the same 
  2258.           port/modem, while Os2You is waiting for an incoming call. It is also 
  2259.           possible to use LanTerm or LanTerm2 to access the port for outgoing 
  2260.           traffic port Os2You is using, by running these programs with the port 
  2261.           request pipe name as a parameter.
  2262.  
  2263.            Os2You now also acts as asynchronous communication server.  If 
  2264.           Os2You is installed on a network, it is possible to connect to the 
  2265.           COM device Os2You uses, with Lanterm(2) programs, by starting these 
  2266.           program with the port request pipe name as a parameter. File transfer 
  2267.           doesn't work though.
  2268.  
  2269.            Cursor positioning works even if you don't run your original session.
  2270.  
  2271.            M2Zmodem would hang Os2You and COM-device on some systems (like 
  2272.           Comp. 386/SX 20 Mhz and MS-OS/2 1.21).  This wasn't fixed in the 
  2273.           preliminary release. 
  2274.  
  2275. 2.3       Changed to new compiler, version 3.01.
  2276.  
  2277.            In HOST mode, Os2You no longer needs to scan for the baudrate when 
  2278.           using Hayes-modems or other automatic modems.  Os2You instead uses 
  2279.           the response strings sent by the modem.  When using Hayes/Auto 
  2280.           modems, the DCD line can be permanently SET.
  2281.  
  2282.            In HOST mode, Os2You now optionally displays a file, selected from 
  2283.           the configuration menu.
  2284.  
  2285.            In HOST mode, Os2You now optionally logs events in a file, selected 
  2286.           from the configuration menu.
  2287.  
  2288.            Configuration menus now with help texts! 
  2289.  
  2290. 2.4       Minor modification in the character translation logic.
  2291.  
  2292.            Screen updates faster with TAB space expansion.
  2293.  
  2294.            M2Zmodem version 2.11 will now support file transfers via pipes as 
  2295.           well as asynchronous lines.  This level of M2Zmodem is also required 
  2296.           for PMTerm.
  2297.  
  2298.            Task switching now works with OS/2 2.0.
  2299.  
  2300.            PMTerm - A terminal program for PM to run Os2You is included. (only 
  2301.           to registered users)
  2302.  
  2303.            Os2You is now able to use the baudrates 38400, 57600 and 115200, 
  2304.           without additional support from device drivers.  The line IOPL=YES or 
  2305.           IOPL=SETBAUD must be added to your CONFIG.SYS file to enable this 
  2306.           feature.  (only to registered users)
  2307.  
  2308.            It is now possible to pass parameters from the Os2You login table to 
  2309.           the spawned program.  You can pass User name (with %n), password 
  2310.           (%p), callback number (%c) and terminal type (%t).
  2311.  
  2312.            Modem configuration file renamed MODEM.PRM to MODEM.CFG.
  2313.  
  2314.            Setup program rewritten for Presentation Manager, and now easier to 
  2315.           use with more logical screens and ready modem setups.  Setup is 
  2316.           automaticly invoked when Os2You is started without any parameters, 
  2317.           but can be run directly from the command line by typing SETUP too. 
  2318.           The modem definitions are only briefly tested. 
  2319.  
  2320. 2.5       Os2You now seems to work OK with OS/2 2.0 (beta drop 6.149).  The 
  2321.           previous version had some problems with the keyboard monitor locking 
  2322.           up the second time, a user logged on.  A bug in OS/2 2.0 I think.
  2323.  
  2324.            LanTerm (terminal emulator for DOS), now can be run in terminate and 
  2325.           stay resident (TSR) mode (80 kByte), allowing you to concurrently use 
  2326.           both a remote OS/2 session and the local DOS session.
  2327.  
  2328.            User ID's with no password, are treated differently.  Now any 
  2329.           password is accepted for such ID's.  Entered passwords are logged to disk.
  2330.  
  2331.            Os2You now disconnects named pipes when a session is closed.
  2332.  
  2333.            Os2You now supports redirection of printers.  A printer's data 
  2334.           stream can be redirected to the remote computer.  This requires that 
  2335.           the terminal program on the remote, is capable of handling this. 
  2336.           LanTerm, LanTerm2 and PMTerm are currently capable of this.
  2337.  
  2338.            User-ID's and passwords with spaces wouldn't work.  This is now fixed.
  2339.  
  2340.            LanTerm and LanTerm2 now accepts an initialization string.  This 
  2341.           could be used for automatic dial and/or to initialize the modem.
  2342.  
  2343. 2.51      Os2You would trap intermittently, directly after logon Fixed.
  2344.  
  2345. 2.6       Os2You now has a service function menu.  By pressing Esc-y during a 
  2346.           session, you can select chat-mode and do file transfers, using Ymodem 
  2347.           batch protocol.
  2348.  
  2349.            Os2You now terminates sessions better.  Before Os2You could hang if 
  2350.           a session couldn't be closed, when a user exits (or drops carrier). 
  2351.           Os2You also exits cleaner when running independent sessions 
  2352.  
  2353.            LanTerm, LanTerm2 and PMTerm now has scripting capabilities. 
  2354.           Scripting works as in M2Zmodem, except that ^ means CR and ~ means pause.
  2355.  
  2356.            In OS/2 2.0 the DOS-compatibility boxes can be accessed remotely, 
  2357.           with some restrictions.  The DOS box can no longer be accessed, using 
  2358.           OS/2 1.3 as the programs supporting this feature, is no longer 
  2359.           distributed with the package. If you already have the DOS_REDIR and 
  2360.           DOS2YOU programs, they will probably continue to work.  These files 
  2361.           can also be requested especially, when registering.
  2362.  
  2363.            The Task Switched is altered in design.  It now also allows switch 
  2364.           to DOS Full Screen sessions directly, if you are using OS/2 2.0.
  2365.  
  2366.            PMTerm (terminal program for PM) is now renamed to Terminal/2, 
  2367.           because the name PMTerm was already occupied.
  2368.  
  2369.            A Windows terminal emulator is now included.  Note that this comes 
  2370.           from an independent source, and requires separate registration. 
  2371.           WinTerm, Terminal/2 and LanTerm2 all have Ymodem-Batch protocols 
  2372.           included, and also a special AUTO Ymodem up/download facility, that 
  2373.           automaticly will invoke the file transfer protocol when Os2You 
  2374.           request it.  Current levels are 1.0 for WinTerm, 1.1 for Terminal/2 
  2375.           and 2.6 for LanTerm2.  These levels are required for Os2You version 2.6.
  2376.  
  2377.            The inactivity timeout timer, would trigger if the system time was 
  2378.           changed. This is fixed.
  2379.  
  2380.            Improved screen updates in some cases.
  2381.  
  2382. 2.7       The service functions menu is only available if the user has task 
  2383.           switch privelige.
  2384.  
  2385.            The terminal emulation profiles, now have an option to escape (but 
  2386.           still transfer) control characters.  Some "hard to print" characters 
  2387.           can also be displayed using this feature.
  2388.  
  2389.            Cursor update delay for task switched sessions, is now configurable.
  2390.  
  2391.            Os2You running OS/2 2.0 (304e) would trap when exiting, if the 
  2392.           physical keyboard is under high load.  Os2You running OS/2 1.3 would 
  2393.           hang when exiting, if the keyboard buffer was full at that time.  Fixed.
  2394.  
  2395.            Switching to tasks on the second "page", wouldn't work.  This is fixed.
  2396.  
  2397.            File transfer with the built in file transfer protocol fixed.
  2398.  
  2399.            Special care was taken to terminate REXX batches correctly 
  2400.           previously.  This caused some problems with other programs, and is 
  2401.           therefore removed.  Other applications are now terminating better 
  2402.  
  2403.            Access to the MVDM (DOS-boxes) in OS/2 2.0 is now improved.  It is 
  2404.           now possible to emulate most character sequences in the DOS-box, like 
  2405.           function and arrow keys.  This is accomplished with the KBFILTER 
  2406.           utility that must be run in the DOS-box before function keys will 
  2407.           begin to work (you could invoke this program in your AUTOEXEC.BAT 
  2408.           file, it will take a minimum of memory and interfere very little with 
  2409.           your usual work).
  2410.  
  2411. 2.8       LanBridg operation fixed.
  2412.  
  2413.            NetBIOS and Mailslot operation now available.  This also allows 
  2414.           one-two-many operation, i.e. OS2You can send its output to any amount 
  2415.           of terminals over a network 
  2416.  
  2417.            IEMSI logon supported.
  2418.  
  2419.            LanTerm2 now enters command mode when pressing Keypad Enter (i.e. 
  2420.           the numeric keypad ENTER is equal to pressing Shift-Esc).
  2421.  
  2422.            Cursor updates works for MVDM (DOS-box) sessions too.
  2423.  
  2424.            The new option "-h" forces host mode when spawned with a "hot" 
  2425.           handle. This makes it possible to spawn OS2You in host mode from Binkley.
  2426.  
  2427.            Now Terminal/2, a PM Terminal program for OS2You, is included.
  2428.  
  2429.            The file transfer protocol driver OS2FTP is now included, allowing 
  2430.           command line file transfers with Xmodem, Xmodem-1K, Ymodem, Ymodem-G, 
  2431.           Zmodem and Kermit file transfer protocols.
  2432.  
  2433.            Os2You could sometimes hang after disconnecting.  Fixed (Flush-packet).
  2434.  
  2435. 2.9       On-line data compression implemented in OS2You, LanTerm2 and 
  2436.           Terminal/2 to increase throughput.  M2Zmodem version 2.14 also 
  2437.           features file transfers with data compression built in.
  2438.  
  2439.            Messages are now easily translated from a separate message database 
  2440.  
  2441.            Possible to reboot host with Esc-r (requires boot privelige)
  2442.  
  2443.            OS2You can now receive faxes with a faxmodem and an external program 
  2444.  
  2445.            LanTerm would not work after once getting NetBIOS initialization 
  2446.           failed (DELETE_NAME)
  2447.  
  2448.            DOS-sessions would die during heavy keyboard input in OS/2 version 2.x.
  2449.  
  2450.            An option to transfer small pipe-packets (for brain-dead Novell implementations)
  2451.  
  2452.            OS2You could refuse to answer after disconnect if an external 
  2453.           program during the session changed COM-port status.  OS2You now 
  2454.           resets the COM-port after each session to prevent this.
  2455.  
  2456.            In some situations the modem can lose the configuration and prevent 
  2457.           a caller from ever being answered by OS2You (like if the modem power 
  2458.           goes down).  There is now an option in OS2You to re-initialize the 
  2459.           modem every n-th minute.
  2460.  
  2461.            DOS-box access re-enabled for OS/2 1.x (have already been there for 
  2462.           OS/2 2.x).
  2463.  
  2464.  
  2465. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  2466.  
  2467. All strings sent to the modem may contain the following special control 
  2468. characters: 
  2469.  
  2470. ^ (5E)    CR 
  2471.  
  2472. ~ (7E)    1s pause 
  2473.  
  2474. ╨ä (F2)    DTR low 
  2475.  
  2476. ╤ö (F3)    DTR high 
  2477.  
  2478. ; (3B)    Comment 
  2479.  
  2480.  
  2481. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  2482.  
  2483. The following symbolic parameters are valid: 
  2484.  
  2485. %n        User name 
  2486.  
  2487. %t        Terminal 
  2488.  
  2489. %p        Password 
  2490.  
  2491. %c        Callback 
  2492.  
  2493. %%        % (percent sign) 
  2494.  
  2495. Example: BBS.EXE COM1 %n %p %%p
  2496.  
  2497.  If the user is Mikael Wahlgren and password secret the example would execute 
  2498. the program BBS.EXE with the parameters COM1 Mikael_Wahlgren secret %p 
  2499.  
  2500.  
  2501. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  2502.  
  2503. This entry expects an array of hex values.  You should enter hex values between 
  2504. 00 and F, all separated by space.
  2505.  
  2506.  Example: 1B 41 01 FE