home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / com / utils / pm2you / term2.doc < prev    next >
Encoding:
Text File  |  1993-05-04  |  14.3 KB  |  363 lines
  1. Terminal/2 2.3 beta release                           (c) 1993 Mikael Wahlgren
  2. ==============================================================================
  3.  
  4. Keyboard shortcuts in non OS2You-mode:
  5.  
  6. ALT-B   Break                        ALT-C   Clear Screen
  7. ALT-D   Dial                         ALT-G   Print screen
  8. ALT-H   HangUp                       ALT-J   Initialize modem
  9. ALT-S   Set parameters               ALT-X   Exit                         
  10. ALT-Z   Help
  11. PgUp    Send file                    PgDn    Receive file
  12.  
  13.  
  14. Introduction
  15. ============
  16. Terminal/2 is a terminal program for OS/2 Presentation Manager.  This program
  17. is a working demonstration program, which you may re-distribute without any
  18. restrictions, as long as you don't modify it.
  19.  
  20. If you plan to use this program on regular basis, you must register the
  21. program (see instructions in the included ORDER.DOC form).
  22.  
  23. The program is developed with Os2You (a remote access program for OS/2) in
  24. mind and is included without any additional charge, when registering Os2You.
  25. Some of the features:
  26.  
  27. *   Terminal/2 can work with asynchronous devices, but also with Named
  28.     Pipes, accross a network.
  29.  
  30. *   Terminal/2 supports baudrates between 300 and 115200 baud.
  31.  
  32. *   Terminal/2 supports screen sizes between 1 and 255 rows.
  33.  
  34. *   Terminal/2 emulates an ANSI/VT100/VT52 color terminal.
  35.  
  36. *   Terminal/2 has a simple scripting capability.
  37.  
  38. *   Terminal/2 is designed for Hayes compatible modems, but can work with any
  39.     modem, with some limitations.
  40.  
  41. *   Terminal/2 has built in Xmodem, Xmodem/1K, YModem-Batch and Ymodem-G Batch
  42.     file transfer protocols.  In addition to this, an external Zmodem and
  43.     Kermit protocol can be used with auto Zmodem up/download capability
  44.     (M2Zmodem, another program from the same source).
  45.  
  46. *   Terminal/2 can be used with USA, Swedish, Finnish and Norwegian character
  47.     sets.
  48.  
  49.  
  50.  
  51. All normal accelerator keys (shortcuts instead of selecting in the menues),
  52. are intentionally disabled, as they intervene with Os2You emulation.
  53.  
  54.  
  55.  
  56. Installation
  57. ============
  58. Just copy all files into a subdirectory.  Note that the file ZIP.DLL should
  59. be copied to a directory that is specified in your LIBPATH (or the current
  60. directory if you have a "." in your LIBPATH).
  61.  
  62.  
  63.  
  64. Phonebook
  65. =========
  66. The phonebook is a list of different connections types you define.  The
  67. following entries are available in the phonebook:
  68.  
  69.    Name                 Name of the entry
  70.  
  71.    Phone number         Phone number to dial.  This entry is optional, and if
  72.                         no phone number is specified, the program will just
  73.                         open the communication device, but not dial.
  74.  
  75.                         If a phone number is specified, the program will dial
  76.                         the phone number (using Hayes command set), and if
  77.                         the number is busy, redial the number until the
  78.                         connection is established (or cancelled).
  79.  
  80.    User id              This entry is only valid for Os2You users or if you
  81.                         use EMSI/IEMSI, and specifies the login name.  This
  82.                         entry is optional, and if you don't specify user id,
  83.                         you will be prompted for it when connection is made.
  84.  
  85.    Password             This entry is only valid for Os2You users or if you
  86.                         use EMSI/IEMSI, and specifies the login password.  This
  87.                         entry is optional, and if you don't specify password,
  88.                         you will be promted for it when connection is made.
  89.  
  90.    Device               This entry specifies which device (port) to use for
  91.                         communication.  By clicking on the down-array to the
  92.                         right, you will get a list of some devices.  You can
  93.                         also type in any other device name directly.  Regarding
  94.                         support for devices like COM3/COM4, that is not an
  95.                         issue of the application program in OS/2.  If you have
  96.                         a COM-port that is supported by an OS/2 device driver,
  97.                         you may use it with the terminal program (try do a
  98.                         MODE COMx and to see if it is supported).
  99.  
  100.    Scriptfile           This entry specifies a script file to be loaded, when
  101.                         a call is successfully completed.
  102.  
  103.    Baudrate             Selects a communication speed between 300 and 115200.
  104.                         Some high speeds may require special attention.  See
  105.                         the installation instructions.
  106.  
  107.    Databits/Parity/     Specifies how may Databits and stopbits to use, and
  108.    Stopbits             what parity.  A common configuration is 8 databits
  109.                         no parity and 1 stopbit.
  110.  
  111.    Handshaking          Specifies what handshaking signals to use.  Cts/Rts
  112.                         is recommended in most cases.
  113.  
  114.    Rows                 Specifies how many screen rows to use for the terminal
  115.                         session.  This may vary between 1 and 255.
  116.  
  117.    Emulation            This entry specifies what type of terminal emulation
  118.                         to use.  For connection with Os2You, you should select
  119.                         Os2You emulation, for anything else, you should select
  120.                         ANSI.
  121.  
  122.  
  123.  
  124. File Transfer
  125. =============
  126. Terminal/2 includes the Xmodem, Xmodem/1K, Ymodem-Batch and Ymodem-G Batch
  127. file transfer protocols.  Xmodem is the least efficient, Ymodem-G Batch the
  128. most efficient protocol, but requires error free connections.
  129.  
  130. To initiate a file transfer, you should select "Receive using..." or
  131. "Send using...".  The "Send to host" and "Receive from host" are used for
  132. use with Os2You only.
  133.  
  134. The file transfer menu has a settings option.  The following settings are
  135. available:
  136.  
  137.     Download path       Specifies in which directory downloaded (received)
  138.                         files should be placed.  This entry may be left
  139.                         empty, in which case the file will be placed in the
  140.                         default working directory.
  141.  
  142.     Existing files      Specifies what to do if a file to be received already
  143.                         exists in the download directory.  Files may either
  144.                         be Renamed (by altering the last character in the
  145.                         file name), Resumed (overwritten by the received file
  146.                         using Xmodem/Ymodem or appended using Zmodem) or
  147.                         Rejected (file transfer cancelled with Xmodem/Ymodem).
  148.  
  149.     Carrier detect      Specifies if file transfers should be aborted if
  150.                         carrier isn't present.
  151.  
  152.     Autodetect          Terminal/2 can autodetect X/Ymodem transfers initiated
  153.                         by some implementations.  Terminal/2 also autodetects
  154.                         Zmodem and Kermit transfers.  You can select to turn
  155.                         off this autodetection.
  156.  
  157. To get Kermit to work, you will have to get CKermit version 5A188 or later
  158. (this program is tested with 5a188 dated 25 January 1993).  Note that there
  159. seems to be a bug in the 32-bit version of CKermit, so you should use the
  160. CKOKER16.EXE file included in the CKermit package instead of CKOKER32.EXE
  161. until this is fixed.  Note that Terminal/2 will first try to load CKOKER32.EXE
  162. and thus CKOKER32.EXE must _NOT_ be available in the PATH, but ONLY
  163. CKOKER16.EXE.
  164.  
  165.  
  166.  
  167.  
  168. Special
  169. =======
  170. Print Screen, copies the current terminal screen to the printer device (or
  171. file, specified in the settings dialog).
  172.  
  173. The settings dialog has the following entries:
  174.  
  175.     Printer device      Specifies to which device printer output should
  176.                         be directed.  This may also be a file name, in
  177.                         which case the printer output will be put into the
  178.                         file.  The printer output device is used for the
  179.                         "Print Screen" choice and Os2You remote printing.
  180.  
  181.     Character set       This entry specifies which character set to use.
  182.                         Most countries should use the USA setting, but in
  183.                         some cases you may want to select another character
  184.                         set.  Currently there are support for Sweden, Finland,
  185.                         Norway and USA.  To use the Norwegian character set,
  186.                         you should first change code page to 850 (CHCP 850)
  187.                         if this is not the default code page.
  188.  
  189.     Alarm time          This setting specifies for how long the internal
  190.                         speaker should produce noise, when a connection is
  191.                         successful.  By setting this to 0, you will avoid
  192.                         the noise altogether.
  193.  
  194.     HW buffering        This box should almost always be marked (on).  If
  195.                         set to on, extended hardware buffering available
  196.                         on some computers, is used if available.  Deselecting
  197.                         this check box.  You may consider to deselect this
  198.                         check box, if you are using low speed modems (2400
  199.                         baud and below), and you find it irritating that
  200.                         characters are displayed unregulary.
  201.  
  202.     Use EMSI            This box selects EMSI/IEMSI.  Some BBS's (like RA)
  203.                         supports a logon procedure called IEMSI, which will
  204.                         automate the logon process.  You will automaticly
  205.                         be logged into the BBS with the user name and password
  206.                         you have selected in the phonebook.  By selecting
  207.                         the EMSI checkbox, you will get a dialog box, asking
  208.                         for some special IEMSI features.
  209.  
  210.     Macro keys          F1-F12 are programmable to any character sequence.
  211.                         See "Scripting" for more details of special
  212.                         characters in Macro strings.
  213.  
  214.  
  215. Other Settings
  216. ==============
  217.     Maximize PM2You     This selection is only valid for PM2You sessions.
  218.     hides menues        If marked Terminal/2 will maximize to a size to
  219.                         let the active graphics area cover the whole screen.
  220.  
  221.     Default editor      Terminal/2 loads an external editor in some cases
  222.                         (to display help or History log).  You should enter
  223.                         a name of an editor or file viewer.  It may be both
  224.                         a PM or OS/2 text application.
  225.  
  226.  
  227.  
  228.  
  229. Exit
  230. ====
  231. In this menu, you can select to hangup the line (using Hayes commands), or
  232. quit the program.
  233.  
  234.  
  235.  
  236.  
  237. Scripting
  238. =========
  239. Script files are simple text files you create with a text editor.  The
  240. following commands are available:
  241.  
  242. RESPOND "xxxxx" "yyyyy"
  243. DELAYED RESPOND "xxxxx" "yyyyy" "zzz"
  244. QUIT "xxxxx"
  245. INITIAL "xxxxx"
  246. EXIT
  247.  
  248.     RESPOND              Each time the string "xxxxx" is received "yyyyy"
  249.                          is sent as response
  250.  
  251.     RESPOND ONCE         As above but if the string "xxxxx" is received
  252.                          repeatedly the string "yyyyy" is sent only
  253.                          the first time.
  254.  
  255.     DELAYED RESPOND      Each time the string "xxxxx" is received "yyyyy"
  256.                          is sent after "zzz" seconds delay (zzz is a decimal
  257.                          value)
  258.  
  259.     DELAYED RESPOND ONCE As above, but if the string "xxxxx" is received
  260.                          repeatedly the string "yyyyy" is sent only the
  261.                          first time.
  262.  
  263.     QUIT                 When "xxxxx" is received the script file is termina-
  264.                          ted.
  265.  
  266.     INITIAL              When scripting begins the "xxxxx" string is sent.
  267.  
  268.  
  269. The following character sequences are treated specially:
  270.  
  271.     ^                   Prefixes control characters
  272.     ^^                  Sends a "^" sign
  273.     ^M                  Sends a CR
  274.     ^[                  Sends an Esc
  275.     ~                   One seconds delay
  276.  
  277.  
  278.  
  279. Release Log
  280. ===========
  281. 1.2       Now supports EMSI/IEMSI automatic logon facility
  282.  
  283.           Now supports Control character escaping working with Os2You 2.7.
  284.  
  285. 1.3       Now Zmodem is enabled, for unregistered users
  286.  
  287. 1.4       NetBIOS support added (for coming Os2You version 2.8).
  288.  
  289.           Using IEMSI logon for Os2You now (you will need Os2You 2.8 or
  290.           later for this to work).
  291.  
  292.           All limitations for unregistered users removed.
  293.  
  294. 2.0       PM2You graphics capabilities added
  295.  
  296.  
  297. 2.1       Kermit support added
  298.  
  299.           History buffer added
  300.  
  301.           Queue dialling added
  302.  
  303.           Software PAD added
  304.  
  305. 2.2       History buffer enhanced
  306.  
  307.           Paste to Terminal/2 (ASCII upload) fixed/added
  308.  
  309.           Selections in queue dialling are marked when
  310.           bringing up the phonebook after a successful
  311.           connection.
  312.  
  313.           Scripting enhanced with RESPOND ONCE and DELAYED RESPOND ONCE
  314.  
  315.           PM2You capabilities improved
  316.  
  317. 2.3       VT100 emulation improved
  318.  
  319.           Macro keys added
  320.  
  321.           SET TERM2_TRACE=ON
  322.  
  323.  
  324. License
  325. =======
  326. It is illegal (or at least unethical) to patch the program in any way.
  327. Any reverse engineering (disassembling or monitoring) is not an approved
  328. use of the application.
  329.  
  330. If you register the software with at least 300 SEK (about $40), you will
  331. get a license file and a copy of the most recent version of the program.
  332. By registering you will get the following benefits:
  333.  
  334. You will get a diskette with the most recent version of Terminal/2.
  335. You will get Zmodem file transfer, and all Os2You functions working.
  336. You will be able to run Terminal/2 with 38400, 57600 and 115200 bauds.
  337. You will be treated as registered user for all future release.
  338. You can sleep at the night without having your conscience haunt you.
  339.  
  340. If you use the program on a regular basis, or in commercial use, you must
  341. register with minimum the above mentioned sum for each machine running the
  342. Terminal/2 program.
  343.  
  344. If you want to register, send Swedish banknotes, bank check (payable in
  345. Swedish bank) or pay with VISA or MasterCard by completing the order form
  346. printable from the file ORDER.DOC.
  347.  
  348. My address is:
  349.  
  350. Mikael Wahlgren
  351. Kransen 4E
  352. S-416 72  GOTHENBURG
  353. Sweden
  354. Fax: +46 31 196417
  355. Fidonet:  Mikael Wahlgren 2:203/302.5
  356. Internet: d9mikael@dtek.chalmers.se
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.