home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / te2pro21.zip / TE2PRO.INF (.txt) < prev    next >
OS/2 Help File  |  1997-01-13  |  57KB  |  1,683 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Welcome ΓòÉΓòÉΓòÉ
  3.  
  4.                          Welcome to TE/2 Pro! Version 2.
  5.  
  6. This copy of TE/2 Pro! will cease to function after 50 executions unless you 
  7. provide a registration key.  Please contact Oberon Software or the vendor from 
  8. which you purchased this copy of TE/2 Pro! to receive a registration key.  If 
  9. this is a test drive (e.g., you downloaded it from a BBS or FTP site), then 
  10. please contact Oberon Software for purchasing information. 
  11.  
  12.                               Oberon Software, Inc.
  13.                               1405 East Main Street
  14.                            Mankato, MN 56001-5070 USA
  15.                                Phone: 507-388-7001
  16.                                 FAX: 507-388-7568
  17.                                 BBS: 507-388-1154
  18.                        Internet: oberon@prairie.lakes.com
  19.                         http://prairie.lakes.com/~oberon
  20.  
  21. To obtain help for any particular menu item, highlight that item from within 
  22. TE/2 Pro! and press the F1 key.  You may also open the help file contents 
  23. window from within this help window and search for the item of interest. 
  24.  
  25. A How Do I? section is also provided. 
  26.  
  27. If all else fails, contact Oberon Software be e-mail or phone.  We're always 
  28. happy to help! 
  29.  
  30. Other points of interest are: 
  31.  
  32. Getting Started 
  33. Product Overview 
  34. System Requirements 
  35. Oberon Software Info 
  36.  
  37.  
  38. ΓòÉΓòÉΓòÉ 2. TE/2 Pro! Overview ΓòÉΓòÉΓòÉ
  39.  
  40. TE/2 Pro! is Oberon Software's new, object-oriented, Workplace Shell aware, 
  41. telecommunications program for OS/2 Warp.  TE/2 Pro!, based on the same 
  42. telecommunications engine, file transfer protocols, and terminal emulations as 
  43. Oberon's very successful, original TE/2, adds the desktop object behaviors and 
  44. drag and drop interfaces which OS/2 Warp users are used to while maintaining 
  45. the robustness and reliability of the original product. 
  46.  
  47. In addition to long-standing TE/2 features such as robust,  high-speed 
  48. telecommunications support, seven terminal emulation modes, fast, reliable file 
  49. transfer protocols, and extensive REXX scripting capabilities, some of the new 
  50. features for TE/2 Pro! will include: 
  51.  
  52. o Object Oriented User Interface. 
  53.  
  54.    - Terminal sessions and dialing directories appear as objects. These objects 
  55.      use standard OS/2 notebook controls for their settings, may be opened in 
  56.      various views, dragged to the printer or shredder as OS/2 users would 
  57.      expect. 
  58.    - Dialing directory entries can be copied or moved easily between 
  59.      directories or dialed by simply dragging them to a terminal object. 
  60.  
  61. o Support for multiple, simultaneous sessions.  One invocation of TE/2 Pro! can 
  62.   support a virtually unlimited number of terminal sessions. 
  63. o Terminal objects which do not compete for the same device may be active 
  64.   simultaneously. 
  65. o Asynch, TCP/IP, and Named Pipe support built in. 
  66. o Any terminal object may be set to access a modem port, a TCP/IP socket (if 
  67.   the user has TCP/IP installed), or a Named Pipe server. 
  68. o Multiwindow chat and scroll back.  Rather than the split-screen and/or 
  69.   "modal" ways of handling these features, TE/2 Pro! uses standard OS/2 windows 
  70.   which can be sized, moved, retained, or closed as the user desires. 
  71. o Of course, copy and paste via the OS/2 clipboard is available throughout. 
  72.  
  73. System Requirements 
  74.  
  75.  
  76. ΓòÉΓòÉΓòÉ 2.1. System Requirements ΓòÉΓòÉΓòÉ
  77.  
  78. IBM compatible with 
  79.  
  80. Intel compatible 386 or better processor 
  81. 8 megabytes of RAM 
  82. 2 megabytes of unused hard disk space 
  83. VGA or better video card and monitor monitor 
  84. Serial port 
  85. (optional) TCP/IP software 
  86.  
  87.  
  88. ΓòÉΓòÉΓòÉ 3. Oberon Software ΓòÉΓòÉΓòÉ
  89.  
  90. Oberon Software has been developing OS/2 software and providing OS/2 related 
  91. services since 1988.  More than just a specialty, OS/2 related products and 
  92. services are Oberon Software's only business.  Other Oberon products include 
  93. FSHL - Oberon Software's Alternative Command Line Executive, DiskStat, LstPM, 
  94. and the Commpak/2 Programmer's Toolkit for creating telecommunications routines 
  95. under OS/2.  In addition, Oberon Software has developed unique, OS/2 based 
  96. solutions for a number of major corporations in the banking and communication 
  97. industries. 
  98.  
  99.                               Oberon Software, Inc.
  100.                               1405 East Main Street
  101.                            Mankato, MN 56001-5070 USA
  102.                                Phone: 507-388-7001
  103.                                 FAX: 507-388-7568
  104.                                 BBS: 507-388-1154
  105.                        Internet: oberon@prairie.lakes.com
  106.                         http://prairie.lakes.com/~oberon
  107.  
  108.  
  109. ΓòÉΓòÉΓòÉ 4. Getting Started ΓòÉΓòÉΓòÉ
  110.  
  111. Installing TE/2 Pro! 
  112. Starting TE/2 Pro! 
  113. Creating Terminals and Phone Books 
  114. Changing Settings 
  115.  
  116.  
  117. ΓòÉΓòÉΓòÉ 4.1. Installing TE/2 Pro! ΓòÉΓòÉΓòÉ
  118.  
  119. o If you downloaded a test-drive version of TE/2 Pro!, you will first need to 
  120.   unzip the archive file into a temporary directory or onto a diskette.  You 
  121.   should use an unzip utility such as Info-ZIP's unzip.exe. 
  122.  
  123. o Open an OS/2 folder for the diskette or directory which contains the TE/2 
  124.   Pro! installation files -- or -- open an OS/2 command line session and change 
  125.   disk/directory to that location. 
  126.  
  127. o Execute INSTALL.EXE by double-clicking on its icon or by typing "INSTALL" at 
  128.   the OS/2 command prompt. 
  129.  
  130. o Follow the instructions given to you by the install program. 
  131.  
  132.  
  133. ΓòÉΓòÉΓòÉ 4.2. Starting TE/2 Pro! ΓòÉΓòÉΓòÉ
  134.  
  135. When you installed TE/2 Pro! an OS/2 desktop folder was created which contains 
  136. a TE/2 Pro! program object.  Just double-click on this object to start TE/2 
  137. Pro! 
  138.  
  139.  
  140. ΓòÉΓòÉΓòÉ 4.3. Creating Terminals and Phone Books ΓòÉΓòÉΓòÉ
  141.  
  142. Terminals and phone books can be created by any of the following methods: 
  143.  
  144. o Click the right mouse button on any vacant area of the TE/2 screen 
  145.  
  146.    - Click on Create 
  147.    - Click on either Terminal or Phone Book 
  148.  
  149. o Hold the Control Key down while dragging a Terminal or Phone Book object 
  150.  
  151.    - This will copy the object and immediately open its Settings Notebook for 
  152.      you. 
  153.  
  154. o Click the right mouse button on a session icon. 
  155.  
  156.    - Select Create Another 
  157.  
  158. o Click the right mouse button on a Phone Book icon. 
  159.  
  160.    - Select Create Another 
  161.  
  162.  
  163. ΓòÉΓòÉΓòÉ 4.4. Changing Settings ΓòÉΓòÉΓòÉ
  164.  
  165. o The Program Page of the OS/2 Program Object Settings Notebook can be used: 
  166.  
  167.    - To pass options to TE/2 Pro! 
  168.    - To set the default working directory to the directory in which you 
  169.      installed TE/2 Pro! 
  170.  
  171. o The Settings Notebook for the main TE/2 Pro window can be used to change: 
  172.  
  173.    - Main window background 
  174.    - Various sounds associated with 
  175.  
  176.       o Program start 
  177.       o Program end 
  178.       o Program errors 
  179.       o Various notifications 
  180.       o Sounds associated with various file transfer actions 
  181.  
  182.    - Your Registration Name and ID 
  183.  
  184. o Terminal session settings can be changed by Clicking the right mouse button 
  185.   on any Session icon Selecting the Settings notebook 
  186.  
  187. o Phone Book settings can be changed by Clicking the right mouse button on any 
  188.   Phone Book icon Selecting the Settings notebook 
  189.  
  190.  
  191. ΓòÉΓòÉΓòÉ 5. How Do I? ΓòÉΓòÉΓòÉ
  192.  
  193. General How To... Comments 
  194. Use the Toolbox 
  195. Upload a file 
  196. Download a file 
  197. Capture data to a log file 
  198. Assign actions to function keys 
  199. Dial a number that is not in a Phone Book 
  200. Print a Phone Book 
  201. Use Copy and Paste 
  202. Use Chat Mode 
  203. Setup a Telnet Session 
  204.  
  205.  
  206. ΓòÉΓòÉΓòÉ 5.1. General How To... Comments ΓòÉΓòÉΓòÉ
  207.  
  208. TE/2 Pro! gives you a choice of ways to accomplish any task.  You can 
  209.  
  210.  1. Use menus to make a selection 
  211.  2. Use Alt-key combinations to perform functions 
  212.  3. Click on Toolbox icons to perform functions 
  213.  
  214. All three ways are equally valid.  Choose the interface that makes you feel 
  215. most comfortable. 
  216.  
  217.  
  218. ΓòÉΓòÉΓòÉ 5.2. Use the Toolbox ΓòÉΓòÉΓòÉ
  219.  
  220. The Toolbox allows you to click icons to accomplish things 
  221.  
  222. o Up arrow uploads a file 
  223. o Down arrow downloads a file 
  224. o The file icon with the superimposed arrow opens a log file 
  225. o Scroll icon scrolls back through session activity 
  226. o Telephone dial icon allows you to manually dial a number 
  227. o Telephone handset icon allows you to hangup 
  228. o Information about session settings is displayed.  These settings can be 
  229.   changed by clicking the left mouse button over the setting you wish to 
  230.   change. 
  231.  
  232.  
  233. ΓòÉΓòÉΓòÉ 5.3. Upload a file ΓòÉΓòÉΓòÉ
  234.  
  235. In order to upload a file, you must have a session running. There are several 
  236. ways to upload a file. 
  237.  
  238. o Drag one or more file objects from an OS/2 folder onto a running TE/2 Pro! 
  239.   terminal session window.  A dialog box will appear at the bottom of the 
  240.   screen. 
  241.  
  242.    The file(s) you dragged onto TE/2 Pro will be listed in this dialog. 
  243.    If you wish to add files to this dialog, you may 
  244.  
  245.       - Drag and drop more file objects onto the terminal window and/or ... 
  246.       - Use the Select button to use a standard OS/2 file dialog 
  247.  
  248.    Select a protocol. 
  249.    Click on Options to set any options for that protocol. 
  250.    Click on select to choose the file(s) you wish to upload. 
  251.    Click on Start Upload to begin the file transfer. 
  252.  
  253. o Click on the download icon in the toolbox.  (The logfile icon is the first 
  254.   icon on the left)  A dialog box will appear at the bottom of the screen. 
  255.  
  256.    Select a protocol. 
  257.    Click on Options to set any options for that protocol. 
  258.    Click on select to choose the file(s) you wish to upload. 
  259.    Click on Start Upload to begin the file transfer. 
  260.  
  261. o Press Alt+U.  Select a file transfer protocol.  A dialog box will appear at 
  262.   the bottom of the screen. 
  263.  
  264.    Select a protocol. 
  265.    Click on Options to set any options for that protocol. 
  266.    Click on select to choose the file(s) you wish to upload. 
  267.    Click on Start Upload to begin the file transfer. 
  268.  
  269. o Click the right mouse button anywhere on running terminal session.  A popup 
  270.   menu will appear. 
  271.  
  272.    Select File. 
  273.    When the second menu appears, select Upload. 
  274.    A dialog box will appear at the bottom of the screen. 
  275.    Select a protocol. 
  276.    Click on Options to set any options for that protocol. 
  277.    Click on select to choose the file(s) you wish to upload. 
  278.    Click on Start Upload to begin the file transfer. 
  279.  
  280.  
  281. ΓòÉΓòÉΓòÉ 5.4. Download a file ΓòÉΓòÉΓòÉ
  282.  
  283. In order to download a file, you must have a session running. There are several 
  284. ways to download a file. 
  285.  
  286. o Click on the download icon in the toolbox.  (The download icon is the second 
  287.   icon on the left) 
  288.  
  289.    Select a protocol. 
  290.  
  291.       - If you chose one of the XMODEM protocols, you will be asked to choose a 
  292.         name for the file you are about to download.  This name will become the 
  293.         name of the file when it is stored on your computer. 
  294.       - You will not be asked for a file name if you choose one of the other 
  295.         file transfer protocols. 
  296.  
  297.    TE/2 Pro! will begin the file transfer. 
  298.  
  299. o Press Alt+N. 
  300.  
  301.    Select a protocol. 
  302.  
  303.       - If you chose one of the XMODEM protocols, you will be asked to choose a 
  304.         name for the file you are about to download.  This name will become the 
  305.         name of the file when it is stored on your computer. 
  306.       - You will not be asked for a file name if you choose one of the other 
  307.         file transfer protocols. 
  308.  
  309.    TE/2 Pro! will begin the file transfer. 
  310.  
  311. o Click the right mouse button anywhere on running terminal session.  A popup 
  312.   menu will appear. 
  313.  
  314.    Select File. 
  315.    When the second menu appears, select Download 
  316.    Select a protocol. 
  317.  
  318.       - If you chose one of the XMODEM protocols, you will be asked to choose a 
  319.         name for the file you are about to download.  This name will become the 
  320.         name of the file when it is stored on your computer. 
  321.       - You will not be asked for a file name if you choose one of the other 
  322.         file transfer protocols. 
  323.  
  324.    TE/2 Pro! will begin the file transfer. 
  325.  
  326.  
  327. ΓòÉΓòÉΓòÉ 5.5. Capture data to a log file ΓòÉΓòÉΓòÉ
  328.  
  329. In order to capture data to a log file, you must have a session running. There 
  330. are several ways to capture data to a log file. 
  331.  
  332. o Click on the logfile icon in the toolbox.  (The logfile icon is the third 
  333.   icon from the left)  A file open dialog will appear. 
  334.  
  335.    Choose a file name.  Click on OK 
  336.  
  337. o Press Alt+L.  A file open dialog will appear. 
  338.  
  339.    Choose a file name.  Click on OK 
  340.  
  341. o Click the right mouse button on the screen of an open session.  A popup menu 
  342.   will appear. 
  343.  
  344.    Click on File. 
  345.    Click on Logfile. 
  346.    Click on Open.  A file open dialog will appear. 
  347.    Choose a file name.  Click on OK 
  348.  
  349.  
  350. ΓòÉΓòÉΓòÉ 5.6. Assign actions to function keys ΓòÉΓòÉΓòÉ
  351.  
  352. Function key assignments for F1 through F12 in any of their shift states can be 
  353. made on a per-terminal basis from the terminal object's settings notebook. 
  354.  
  355. In general, any text assigned to a function key will be transmitted when that 
  356. key is pressed from the terminal window.  You can embed control codes into the 
  357. text using standard "carat" notation.  I.e.: 
  358.  
  359. "^A" translates to Control-A 
  360. "^B" translates to Control-B 
  361. et cetera.... 
  362.  
  363. Several important control codes which you will probably need are: 
  364.  
  365. "^[" is an ESCape character 
  366. "^M" is a carriage return 
  367. "^J" is a line feed 
  368. "^I" is a TAB character 
  369. "^@" is a NUL (ASCII value 0) 
  370.  
  371. To invoke a script from a function key, you should assign the key as such: 
  372.  
  373.  
  374.     !run <scriptname> [arguments]
  375.  
  376. Replace "<scripname>" with the name of script you wish to run.  Script 
  377. arguments are optional. 
  378.  
  379.  
  380. ΓòÉΓòÉΓòÉ 5.7. Dial a number that is not in a Phone Book ΓòÉΓòÉΓòÉ
  381.  
  382. In order to manually dial a phone number, you must have a session running. 
  383. There are several ways to dial a number that is not in one of the Phone Books. 
  384.  
  385. o Click on the Telephone icon in the toolbox.  (The Telephone icon is the 
  386.   fourth icon from the left)  An entryfield will appear. 
  387.  
  388.    Enter the phone number. 
  389.    Click on OK. 
  390.  
  391. o Press Alt+M.  An entryfield will appear. 
  392.  
  393.    Enter the phone number. 
  394.    Click on OK. 
  395.  
  396. o Click the right mouse button on the screen of an open session.  A popup menu 
  397.   will appear. 
  398.  
  399.    Click on Dial.  An entryfield will appear. 
  400.    Enter the phone number. 
  401.    Click on OK. 
  402.  
  403.  
  404. ΓòÉΓòÉΓòÉ 5.8. Print a Phone Book ΓòÉΓòÉΓòÉ
  405.  
  406. To print an entire Phone Book 
  407.  
  408.    Use the right mouse button to drag the Phone Book icon to a printer object 
  409.    on the OS/2 desktop. 
  410.  
  411. To print a single Phone Book entry 
  412.  
  413.    Open the Phone Book 
  414.    Select the entry you want to print 
  415.    Use the right mouse button to drag the Phone Book entry to a printer object 
  416.    on the OS/2 desktop. 
  417.  
  418.  
  419. ΓòÉΓòÉΓòÉ 5.9. Use Copy and Paste ΓòÉΓòÉΓòÉ
  420.  
  421. These features allow you to use the OS/2 clipboard to transfer data between 
  422. TE/2 Pro! and another program. 
  423.  
  424. To copy all the data in a session window 
  425.  
  426.    Click the right mouse button anywhere in the client area of the session 
  427.    window 
  428.    When the popup menu appears, click on Copy all 
  429.  
  430. To copy selected data from a session window 
  431.  
  432.    Hold down the left mouse button 
  433.    Drag the mouse across the data you want to capture from the session window 
  434.  
  435.       Press Control+Insert or... 
  436.       Click on the right mouse button. When the popup menu appears, click on 
  437.       Copy. 
  438.  
  439. Data copied to the clipboard can then be pasted into other OS/2 applications 
  440.  
  441. To paste data into a session from another application 
  442.  
  443.    Press Shift+Insert or... 
  444.    Click the right mouse button anywhere in the client area of the session 
  445.    window.  When the popup menu appears, click on Paste. 
  446.  
  447.  
  448. ΓòÉΓòÉΓòÉ 5.10. Use Chat mode ΓòÉΓòÉΓòÉ
  449.  
  450. TE/2 Pro! supplies a built in, split window chat mode for use with the CB 
  451. Simulators provided by some on-line services, multiuser real-time conferences 
  452. provided by some services and bulletin boards, and chatting with bulletin board 
  453. sysops if they offer a chat mode on their BBS. 
  454.  
  455. To activate the "Remote Input Window": 
  456.  
  457. o Press Alt+G or ... 
  458. o Click the right mouse button on the screen of an open session.  A popup menu 
  459.   will appear. 
  460.  
  461.    Click on Options. 
  462.    Click on Remote Input Window. 
  463.  
  464. When the Remote Input Window is active, anything you type into it will be 
  465. transmitted as though you had typed it into the TE/2 Pro! terminal window (with 
  466. some differences, noted below).  The regular terminal window is still active 
  467. while the Remote Input Window is displayed and it may be used as normal. 
  468.  
  469. The Remote Input Window has its own popup menu that is activated by clicking 
  470. the right mouse button anywhere in its window.  The special features of the 
  471. Remote Input Window are: 
  472.  
  473. o Buffered Input: 
  474.  
  475.     If Buffered Input is active, no typed characters will be transmitted until 
  476.    you press ENTER. 
  477.     If Buffered Input is not active, typed characters are transmitted as you 
  478.    type them. 
  479.  
  480. o The options submenu allows you to: 
  481.  
  482.    Turn the scroll bars for this window on and off. 
  483.    Change the character font for this window. 
  484.    Change the size (rows and columns) for this window. 
  485.  
  486.  
  487. ΓòÉΓòÉΓòÉ 5.11. Setup a Telnet Session ΓòÉΓòÉΓòÉ
  488.  
  489. See the section Internet Addressing  To get up and running with a Telnet 
  490. session, however, all you need to do is: 
  491.  
  492.  1. Create a new Terminal Session or modify an existing one. 
  493.  2. Open the Terminal Session's Settings notebook 
  494.  3. On the first page of the notebook: 
  495.  
  496.    o Select the radio button labeled Socket (TCP/IP) 
  497.    o In the Device entry field, type telnet://<hostname> replacing <hostname> 
  498.      with the name or IP address of your telnet host. 
  499.  
  500.  4. That's it!  Close the Settings Notebook and try it out. 
  501.  
  502. Note:  If you would rather be asked for the telnet host name each time you open 
  503. the Terminal Object, enter telnet://? in the Device field. 
  504.  
  505. Note:  When you select the Socket (TCP/IP) radio button, numerous items will 
  506. become disabled on the Device and Modem pages of this notebook.  Don't worry if 
  507. there seems to be contradicting or unwanted data in some of these fields.  TE/2 
  508. Pro will not use any of the commport related settings when attempting a socket 
  509. connection nor will it attempt to send the Modem Init String when the terminal 
  510. opens. 
  511.  
  512.  
  513. ΓòÉΓòÉΓòÉ 6. Scripting ΓòÉΓòÉΓòÉ
  514.  
  515. TE/2 Pro! scripts are all written using the REXX scripting language which is 
  516. built into OS/2.  This document is not intended to be a tutorial on the REXX 
  517. language.  For information on the REXX language, you can begin by reading the 
  518. online REXX document which comes with OS/2. This document is usually located in 
  519. the OS/2 "Information" folder. There are also many good books available which 
  520. cover the REXX language in detail. 
  521.  
  522. Because of the extensible nature of REXX, you can use TE/2 Pro! REXX scripts in 
  523. conjuction with any of the REXX extension packages available: 
  524.  
  525. o OS/2 includes a REXXUTIL package which provides OS/2 system and file 
  526.   services. 
  527. o Visual REXX tools, such as Hockware's VisPro REXX and Watcom's VXREXX give 
  528.   you the ability to create dialog boxes and other GUI features with your REXX 
  529.   programs and scripts. 
  530. o Communications Manager/2 provides a REXX extension package if you need to use 
  531.   HLLAPI to communicate with your host sessions. 
  532. o DB2/2 provides a REXX package for accessing its databases. 
  533. o REXX socket services and FTP services are available from IBM and others for 
  534.   use in REXX programs and scripts. 
  535. o And so on... 
  536.  
  537. When TE/2 Pro! executes a REXX script, it acts as a subcommmand handler. That 
  538. is, any command which REXX doesn't recognize will be routed back into TE/2 Pro! 
  539. to be executed.  This documents will cover the subcommands which TE/2 Pro! 
  540. recognizes. 
  541.  
  542. How to execute TE/2 Pro! scripts 
  543. Subcommand reference 
  544.  
  545.  
  546. ΓòÉΓòÉΓòÉ 6.1. How to execute TE/2 Pro scripts ΓòÉΓòÉΓòÉ
  547.  
  548. In general, TE/2 Pro! scripts must reside in the current working directory. 
  549. That is, the directory in which the TE/2 Pro! executable is running. 
  550.  
  551. Alternately, you may define an environment variable TPSCRIPTPATH which should 
  552. contain a semi-colon delimited list of directories in which TE/2 Pro! should 
  553. look for its scripts.  If no path is provided when you execute the script, TE/2 
  554. Pro! will always look in the current directory first and then in the 
  555. directories listed in TPSCRIPTPATH. 
  556.  
  557. There are several ways to execute TE/2 Pro! scripts: 
  558.  
  559. o Automatically when you dial a Phone Book entry 
  560.  
  561.    Enter the script name in the "Script" field of the Phone Book entry. 
  562.    The script will be executed once a successful connection has been made to 
  563.    this site. 
  564.  
  565. o Automatically when you open or close a Terminal Session 
  566.  
  567.    Enter the script name(s) in the Terminal Settings Notebook on the 
  568.    Session->Scripts page. 
  569.    Scripts can be executed: 
  570.  
  571.       - When the terminal starts, before the device has been opened. 
  572.       - When the terminal starts, after the device has been opened. 
  573.       - When the terminal closes, before the device is closed. 
  574.       - When the terminal closes, after the device is closed. 
  575.  
  576. o Manually from a Terminal Session's popup menu 
  577.  
  578.    - From the popup menu select File->Script->Run... 
  579.    - To re-run the last script, select File->Script->Repeat 
  580.    - To halt a running script, select File->Script->Halt 
  581.    - If you expect to run a particular script quite often during the current 
  582.      session, you may load it into memory by selecting File->Script->Load. 
  583.      This will save on disk access time on subsequent executions of the script. 
  584.  
  585.  
  586. ΓòÉΓòÉΓòÉ 6.2. Subcommand reference ΓòÉΓòÉΓòÉ
  587.  
  588. The following subcommands are recognized by TE/2 Pro! 
  589.  
  590. CLOSE 
  591. CLS 
  592. COMMHOLD 
  593. DOWNLOAD 
  594. EXECWAIT 
  595. HANGUP 
  596. LOGFILE 
  597. MESSAGEBOX 
  598. MESSAGEBOXV 
  599. QUERY BAUD 
  600. QUERY CARRIER 
  601. QUERY DATABITS 
  602. QUERY DEVICE 
  603. QUERY DEVICEHANDLE 
  604. QUERY DEVICESTATE 
  605. QUERY PARITY 
  606. QUERY STOPBITS 
  607. RCVCAPTURE 
  608. RECEIVE 
  609. RUN 
  610. SAY 
  611. SET BAUD 
  612. SET DATABITS 
  613. SET PARITY 
  614. SET STOPBITS 
  615. SLEEP 
  616. STARTSESSION 
  617. TRANSMIT 
  618. UPLOAD 
  619. WAIT 
  620. WAITV 
  621. WAITXFER 
  622.  
  623.  
  624. ΓòÉΓòÉΓòÉ 6.2.1. CLOSE ΓòÉΓòÉΓòÉ
  625.  
  626. Parameters:         None 
  627.  
  628. Note:               This posts a "CLOSE" message to the terminal window.  It 
  629.                     will close within microseconds so you are STRONGLY advised 
  630.                     to make this the final statement in your script just before 
  631.                     the REXX "exit" statement.  If the terminal has either an 
  632.                     UnInit or CleanUp script (or both) defined, they will be 
  633.                     executed as normal. 
  634.  
  635. Returns:            Always 0 
  636.  
  637.  
  638. ΓòÉΓòÉΓòÉ 6.2.2. CLS ΓòÉΓòÉΓòÉ
  639.  
  640. Parameters:         None 
  641.  
  642. Note:               Clears the terminal screen to blanks. 
  643.  
  644. Returns:            Always 0 
  645.  
  646.  
  647. ΓòÉΓòÉΓòÉ 6.2.3. COMMHOLD ΓòÉΓòÉΓòÉ
  648.  
  649. Parameters:         (Required) "TRUE' or "FALSE" 
  650.  
  651. Note:               COMMHOLD TRUE pauses all modem input until COMMHOLD FALSE 
  652.                     is issued.  You can use this before executing a child 
  653.                     program which needs to access the open serial port.  Your 
  654.                     script must turn processing back on with COMMHOLD FALSE. 
  655.  
  656. Returns:            Always 0 
  657.  
  658.  
  659. ΓòÉΓòÉΓòÉ 6.2.4. DOWNLOAD ΓòÉΓòÉΓòÉ
  660.  
  661. Parameters: 
  662.  
  663.    protocol  (Required) Must be one of: 
  664.  
  665.       o xmodem 
  666.       o xmodem1k 
  667.       o ymodem 
  668.       o ymodemg 
  669.       o zmodem 
  670.    filename  Required for xmodem and xmodem1k.  Ignored otherwise. 
  671.  
  672. Note:               File transfer proceeds asynchronously.  See WAITXFER. 
  673.  
  674. Returns: 
  675.  
  676.    0         transfer started 
  677.    1         transfer did not start 
  678.    256       terminal is busy 
  679.  
  680. Examples: 
  681.  
  682. 'DOWNLOAD XMODEM1K file.dat'
  683. 'DOWNLOAD ZMODEM'
  684.  
  685.  
  686. ΓòÉΓòÉΓòÉ 6.2.5. EXECWAIT ΓòÉΓòÉΓòÉ
  687.  
  688. Parameters: 
  689.  
  690.    program   (Required) File path/name to executable program 
  691.    arguments  (Optional) Command line parameters for executed program 
  692.  
  693. Note:               Runs the specified program with all defaults set (see 
  694.                     STARTSESSION) and waits for it to complete before 
  695.                     returning. 
  696.  
  697. Returns:            Return value from executed program 
  698.  
  699. Example: 
  700.  
  701. 'EXECWAIT c:\os2\chkdsk.com a:'
  702.  
  703.  
  704. ΓòÉΓòÉΓòÉ 6.2.6. HANGUP ΓòÉΓòÉΓòÉ
  705.  
  706. Parameters:         None 
  707.  
  708. Note:               Sends the defined hangup sequence to the device. 
  709.  
  710. Returns:            FALSE if CD is high after hangup, TRUE otherwise 
  711.  
  712.  
  713. ΓòÉΓòÉΓòÉ 6.2.7. LOGFILE ΓòÉΓòÉΓòÉ
  714.  
  715. Parameters: 
  716.  
  717.    option    Must be one of the following: 
  718.  
  719.       o query 
  720.       o open 
  721.       o append 
  722.       o close 
  723.       o activate 
  724.       o pause 
  725.       o toggle 
  726.    filename  Required for options "open" and "append".  Ignored otherwise. 
  727.  
  728. Returns:            The state and filename of the current logfile.  Note: If 
  729.                     the state is "CLOSED", there is no filename.  Possible 
  730.                     states are: 
  731.  
  732.    o ACTIVE 
  733.    o PAUSED 
  734.    o CLOSED 
  735.  
  736.  
  737. ΓòÉΓòÉΓòÉ 6.2.8. MESSAGEBOX ΓòÉΓòÉΓòÉ
  738.  
  739. Parameters: 
  740.  
  741.    text      (Required) The text to display in the message box area. 
  742.    title     (Optional) Title bar text for message box. 
  743.    style     (Optional) Style for the message box.  See notes. 
  744.  
  745. Note: 
  746.  
  747.    If "title" is not specified, the name of the running script is placed in the 
  748.    title bar. 
  749.    If "style" is not specified, the message box will be movable, have the OS/2 
  750.    "Info" icon, and an Enter button. 
  751.    If "style" is specified, it must be a numeric value which represents the 
  752.    style.  A list of useful style values is given below. 
  753.    If your "style" does not otherwise contain a button, an Enter button will be 
  754.    added. 
  755.  
  756. Returns:            The return value from the message box.  Possible values 
  757.                     are: 
  758.  
  759.    1         OK button pressed 
  760.    2         CANCEL button pressed 
  761.    3         ABORT button pressed 
  762.    4         RETRY button pressed 
  763.    5         IGNORE button pressed 
  764.    6         YES button pressed 
  765.    7         NO button pressed 
  766.    8         HELP button pressed 
  767.    9         ENTER button pressed 
  768.    Else      An error occurred 
  769.  
  770. Styles: These values may be combined by binary ORing them together: 
  771.  
  772. Buttons 
  773.  
  774.    0         OK 
  775.    1         OK, CANCEL 
  776.    2         RETRY, CANCEL 
  777.    3         ABORT, RETRY, IGNORE 
  778.    4         YES, NO 
  779.    5         YES, NO, CANCEL 
  780.    6         CANCEL 
  781.    7         ENTER 
  782.    8         ENTER, CANCEL 
  783.  
  784. Icons 
  785.  
  786.    0         No icon 
  787.    16        Question 
  788.    32        Warning 
  789.    48        Info 
  790.    64        Critical 
  791.  
  792. Other 
  793.  
  794.    256       Button 2 is default 
  795.    512       Button 3 is default 
  796.    4096      System modal 
  797.    16384     Moveable 
  798. Example: 
  799.  
  800.   /* 0x4046 is moveable+critical+cancel button */
  801. 'MESSAGEBOX "A critical error occurred!" "Error!"' X2D('4046')
  802.  
  803.  
  804. ΓòÉΓòÉΓòÉ 6.2.9. MESSAGEBOXV ΓòÉΓòÉΓòÉ
  805.  
  806. Parameters:         (Required) REXX stem variable name (see note) 
  807.  
  808. Note:               This is another, perhaps more concise way to call 
  809.                     MESSAGEBOX. All notes regarding return codes and style 
  810.                     given there apply here as well. 
  811.  
  812.                     The stem variable can contain the following fields: 
  813.  
  814.    text      (Required) The text to display in the message box area. 
  815.    title     (Optional) Title bar text for message box. 
  816.    style     (Optional) Style for the message box. 
  817.  
  818. Returns:            Same as MESSAGEBOX 
  819.  
  820. Example: 
  821.  
  822. msgbox.text = 'A Critical Error Occurred!'
  823. msgbox.title = 'Error!'
  824. msgbox.style = x2D('4046') /* moveable, critical, cancel button */
  825. 'MESSAGEBOXV msgbox'
  826.  
  827.  
  828. ΓòÉΓòÉΓòÉ 6.2.10. QUERY BAUD ΓòÉΓòÉΓòÉ
  829.  
  830. Parameters:         (Optional) REXX variable name 
  831.  
  832. Note:               If supplied, the REXX variable will be filled in with the 
  833.                     same value as the return code.  Since REXX treats return 
  834.                     values as signed integers, you will get negative results in 
  835.                     RC for 38,400 baud and greater.  Use this option for more 
  836.                     consistant results. 
  837.  
  838. Returns:            Current baud rate 
  839.  
  840.  
  841. ΓòÉΓòÉΓòÉ 6.2.11. QUERY CARRIER ΓòÉΓòÉΓòÉ
  842.  
  843. Parameters:         (Optional) REXX variable name 
  844.  
  845. Note:               If supplied, the REXX variable will be filled in with the 
  846.                     same value as the return code. 
  847.  
  848. Returns: 
  849.  
  850.    0         Terminal is NOT online 
  851.    1         Terminal is online 
  852.  
  853.  
  854. ΓòÉΓòÉΓòÉ 6.2.12. QUERY DATABITS ΓòÉΓòÉΓòÉ
  855.  
  856. Parameters:         (Optional) REXX variable name 
  857.  
  858. Note:               If supplied, the REXX variable will be filled in with the 
  859.                     same value as the return code. 
  860.  
  861. Returns:            Current databit setting 
  862.  
  863.  
  864. ΓòÉΓòÉΓòÉ 6.2.13. QUERY DEVICE ΓòÉΓòÉΓòÉ
  865.  
  866. Parameters:         (Optional) REXX variable name 
  867.  
  868. Note:               If supplied, the REXX variable will be filled in with the 
  869.                     same value as the return code. 
  870.  
  871. Returns:            Current device name 
  872.  
  873.  
  874. ΓòÉΓòÉΓòÉ 6.2.14. QUERY DEVICEHANDLE ΓòÉΓòÉΓòÉ
  875.  
  876. Parameters:         (Optional) REXX variable name 
  877.  
  878. Note:               If supplied, the REXX variable will be filled in with the 
  879.                     same value as the return code. 
  880.  
  881. Returns:            Current device handle 
  882.  
  883.  
  884. ΓòÉΓòÉΓòÉ 6.2.15. QUERY DEVICESTATE ΓòÉΓòÉΓòÉ
  885.  
  886. Parameters:         (Required) REXX variable name 
  887.  
  888. Note:               Uses the REXX variable as a stem variable and fills in the 
  889.                     following fields: 
  890.  
  891.    Device    Current device name 
  892.    Baud      Current baud rate 
  893.    Parity    Current parity (see QUERY PARITY) 
  894.    DataBits  Current databit setting 
  895.    StopBits  Current stopbit setting (see QUERY STOPBITS) 
  896.    Carrier   1 if online, 0 if not 
  897.    Handle    Current device handle 
  898.  
  899. Returns:            Always 0 
  900.  
  901. Example: 
  902.  
  903. devstate. = '' /* clear out the variable */
  904. 'QUERY DEVICESTATE devstate'
  905. say devstate.device 'is set to' devstate.baud'bps'
  906.  
  907.  
  908. ΓòÉΓòÉΓòÉ 6.2.16. QUERY STOPBITS ΓòÉΓòÉΓòÉ
  909.  
  910. Parameters:         (Optional) REXX variable name 
  911.  
  912. Note:               If supplied, the REXX variable will be filled in with the 
  913.                     same value as the return code. 
  914.  
  915. Returns:            Current stopbit setting: 1, 1.5, or 2 
  916.  
  917.  
  918. ΓòÉΓòÉΓòÉ 6.2.17. QUERY PARITY ΓòÉΓòÉΓòÉ
  919.  
  920. Parameters:         (Optional) REXX variable name 
  921.  
  922. Note:               If supplied, the REXX variable will be filled in with the 
  923.                     same value as the return code. 
  924.  
  925. Returns:            Current parity setting:  None, Even, Odd, Mark, or Space. 
  926.  
  927.  
  928. ΓòÉΓòÉΓòÉ 6.2.18. RCVCAPTURE ΓòÉΓòÉΓòÉ
  929.  
  930. Parameters:         (Required) "TRUE' or "FALSE" 
  931.  
  932. Note:               RCVCAPTURE TRUE ensures that all modem input will be held 
  933.                     until the script issues a RECEIVE statement. Receive 
  934.                     Capture mode MUST be turned off with RCVCAPTURE FALSE 
  935.                     explicitly! 
  936.  
  937. Returns:            Always 0 
  938.  
  939.  
  940. ΓòÉΓòÉΓòÉ 6.2.19. RECEIVE ΓòÉΓòÉΓòÉ
  941.  
  942. Parameters: 
  943.  
  944.    length    (Required) "nnn" or "CRnnn" where "nnn" is a number between 1 and 
  945.              255.  If "CR" is specified, the receive will terminate early if it 
  946.              encounters a carriage return character from the remote. 
  947.    timeout   (Required) Timeout value in seconds.  -1 specifies an infinite 
  948.              timeout. 
  949.    echo      (Optional) "ECHO" or "NOECHO".  If it is neither, the first 
  950.              character of the string specifes the character to echo.  If the 
  951.              parameter is omitted, defaults to NOECHO. 
  952.    prefix    (Optional) string (one word) which will be prefixed to the result 
  953.              if the result string is longer than zero characters.  Use this to 
  954.              overcome REXX's habit of modifying return strings which start with 
  955.              numeric values. Note that you must specify ECHO or NOECHO to use 
  956.              this parameter. 
  957.  
  958. Note:               Filtering of backspaces from the remote occurs if 'length' 
  959.                     is greater than 1. 
  960.  
  961. Returns:            Length or received string. 
  962.  
  963.  
  964. ΓòÉΓòÉΓòÉ 6.2.20. RUN ΓòÉΓòÉΓòÉ
  965.  
  966. Parameters: 
  967.  
  968.    script    (Required) script file name 
  969.    args      (Optional) arguments for script 
  970.  
  971. Note:               Runs the indicated script synchrounously. 
  972.  
  973. Returns:            return code from executed script. 
  974.  
  975.  
  976. ΓòÉΓòÉΓòÉ 6.2.21. SAY ΓòÉΓòÉΓòÉ
  977.  
  978. Parameters:         any string 
  979.  
  980. Note:               Exactly equivalent to the REXX SAY statement. 
  981.  
  982. Returns:            Always 0 
  983.  
  984.  
  985. ΓòÉΓòÉΓòÉ 6.2.22. SET BAUD ΓòÉΓòÉΓòÉ
  986.  
  987. Parameters:         (Required) value 
  988.  
  989. Note:               value must be one of: 110, 150, 300, 600, 1200, 2400, 4800, 
  990.                     9600, 19200, 38400, 57600, 115200, or 230400. 
  991.  
  992. Returns:            "OK" or "ERROR" 
  993.  
  994.  
  995. ΓòÉΓòÉΓòÉ 6.2.23. SET DATABITS ΓòÉΓòÉΓòÉ
  996.  
  997. Parameters:         (Required) value 
  998.  
  999. Note:               value must be one of: 5, 6, 7, or 8. 
  1000.  
  1001. Returns:            "OK" or "ERROR" 
  1002.  
  1003.  
  1004. ΓòÉΓòÉΓòÉ 6.2.24. SET PARITY ΓòÉΓòÉΓòÉ
  1005.  
  1006. Parameters:         (Required) value 
  1007.  
  1008. Note:               value must be one of: "none", "even", "odd", "mark", or 
  1009.                     "space" 
  1010.  
  1011. Returns:            "OK" or "ERROR" 
  1012.  
  1013.  
  1014. ΓòÉΓòÉΓòÉ 6.2.25. SET STOPBITS ΓòÉΓòÉΓòÉ
  1015.  
  1016. Parameters:         (Required) value 
  1017.  
  1018. Note:               value must be one of: 1, 1.5, or 2 
  1019.  
  1020. Returns:            "OK" or "ERROR" 
  1021.  
  1022.  
  1023. ΓòÉΓòÉΓòÉ 6.2.26. SLEEP ΓòÉΓòÉΓòÉ
  1024.  
  1025. Parameters:         (Required) value 
  1026.  
  1027. Note:               value is sleep time in seconds 
  1028.  
  1029. Returns:            Always 0 
  1030.  
  1031.  
  1032. ΓòÉΓòÉΓòÉ 6.2.27. STARTSESSION ΓòÉΓòÉΓòÉ
  1033.  
  1034. Parameters: 
  1035.  
  1036.    REXX var  (Required) see note 
  1037.    "WAIT"    (Optional) If specified, execution of script pauses until child 
  1038.              session ends. 
  1039.  
  1040. Note:               The REXX variable may have any and all of the following 
  1041.                     fields set: 
  1042.  
  1043.    Related        0 or 1 (default 1) indicates an independant or a child 
  1044.                   session, respectively 
  1045.    FgBg           0 or 1 (default 0) indicates the session is to be run in the 
  1046.                   Foreground or Background respectively 
  1047.    PgmTitle       Window title for the session, default is the empty string 
  1048.                   which results in the default title bar text (usually the 
  1049.                   executable file name). 
  1050.    PgmName        The program to run, must include the file extension although 
  1051.                   the file extension must be specified.  If left blank, CMD.EXE 
  1052.                   will run. 
  1053.    PgmInputs      Commandline arguments for the program. 
  1054.    Environment    Do not use this unless you are familiar with environment 
  1055.                   blocks.  This field is ignored for DOS (VDM) sessions. 
  1056.    InheritOpt     0 or 1 (default 1) indicates that the session is to inherit 
  1057.                   the OS/2 shell's environment or TE/2 Pro's respectively. 
  1058.    SessionType    Default is 0 (default session type based on the program file 
  1059.                   itself).  Otherwise, the value is chosen from this list: 
  1060.  
  1061.       1    Fullscreen OS/2 session 
  1062.       2    Windowed OS/2 session 
  1063.       3    Presentation manager session 
  1064.       4    Fullscreen DOS (VDM) session 
  1065.       7    Windowed DOS (VDM) session 
  1066.    IconFile       If left blank (the default), OS/2 provides a default icon for 
  1067.                   the session. 
  1068.    PgmControl     Choose from the table below, the default is 0.  This field is 
  1069.                   ignored for fullscreen sessions. 
  1070.  
  1071.       0    visible 
  1072.       1    invisible 
  1073.       2    maximized 
  1074.       4    minimized 
  1075.       +8   Do not close on exit 
  1076.  
  1077. Returns:            Return code from program or OS/2 error code. 
  1078.  
  1079. Example: 
  1080.  
  1081. pgm. = ''
  1082. pgm.PgmName = 'c:\os2\apps\pmseek'
  1083. pgm.InheritOpt = 0
  1084. pgm.SessionType = 3
  1085. 'STARTSESSION pgm WAIT'
  1086.  
  1087.  
  1088. ΓòÉΓòÉΓòÉ 6.2.28. TRANSMIT ΓòÉΓòÉΓòÉ
  1089.  
  1090. Parameters:         (Required) quoted string 
  1091.  
  1092. Note:               Use double quotes to quote the string.  If the string does 
  1093.                     not contain any space characters, it does not need to be 
  1094.                     quoted. 
  1095.  
  1096. Returns:            Number of bytes transmitted. 
  1097.  
  1098. Examples: 
  1099.  
  1100. 'TRANSMIT "Hello World"'
  1101. Reset = 'ATZ'||D2C(13)
  1102. 'TRANSMIT' Reset
  1103. Hello = 'Hello World'
  1104. 'TRANSMIT "'Hello'"'
  1105.  
  1106.  
  1107. ΓòÉΓòÉΓòÉ 6.2.29. UPLOAD ΓòÉΓòÉΓòÉ
  1108.  
  1109. Parameters: 
  1110.  
  1111.    protocol  (Required) Must be one of: 
  1112.  
  1113.       o xmodem 
  1114.       o xmodem1k 
  1115.       o ymodem 
  1116.       o ymodemg 
  1117.       o zmodem 
  1118.       o ascii 
  1119.    filename(s)  (Required) see note 
  1120.  
  1121. Note:               If "protocol" is "xmodem" or "xmodem1k", then "filename" 
  1122.                     must be a single, non-ambiguous filename.  If "protocol" is 
  1123.                     anything else, then "filename" may contain a 
  1124.                     comma-delimited list of filenames, any of which may or may 
  1125.                     not be ambiguous. 
  1126.  
  1127.                     File transfer proceeds asynchronously.  See WAITXFER. 
  1128.  
  1129. Returns: 
  1130.  
  1131.    0         transfer started 
  1132.    1         transfer did not start 
  1133.    256       terminal is busy 
  1134.  
  1135.  
  1136. ΓòÉΓòÉΓòÉ 6.2.30. WAIT ΓòÉΓòÉΓòÉ
  1137.  
  1138. Parameters: 
  1139.  
  1140.    value     (Required) seconds to wait 
  1141.    string(s)  At least one string is required, may have up to 10 total 
  1142.  
  1143. Note:               arguments after the 10th string are ignored and do not 
  1144.                     cause an error 
  1145.  
  1146. Returns:            index of matched string or 0 if timeout, 10000 if keyboard 
  1147.                     abort 
  1148.  
  1149. Examples: 
  1150.  
  1151. 'WAIT 60 "OK"'
  1152. 'WAIT 10 "ERROR" "OK"'
  1153.  
  1154.  
  1155. ΓòÉΓòÉΓòÉ 6.2.31. WAITV ΓòÉΓòÉΓòÉ
  1156.  
  1157. Parameters: 
  1158.  
  1159.    value     (Required) seconds to wait 
  1160.    REXX var  (Required) see note 
  1161.  
  1162. Note:               variable.0 must contain count, strings must be in 
  1163.                     variable.1, variable.2, etc.  If more than 10 are 
  1164.                     specified, only the first 10 are used and no error is 
  1165.                     generated 
  1166.  
  1167. Returns:            index of matched string or 0 if timeout, 10000 if keyboard 
  1168.                     abort 
  1169.  
  1170. Example: 
  1171.  
  1172. srch.0 = 2
  1173. srch.1 = 'OK'
  1174. srch.2 = 'ERROR'
  1175. 'WAITV 10 srch'
  1176.  
  1177.  
  1178. ΓòÉΓòÉΓòÉ 6.2.32. WAITXFER ΓòÉΓòÉΓòÉ
  1179.  
  1180. Parameters:         None 
  1181.  
  1182. Note:               Pauses script execution until the current file transfer 
  1183.                     ends. 
  1184.  
  1185. Returns: 
  1186.  
  1187.    0         transfer succeeded 
  1188.    1         transfer failed 
  1189.    256       no transfer in progress 
  1190.  
  1191.  
  1192. ΓòÉΓòÉΓòÉ 7. Internet Addressing ΓòÉΓòÉΓòÉ
  1193.  
  1194. There are several options available to you for addressing hosts on the 
  1195. Internet.  Full internet address is by far the most flexable but it also the 
  1196. most confusing so discussion of that will be left until the bottom of this 
  1197. page. 
  1198.  
  1199. Note:  In every case, you must ensure that the radio button labeled Socket 
  1200. (TCP/IP) on the first page of the Terminal Object's Settings Notebook is 
  1201. checked ON in order for things to work correctly. 
  1202.  
  1203. Note:  Everywhere below where the term hostname is used, you may substitute 
  1204. either an Internet host name (i.e., bbs.os2bbs.com) or a dotted-quad IP 
  1205. address. 
  1206.  
  1207. Note:  If you place a question mark anywhere in the entry for the Device name 
  1208. (in this case, the Internet Address), TE/2 Pro will ask you to type in the 
  1209. completing information before opening the connection.  An example for using 
  1210. this feature is given below. 
  1211.  
  1212. Simple Internet Addressing 
  1213.  
  1214. In almost every case, you will want to make this a Telnet connection. Certain 
  1215. defaults have been added to make this easier for you.  If you have the Socket 
  1216. (TCP/IP) button enabled, you may enter: 
  1217.  
  1218. telnet://hostname
  1219.  
  1220. in the Device entry field.  When the Terminal Object is opened, TE/2 Pro will 
  1221. check to see if you checked the Telnet Handshaking checkbox on the Terminal 
  1222. pages and select it if it is not already selected. 
  1223.  
  1224. Alternately, you may select the Socket (TCP/IP) button on the first page and 
  1225. the Telnet Handshaking checkbox on the ANSI/VT subpage of the Terminal page. 
  1226. If you do this, you may enter the Device as simply: 
  1227.  
  1228. hostname
  1229.  
  1230. Note:  If you would like TE/2 Pro to ask you for the host name each time you 
  1231. open the terminal object, make sure that both the radio button and checkbox 
  1232. mentioned above are checked and enter only a single question mark in the Device 
  1233. field. 
  1234.  
  1235. Full Internet Addressing 
  1236.  
  1237. To designate an arbitrary socket, the first seven characters of the Device 
  1238. setting must be "AF_INET" (upper or lower case).  The very next character after 
  1239. this flag is important in that it defines a delimiter which will be used in the 
  1240. remainder of the Device designation.  It can be any character which does not 
  1241. otherwise appear in your host or socket name.  A good choice would be the slash 
  1242. ("/") character. 
  1243.  
  1244. Next is your host name or address.  This can be a standard internet address 
  1245. (123.123.123.123) or a name as defined to your protocol installation (i.e., in 
  1246. your HOSTS file or available from a Domain Nameserver).  This is followed by 
  1247. the delimiter again. 
  1248.  
  1249. Next is the socket designation which can be either a simple numeric value 
  1250. (i.e., 23) or a "well known port" specification as defined in your SERVICES 
  1251. file (i.e., telnet).  In the latter case, the port name must be followed by 
  1252. another delimiter and the letters "tcp". 
  1253.  
  1254. Several examples will hopefully make this seem less intimidating: 
  1255.  
  1256.      1. AF_INET/server/2000
  1257.  
  1258.      2. AF_INET!30.96.92.1!login!tcp
  1259.  
  1260.      3. AF_INET,bbs.os2bbs.com,telnet,tcp
  1261.  
  1262. Notice that each uses a different delimiter character but each uses that 
  1263. delimiter consistantly throughout.  #1 uses a slash, #2 uses an exclamation 
  1264. point, and #3 uses a comma.  #1 and #3 connect to named servers whereas #2 
  1265. specifies an internet address for the host.  #1 connects to a socket with a 
  1266. hardcoded port number and #2 and #3 use "well know ports". 
  1267.  
  1268.  
  1269. ΓòÉΓòÉΓòÉ 8. Help for Open ΓòÉΓòÉΓòÉ
  1270.  
  1271. Help for Open Menu 
  1272.  
  1273.  
  1274. ΓòÉΓòÉΓòÉ 8.1. Help for Open Settings ΓòÉΓòÉΓòÉ
  1275.  
  1276. Choose this if you wish to open the settings notebook for the TE/2 Pro! main 
  1277. container. 
  1278.  
  1279.  
  1280. ΓòÉΓòÉΓòÉ 8.2. Help for Open Terminal ΓòÉΓòÉΓòÉ
  1281.  
  1282. Help for Open Settings Terminal 
  1283.  
  1284.  
  1285. ΓòÉΓòÉΓòÉ 8.3. Help for Open Phonebook ΓòÉΓòÉΓòÉ
  1286.  
  1287. Help for Open Settings Phonebook 
  1288.  
  1289.  
  1290. ΓòÉΓòÉΓòÉ 8.4. Help for Open Dialer ΓòÉΓòÉΓòÉ
  1291.  
  1292. Help for Open Dialer 
  1293.  
  1294.  
  1295. ΓòÉΓòÉΓòÉ 9. Help for View ΓòÉΓòÉΓòÉ
  1296.  
  1297. Choose this if you wish to select between an Icon, Details, Name, or Text view 
  1298. of the dialing directory entries. 
  1299.  
  1300.  
  1301. ΓòÉΓòÉΓòÉ 9.1. Help for View Icon ΓòÉΓòÉΓòÉ
  1302.  
  1303. Choose this if you wish to select an Icon view of the dialing directory 
  1304. entries. 
  1305.  
  1306.  
  1307. ΓòÉΓòÉΓòÉ 9.2. Help for View Details ΓòÉΓòÉΓòÉ
  1308.  
  1309. Choose this if you wish to select a Details view of the dialing directory 
  1310. entries. 
  1311.  
  1312.  
  1313. ΓòÉΓòÉΓòÉ 9.3. Help for View Name ΓòÉΓòÉΓòÉ
  1314.  
  1315. Choose this if you wish to select a Name view of the dialing directory entries. 
  1316.  
  1317.  
  1318. ΓòÉΓòÉΓòÉ 9.4. Help for View Text ΓòÉΓòÉΓòÉ
  1319.  
  1320. Choose this if you wish to select a Text view of the dialing directory entries. 
  1321.  
  1322.  
  1323. ΓòÉΓòÉΓòÉ 10. Help for Refresh ΓòÉΓòÉΓòÉ
  1324.  
  1325. Choose this if you want to Refresh the window for the TE/2 Pro! main container. 
  1326.  
  1327.  
  1328. ΓòÉΓòÉΓòÉ 11. Help for Help Menu ΓòÉΓòÉΓòÉ
  1329.  
  1330. Choose this if you want Help for the TE/2 Pro! main container window. 
  1331.  
  1332.  
  1333. ΓòÉΓòÉΓòÉ 12. Help for Create ΓòÉΓòÉΓòÉ
  1334.  
  1335. Choose this if you wish to either create a terminal or a phone book. 
  1336.  
  1337.  
  1338. ΓòÉΓòÉΓòÉ 12.1. Help for Create Terminal ΓòÉΓòÉΓòÉ
  1339.  
  1340. Choose this if you wish to create a new terminal session.  The session will be 
  1341. a copy of the default session.  You will, however, be prompted to change any or 
  1342. all of the settings of the newly created session. 
  1343.  
  1344.  
  1345. ΓòÉΓòÉΓòÉ 12.2. Help for Copy Terminal ΓòÉΓòÉΓòÉ
  1346.  
  1347. Choose this if you wish to create a copy of the currently selected terminal 
  1348. session.  You will be prompted to change any or all of the settings of the 
  1349. original session. 
  1350.  
  1351.  
  1352. ΓòÉΓòÉΓòÉ 12.3. Help for Delete Terminal ΓòÉΓòÉΓòÉ
  1353.  
  1354. Help for Delete Terminal Choose this if you wish to delete the currently 
  1355. selected terminal session. 
  1356.  
  1357.  
  1358. ΓòÉΓòÉΓòÉ 12.4. Help for Create Phone Book ΓòÉΓòÉΓòÉ
  1359.  
  1360. Choose this if you wish to create a new phone book.  You will be prompted to 
  1361. choose between a copy of the currently selected phone book and a copy of the 
  1362. default phone book. 
  1363.  
  1364.  
  1365. ΓòÉΓòÉΓòÉ 12.5. Help for Copy Phone Book ΓòÉΓòÉΓòÉ
  1366.  
  1367. Choose this if you wish to copy the currently selected phone book. 
  1368.  
  1369.  
  1370. ΓòÉΓòÉΓòÉ 12.6. Help for Delete Phone Book ΓòÉΓòÉΓòÉ
  1371.  
  1372. Choose this if you wish to delete the currently selected phone book. 
  1373.  
  1374.  
  1375. ΓòÉΓòÉΓòÉ 12.7. Help for Create Directory Entry ΓòÉΓòÉΓòÉ
  1376.  
  1377. Choose this if you want to create a directory entry. You will be asked to 
  1378. supply various items of information for the directory entry such as Name, 
  1379. Number, Baud Rate, etc. 
  1380.  
  1381.  
  1382. ΓòÉΓòÉΓòÉ 12.8. Help for Duplicate Directory Entry ΓòÉΓòÉΓòÉ
  1383.  
  1384. Choose this if you wish to duplicate the currently selected directory entry or 
  1385. entries. 
  1386.  
  1387.  
  1388. ΓòÉΓòÉΓòÉ 13. Help for Copy Directory Entry ΓòÉΓòÉΓòÉ
  1389.  
  1390. Choose this if you want to copy the currently selected directory entry or 
  1391. entries.  You will be prompted for a phone book to copy the selected entry or 
  1392. entries to. 
  1393.  
  1394.  
  1395. ΓòÉΓòÉΓòÉ 14. Help for Move Directory Entry ΓòÉΓòÉΓòÉ
  1396.  
  1397. Choose this if you want to move the currently selected directory entry or 
  1398. entries from the currently active phone book to some other phone book. 
  1399.  
  1400.  
  1401. ΓòÉΓòÉΓòÉ 15. Help for Delete Directory Entry ΓòÉΓòÉΓòÉ
  1402.  
  1403. Choose this if you wish to delete the currently selected directory entry or 
  1404. entries from the currently active phone book. 
  1405.  
  1406.  
  1407. ΓòÉΓòÉΓòÉ 16. Help for Select ΓòÉΓòÉΓòÉ
  1408.  
  1409. Choose this if you want to select or deselect every entry in the dialing 
  1410. directory of the currently active phone book. 
  1411.  
  1412.  
  1413. ΓòÉΓòÉΓòÉ 16.1. Help for Select All ΓòÉΓòÉΓòÉ
  1414.  
  1415. Choose this if you want to select every entry in the dialing directory of the 
  1416. currently active phone book. 
  1417.  
  1418.  
  1419. ΓòÉΓòÉΓòÉ 16.2. Help for Deselect All ΓòÉΓòÉΓòÉ
  1420.  
  1421. Choose this if you want to deselect every entry in the dialing directory of the 
  1422. currently active phone book. 
  1423.  
  1424.  
  1425. ΓòÉΓòÉΓòÉ 17. Help for Sort ΓòÉΓòÉΓòÉ
  1426.  
  1427. Choose this if you wish to sort the currently active phone book.  You will be 
  1428. prompted with a choice of sort criteria including ID, Name, Number, Last 
  1429. Connect, and Connect Count. 
  1430.  
  1431.  
  1432. ΓòÉΓòÉΓòÉ 17.1. Help for Sort by Name ΓòÉΓòÉΓòÉ
  1433.  
  1434. Choose this if you wish to sort the main container according to the names of 
  1435. the sessions. 
  1436.  
  1437.  
  1438. ΓòÉΓòÉΓòÉ 17.2. Help for Sort by Type ΓòÉΓòÉΓòÉ
  1439.  
  1440. Choose this if you wish to sort the main container according to the Type 
  1441. (Description) of the sessions. 
  1442.  
  1443.  
  1444. ΓòÉΓòÉΓòÉ 17.3. Help for Sort Directory by Tag ΓòÉΓòÉΓòÉ
  1445.  
  1446. Choose this if you wish to sort the currently active phone book by ID. 
  1447.  
  1448.  
  1449. ΓòÉΓòÉΓòÉ 17.4. Help for Sort Directory by Name ΓòÉΓòÉΓòÉ
  1450.  
  1451. Choose this if you wish to sort the currently active phone book by Name. 
  1452.  
  1453.  
  1454. ΓòÉΓòÉΓòÉ 17.5. Help for Sort Directory by Number ΓòÉΓòÉΓòÉ
  1455.  
  1456. Choose this if you wish to sort the currently active phone book by Number. 
  1457.  
  1458.  
  1459. ΓòÉΓòÉΓòÉ 17.6. Help for Sort Directory by Connect Date ΓòÉΓòÉΓòÉ
  1460.  
  1461. Choose this if you wish to sort the currently active phone book by Connect 
  1462. Date. 
  1463.  
  1464.  
  1465. ΓòÉΓòÉΓòÉ 17.7. Help for Sort Directory by Connect Count ΓòÉΓòÉΓòÉ
  1466.  
  1467. Choose this if you wish to sort the currently active phone book by Connect 
  1468. Count. 
  1469.  
  1470.  
  1471. ΓòÉΓòÉΓòÉ 18. Help for Arrange ΓòÉΓòÉΓòÉ
  1472.  
  1473. Choose this if you wish to arrange icons. 
  1474.  
  1475.  
  1476. ΓòÉΓòÉΓòÉ 19. Help for File ΓòÉΓòÉΓòÉ
  1477.  
  1478. Choose this if you wish to upload or download a file, open, close or pause a 
  1479. logfile, run, repeat, halt, load or unload a script file. 
  1480.  
  1481.  
  1482. ΓòÉΓòÉΓòÉ 19.1. Help for Upload ΓòÉΓòÉΓòÉ
  1483.  
  1484. Choose this if you wish to upload a file. You will be prompted for the name and 
  1485. path of the file to be uploaded.  Once that information is obtained, the file 
  1486. will be placed in the upload queue. 
  1487.  
  1488.  
  1489. ΓòÉΓòÉΓòÉ 19.2. Help for Download ΓòÉΓòÉΓòÉ
  1490.  
  1491. Choose this if you wish to download a file. You will be prompted for a choice 
  1492. of protocol for the download.  Available protocols include XModem, XModem1k, 
  1493. YModem, YModem-G, ZModem. 
  1494.  
  1495.  
  1496. ΓòÉΓòÉΓòÉ 19.3. Help for Logfile ΓòÉΓòÉΓòÉ
  1497.  
  1498. Choose this if you wish to open, close or pause a logfile.  If you choose to 
  1499. open a logfile, you will be asked to supply a name for the logfile. This can be 
  1500. an already existing file or a new file. 
  1501.  
  1502.  
  1503. ΓòÉΓòÉΓòÉ 19.4. Help for Script ΓòÉΓòÉΓòÉ
  1504.  
  1505. Choose this if you wish to Run, Repeat, Halt, Load, or Unload a script file. 
  1506.  
  1507.  
  1508. ΓòÉΓòÉΓòÉ 19.5. Help for Options ΓòÉΓòÉΓòÉ
  1509.  
  1510. Choose this if you wish to affect the following options: Horizontal Scrollbar, 
  1511. Vertical Scrollbar Font, Local Echo, Carriage Return - Carriage Return Line 
  1512. Feed Conversion, Toolbox, Remote Input Window, and Review Window 
  1513.  
  1514.  
  1515. ΓòÉΓòÉΓòÉ 19.6. Help for Emulations ΓòÉΓòÉΓòÉ
  1516.  
  1517. Choose this if you wish to change the currently selected emulation.  Available 
  1518. emulations include TTY, ANSI, ANSI-TE2, VT 100/102, IBM3101, and Avatar. 
  1519.  
  1520.  
  1521. ΓòÉΓòÉΓòÉ 20. Help for Copy ΓòÉΓòÉΓòÉ
  1522.  
  1523. Choose this if you wish to copy the selected contents of the terminal screen to 
  1524. the copy buffer. 
  1525.  
  1526.  
  1527. ΓòÉΓòÉΓòÉ 21. Help for Copy all ΓòÉΓòÉΓòÉ
  1528.  
  1529. Choose this if you wish to copy the entire terminal screen to the copy buffer. 
  1530.  
  1531.  
  1532. ΓòÉΓòÉΓòÉ 22. Help for Paste ΓòÉΓòÉΓòÉ
  1533.  
  1534. Choose this if you wish to paste the contents of the copy buffer to terminal 
  1535. screen. 
  1536.  
  1537.  
  1538. ΓòÉΓòÉΓòÉ 23. Help for Clear (mark) ΓòÉΓòÉΓòÉ
  1539.  
  1540. Choose this if you wish to unmark a marked area of the terminal session. 
  1541.  
  1542.  
  1543. ΓòÉΓòÉΓòÉ 24. Help for Clear screen ΓòÉΓòÉΓòÉ
  1544.  
  1545. Choose this if you wish to clear the terminal screen. 
  1546.  
  1547.  
  1548. ΓòÉΓòÉΓòÉ 25. Help for Send break ΓòÉΓòÉΓòÉ
  1549.  
  1550. Choose this if you wish to send a break signal to the terminal. 
  1551.  
  1552.  
  1553. ΓòÉΓòÉΓòÉ 26. Help for Send init ΓòÉΓòÉΓòÉ
  1554.  
  1555. Choose this if you wish to send an initialization signal to the modem. 
  1556.  
  1557.  
  1558. ΓòÉΓòÉΓòÉ 27. Help for Manual Dial ΓòÉΓòÉΓòÉ
  1559.  
  1560. Choose this if you wish to perform a manual dial.  You will be prompted for a 
  1561. phone number to dial. 
  1562.  
  1563.  
  1564. ΓòÉΓòÉΓòÉ 28. Help for Hangup ΓòÉΓòÉΓòÉ
  1565.  
  1566. Choose this if you wish to send a hangup signal to the modem. 
  1567.  
  1568.  
  1569. ΓòÉΓòÉΓòÉ 29. Help for Close ΓòÉΓòÉΓòÉ
  1570.  
  1571. Choose this if you wish to close the currently open terminal session. 
  1572.  
  1573.  
  1574. ΓòÉΓòÉΓòÉ 30. Help for Window Menu ΓòÉΓòÉΓòÉ
  1575.  
  1576.  
  1577. ΓòÉΓòÉΓòÉ 30.1. Help for Restore Window ΓòÉΓòÉΓòÉ
  1578.  
  1579. Choose this if you wish to restore the window of the currently active terminal 
  1580. session. 
  1581.  
  1582.  
  1583. ΓòÉΓòÉΓòÉ 30.2. Help for Move Window ΓòÉΓòÉΓòÉ
  1584.  
  1585. Choose this if you wish to move the window of the currently active terminal 
  1586. session. 
  1587.  
  1588.  
  1589. ΓòÉΓòÉΓòÉ 30.3. Help for Size Window ΓòÉΓòÉΓòÉ
  1590.  
  1591. Choose this if you wish to change the size of the window of the currently 
  1592. active terminal session. 
  1593.  
  1594.  
  1595. ΓòÉΓòÉΓòÉ 30.4. Help for Minimize Window ΓòÉΓòÉΓòÉ
  1596.  
  1597. Choose this if you wish to minimize the window of the currently active terminal 
  1598. session. 
  1599.  
  1600.  
  1601. ΓòÉΓòÉΓòÉ 30.5. Help for Maximize Window ΓòÉΓòÉΓòÉ
  1602.  
  1603. Choose this if you wish to maximize the window of the currently active terminal 
  1604. session. 
  1605.  
  1606.  
  1607. ΓòÉΓòÉΓòÉ 30.6. Help for Hide Window ΓòÉΓòÉΓòÉ
  1608.  
  1609. Choose this if you wish to hide the window of the currently active terminal 
  1610. session. 
  1611.  
  1612.  
  1613. ΓòÉΓòÉΓòÉ 30.7. Help for Close Window ΓòÉΓòÉΓòÉ
  1614.  
  1615. Choose this if you wish to close the window of the currently active terminal 
  1616. session. 
  1617.  
  1618.  
  1619. ΓòÉΓòÉΓòÉ 30.8. Help for Window List ΓòÉΓòÉΓòÉ
  1620.  
  1621. Choose this if you wish to see a list of active programs.  This has the same 
  1622. effect as pressing Ctrl-Esc. 
  1623.  
  1624.  
  1625. ΓòÉΓòÉΓòÉ 31. Help for Buffered Chat Mode ΓòÉΓòÉΓòÉ
  1626.  
  1627. Choose this if you wish to buffer the current chat session.  In an unbuffered 
  1628. session, all typed characters are sent immediately to the modem; in a buffered 
  1629. session, typed characters are not sent to the modem until a carriage return is 
  1630. entered. 
  1631.  
  1632.  
  1633. ΓòÉΓòÉΓòÉ 32. Help for Switch to Main Window ΓòÉΓòÉΓòÉ
  1634.  
  1635. Choose this if you wish to switch from the Chat window to the Main window of 
  1636. the currently active terminal session. 
  1637.  
  1638.  
  1639. ΓòÉΓòÉΓòÉ 33. Help for Refresh Scrollback ΓòÉΓòÉΓòÉ
  1640.  
  1641. Choose this if you wish to Refresh the Scrollback Buffer. 
  1642.  
  1643.  
  1644. ΓòÉΓòÉΓòÉ 34. Dialer Help ΓòÉΓòÉΓòÉ
  1645.  
  1646. Help for Dialer 
  1647.  
  1648.  
  1649. ΓòÉΓòÉΓòÉ 35. Keys Help ΓòÉΓòÉΓòÉ
  1650.  
  1651. In the TE/2 Pro! Main Window, in the Dialing Directory, and all Notebooks, all 
  1652. standard, OS/2, CUA keystrokes are active.  See the OS/2 online help for 
  1653. information on these.  The CUA keystrokes are also active in a terminal window 
  1654. when a menu is displayed.  In order to preserve continutity with TE/2 Classic 
  1655. and with the actual behavior of the terminals which TE/2 Pro! emulates, you may 
  1656. define any of the "F" keys as you see fit via the Terminal Object's Settings 
  1657. Notebook, see the section titled "Assign actions to function keys". 
  1658.  
  1659. In the VT102 emulation defaults, the function keys F1, F2, F3, and F4 are 
  1660. defined to transmit the standard VT102 codes for PF1 through PF4. 
  1661.  
  1662. In addition, there are a number of "Alt" key combinations and other keystrokes 
  1663. which have special function in terminal mode: 
  1664.  
  1665. Alt A          Emulations popup menu 
  1666. Alt B          Send BREAK 
  1667. Alt C          Clear Screen 
  1668. Alt E          Toggle Local Echo 
  1669. Alt F          Font dialog 
  1670. Alt G          Chat Window 
  1671. Alt H          Hangup 
  1672. Alt L          Log open or Logfile popup menu if already open 
  1673. Alt M          Manual Dial 
  1674. Alt N          Download popup menu (also Gray-PageDown) 
  1675. Alt R          Manual Dial 
  1676. Alt T          Toolbox 
  1677. Alt U          Upload dialog (also Gray-PageUp) 
  1678. Alt V          Toggle CR<->CRLF 
  1679. Alt W          Scrollback Window 
  1680. Alt X          Close 
  1681. Ctrl-Insert    Copy marked text to clipboard 
  1682. Shift-Insert   Paste text from clipboard 
  1683.