
                            Console Server/32 v1.05

    Welcome to Console Server/32 (CS32) - the first powerfull, easy to use,
multifunctional gateway for console applications. Virtually, You can run any
console application (win32 console, dos, os/2-16, posix) on NT machine
remotely, using any type of connection to NT box. Some limited support is
available when running CS32 on Windows95 machine. The heart of this package
is cs32.exe. It requires two parameters - handles of input and output streams
to remote terminal. This handles can point to communication port, TCP/IP
socket, other network connection or user's communication device. Cs32 knows
nothing about what this handles points to, it just reads characters from
input stream, and places them in application's keyboard input buffer. Cs32
also watches application's screen output, and sends it to output stream. To
position cursor on remote terminal screen, and to set color attributes,
cs32 uses standard ANSI escape sequences.

    Cs32 autentificates remote user and sets corresponding user access rights
and user's home directory. Demo version does not perform any autentification.
Remote user will use access rights of front-end process. Be careful!

    When connection between remote terminal and cs32 is broken, cs32
terminates all started applications and exits.

        Files in this package:

cs32.exe      - the heart of this package, Console Server/32 itself.
cs32.txt      - this file.
telnetd.exe   - simple telnet daemon for use wits cs32. Allows access to NT
                machine using telnet protocol. No telnet options support.
terminal.exe  - front-end application between unopened communication port and
                cs32. With this application You can connect remote RS-232 text
                terminals to NT machine.
terminal.c    - source code of terminal.exe. Provided as sample of gateway
                between communication resource and cs32.
telnet.exe    - simple win32 console telnet client with user-defined keyboard
                layout.

        Installation.

    Unpack this stuff to any directory and run the desired gateway program.


        Running cs32 with FIDOnet mailer.

    To run cs32 with FIDOnet (tm) mailer as front-end between communication
port and cs32, You need win32 mailer with capability to pass handle to
opened communication port to external application. This version of cs32 has
been successfully tested with T-mail.NT.B by Andy Elkin (2:5030/15@fidonet).
Just place the next string to t-mail.ctl file:

Extern_Mail <password> you_path\cs32.exe *O *O


        Command line parameters.

cs32 Ihandle Ohandle [/ttime] [/m] [/c] [command]
-------------------------------------------------

where
      Ihandle, Ohandle - handles to opened input and output streams (decimal
                         values). Front-end program must assign Inheritted
                         attribute to this handles in order to cs32 can
                         access them. See terminal.c for details.
      /ttime           - limits connection time to "time" minutes. When this
                         time interval expires, cs32 terminates all started
                         applications, closes remote connection and exits.
                         This parameter is not available in demo version.
      /m               - causes cs32 to convert color screen attributes to
                         monochrome attributes. Useful with monochrome
                         terminals.
      /c               - do not watch Carrier Detect signal on communication
                         port. See terminal.c for example.
      command          - program to run after remote user autentification. Use
                         double quotes to place spaces to command line. If
                         omitted, the program defined by COMSPEC environment
                         variable will be started.

telnetd [-s] "command line for cs32"
------------------------------------

where
      -s               - start cs32 console windows visible. By default,
                         telnetd creates hidden child windows.

terminal comN /bval /pval /hval "command line for cs32"
-------------------------------------------------------

where
      comN             - communication port to open. N=1...
      /bval            - set baud rate to val (300, 1200,...,115200).
                         This parameter is not available in demo version.
      /pval            - set parity (n,e,o), data bits (7,8), stop bits (1,2).
                         This parameter is not available in demo version.
      /hval            - set handshake protocol (S - software XON/XOFF, H -
                         hardware RTS/CTS).
                         This parameter is not available in demo version.
telnet host [port]
------------------

where
      host             - name or IP address of remote host to connect to.
      port             - IP port to connect to. Default value 23 (telnet).


        Entering extended ASCII keystrokes.

    You can simulate pressing of extended IBM keyboard keys by entering
^A (CTRL-A) prifix. Available sequences are:

                               Alternate sequences (vt100 keys)
^Au - UP arrow.                 ESC[A
^Ad - DOWN arrow.               ESC[B
^Al - LEFT arrow.               ESC[D
^Ar - RIGHT arrow.              ESC[C
^Ap - Page Up (prev. page).     ESC[5~
^An - Page Down (next page).    ESC[6~
^Ah - Home.                     ESC[1~
^Ae - End.                      ESC[4~
^Ai - Insert.                   ESC[2~
^Ak - Del.                      ESC[3~
^A1 - F1                        ESC1    ESC[11~    ESCOP
^A2 - F2                        ESC2    ESC[12~    ESCOQ
^A3 - F3                        ESC3    ESC[13~    ESCOR
^A4 - F4                        ESC4    ESC[14~    ESCOS
^A5 - F5                        ESC5    ESC[15~
^A6 - F6                        ESC6    ESC[17~
^A7 - F7                        ESC7    ESC[18~
^A8 - F8                        ESC8    ESC[19~
^A9 - F9                        ESC9    ESC[20~
^A0 - F10                       ESC0    ESC[21~
^A- - F11
^A= - F12
^As - Shift
^Aa - Alt
^Ac - Ctrl

   You can combine this sequences, for example, to simulate Alt-F1 keystroke,
enter ^Aa^A1, to simulate Alt-X - ^Aax. Use terminal emulation programs with
redefinable function keys.


        Using telnet application.

   You can redefine any keystroke by pressing Alt-K. For example, to redefine
F1 key to send sequence ^A1, press Alt-K, then press F1 key, then enter string
\0011. You can use any ascii characters in key definition string. Use \nnn to
enter octal value of nonprintable character. Enter empty definition string to
abort redefinition.

   Press Alt-T to set telnet's windows caption title.

   Keys definitions are stored in system registry. You can use Regedt32
application to correct them. The values are stored in HKLM\Software\SOS\Telnet
subtree. Two registry files VT100.reg and CS32.reg with corresponding keyboard
definitions are provided in a full version. Just double click the desired file
in File Manager or Explorer window to import values into registry.

        Running cs32 under Windows95.

   You cannot run interactive dos applications. Cs32 can't put keystrokes to
keyboard input buffer of dos application under Windows95. Win32 console apps
runs just fine. A good choice is JP Software's 4nt command processor. Start
cs32 with 4nt as a command line argument. The second limitation of Windows95
environment - cs32 cannot terminate started dos applications.


        Known bugs.

1. Cs32 cannot put extended ASCII characters (with ASCII codes > 127) to
keyboard input buffer of DOS application under Windows NT, and to any
application under Windows95.

        Fixed Bugs.

1. Cs32 don't exits if connection broken when started by telnetd in hidden
window.
2. Fixed screen update problems running tenlet.exe on Windows95.
3. Cs32 works good now with Windows NT 4.0 beta.
4. Fixed (I hope :-) back scroll bug in telnet.exe
5. Fixed shift keys bug in cs32.exe
6. Added trivial negotiation support to telnetd.exe


New features.
1. Telnet.exe now not limited by 80x25 window. It uses current console window
size.


        Availability and pricing.

   Demo version of cs32 is definitely free. You can use it in noncommercial
environment only. The price of full version is USD 50. Contact me for more
info.

Latest demo version is available for file requests on 2:5020/47@fidonet at
18:00-4:00 GMT, alias CS32DEMO.
FTP ftp://kgb.quarta.msk.ru/NTUtil/cs32demo.zip

Feel free to redistribute original cs32demo archive.


Sergey Okhapkin, 

FidoNet
	2:5020/47@fidonet,
E-mail
	sos@krystalbank.msk.ru, sos@prospect.com.ru
