═══ 1. Welcome ═══ Welcome to TE/2 Pro! Version 2. This copy of TE/2 Pro! will cease to function after 50 executions unless you provide a registration key. Please contact Oberon Software or the vendor from which you purchased this copy of TE/2 Pro! to receive a registration key. If this is a test drive (e.g., you downloaded it from a BBS or FTP site), then please contact Oberon Software for purchasing information. Oberon Software, Inc. 1405 East Main Street Mankato, MN 56001-5070 USA Phone: 507-388-7001 FAX: 507-388-7568 BBS: 507-388-1154 Internet: oberon@prairie.lakes.com http://prairie.lakes.com/~oberon To obtain help for any particular menu item, highlight that item from within TE/2 Pro! and press the F1 key. You may also open the help file contents window from within this help window and search for the item of interest. A How Do I? section is also provided. If all else fails, contact Oberon Software be e-mail or phone. We're always happy to help! Other points of interest are: Getting Started Product Overview System Requirements Oberon Software Info ═══ 2. TE/2 Pro! Overview ═══ TE/2 Pro! is Oberon Software's new, object-oriented, Workplace Shell aware, telecommunications program for OS/2 Warp. TE/2 Pro!, based on the same telecommunications engine, file transfer protocols, and terminal emulations as Oberon's very successful, original TE/2, adds the desktop object behaviors and drag and drop interfaces which OS/2 Warp users are used to while maintaining the robustness and reliability of the original product. In addition to long-standing TE/2 features such as robust, high-speed telecommunications support, seven terminal emulation modes, fast, reliable file transfer protocols, and extensive REXX scripting capabilities, some of the new features for TE/2 Pro! will include:  Object Oriented User Interface. - Terminal sessions and dialing directories appear as objects. These objects use standard OS/2 notebook controls for their settings, may be opened in various views, dragged to the printer or shredder as OS/2 users would expect. - Dialing directory entries can be copied or moved easily between directories or dialed by simply dragging them to a terminal object.  Support for multiple, simultaneous sessions. One invocation of TE/2 Pro! can support a virtually unlimited number of terminal sessions.  Terminal objects which do not compete for the same device may be active simultaneously.  Asynch, TCP/IP, and Named Pipe support built in.  Any terminal object may be set to access a modem port, a TCP/IP socket (if the user has TCP/IP installed), or a Named Pipe server.  Multiwindow chat and scroll back. Rather than the split-screen and/or "modal" ways of handling these features, TE/2 Pro! uses standard OS/2 windows which can be sized, moved, retained, or closed as the user desires.  Of course, copy and paste via the OS/2 clipboard is available throughout. System Requirements ═══ 2.1. System Requirements ═══ IBM compatible with Intel compatible 386 or better processor 8 megabytes of RAM 2 megabytes of unused hard disk space VGA or better video card and monitor monitor Serial port (optional) TCP/IP software ═══ 3. Oberon Software ═══ Oberon Software has been developing OS/2 software and providing OS/2 related services since 1988. More than just a specialty, OS/2 related products and services are Oberon Software's only business. Other Oberon products include FSHL - Oberon Software's Alternative Command Line Executive, DiskStat, LstPM, and the Commpak/2 Programmer's Toolkit for creating telecommunications routines under OS/2. In addition, Oberon Software has developed unique, OS/2 based solutions for a number of major corporations in the banking and communication industries. Oberon Software, Inc. 1405 East Main Street Mankato, MN 56001-5070 USA Phone: 507-388-7001 FAX: 507-388-7568 BBS: 507-388-1154 Internet: oberon@prairie.lakes.com http://prairie.lakes.com/~oberon ═══ 4. Getting Started ═══ Installing TE/2 Pro! Starting TE/2 Pro! Creating Terminals and Phone Books Changing Settings ═══ 4.1. Installing TE/2 Pro! ═══  If you downloaded a test-drive version of TE/2 Pro!, you will first need to unzip the archive file into a temporary directory or onto a diskette. You should use an unzip utility such as Info-ZIP's unzip.exe.  Open an OS/2 folder for the diskette or directory which contains the TE/2 Pro! installation files -- or -- open an OS/2 command line session and change disk/directory to that location.  Execute INSTALL.EXE by double-clicking on its icon or by typing "INSTALL" at the OS/2 command prompt.  Follow the instructions given to you by the install program. ═══ 4.2. Starting TE/2 Pro! ═══ When you installed TE/2 Pro! an OS/2 desktop folder was created which contains a TE/2 Pro! program object. Just double-click on this object to start TE/2 Pro! ═══ 4.3. Creating Terminals and Phone Books ═══ Terminals and phone books can be created by any of the following methods:  Click the right mouse button on any vacant area of the TE/2 screen - Click on Create - Click on either Terminal or Phone Book  Hold the Control Key down while dragging a Terminal or Phone Book object - This will copy the object and immediately open its Settings Notebook for you.  Click the right mouse button on a session icon. - Select Create Another  Click the right mouse button on a Phone Book icon. - Select Create Another ═══ 4.4. Changing Settings ═══  The Program Page of the OS/2 Program Object Settings Notebook can be used: - To pass options to TE/2 Pro! - To set the default working directory to the directory in which you installed TE/2 Pro!  The Settings Notebook for the main TE/2 Pro window can be used to change: - Main window background - Various sounds associated with -- Program start -- Program end -- Program errors -- Various notifications -- Sounds associated with various file transfer actions - Your Registration Name and ID  Terminal session settings can be changed by Clicking the right mouse button on any Session icon Selecting the Settings notebook  Phone Book settings can be changed by Clicking the right mouse button on any Phone Book icon Selecting the Settings notebook ═══ 5. How Do I? ═══ General How To... Comments Use the Toolbox Upload a file Download a file Capture data to a log file Dial a number that is not in a Phone Book Print a Phone Book Use Copy and Paste Use Chat Mode ═══ 5.1. General How To... Comments ═══ TE/2 Pro! gives you a choice of ways to accomplish any task. You can 1. Use menus to make a selection 2. Use Alt-key combinations to perform functions 3. Click on Toolbox icons to perform functions All three ways are equally valid. Choose the interface that makes you feel most comfortable. ═══ 5.2. Use the Toolbox ═══ The Toolbox allows you to click icons to accomplish things  Up arrow uploads a file  Down arrow downloads a file  The file icon with the superimposed arrow opens a log file  Scroll icon scrolls back through session activity  Telephone dial icon allows you to manually dial a number  Telephone handset icon allows you to hangup  Information about session settings is displayed. These settings can be changed by clicking the left mouse button over the setting you wish to change. ═══ 5.3. Upload a file ═══ In order to upload a file, you must have a session running. There are several ways to upload a file.  Drag one or more file objects from an OS/2 folder onto a running TE/2 Pro! terminal session window. A dialog box will appear at the bottom of the screen. The file(s) you dragged onto TE/2 Pro will be listed in this dialog. If you wish to add files to this dialog, you may - Drag and drop more file objects onto the terminal window and/or ... - Use the Select button to use a standard OS/2 file dialog Select a protocol. Click on Options to set any options for that protocol. Click on select to choose the file(s) you wish to upload. Click on Start Upload to begin the file transfer.  Click on the download icon in the toolbox. (The logfile icon is the first icon on the left) A dialog box will appear at the bottom of the screen. Select a protocol. Click on Options to set any options for that protocol. Click on select to choose the file(s) you wish to upload. Click on Start Upload to begin the file transfer.  Press Alt+U. Select a file transfer protocol. A dialog box will appear at the bottom of the screen. Select a protocol. Click on Options to set any options for that protocol. Click on select to choose the file(s) you wish to upload. Click on Start Upload to begin the file transfer.  Click the right mouse button anywhere on running terminal session. A popup menu will appear. Select File. When the second menu appears, select Upload. A dialog box will appear at the bottom of the screen. Select a protocol. Click on Options to set any options for that protocol. Click on select to choose the file(s) you wish to upload. Click on Start Upload to begin the file transfer. ═══ 5.4. Download a file ═══ In order to download a file, you must have a session running. There are several ways to download a file.  Click on the download icon in the toolbox. (The download icon is the second icon on the left) Select a protocol. - If you chose one of the XMODEM protocols, you will be asked to choose a name for the file you are about to download. This name will become the name of the file when it is stored on your computer. - You will not be asked for a file name if you choose one of the other file transfer protocols. TE/2 Pro! will begin the file transfer.  Press Alt+N. Select a protocol. - If you chose one of the XMODEM protocols, you will be asked to choose a name for the file you are about to download. This name will become the name of the file when it is stored on your computer. - You will not be asked for a file name if you choose one of the other file transfer protocols. TE/2 Pro! will begin the file transfer.  Click the right mouse button anywhere on running terminal session. A popup menu will appear. Select File. When the second menu appears, select Download Select a protocol. - If you chose one of the XMODEM protocols, you will be asked to choose a name for the file you are about to download. This name will become the name of the file when it is stored on your computer. - You will not be asked for a file name if you choose one of the other file transfer protocols. TE/2 Pro! will begin the file transfer. ═══ 5.5. Capture data to a log file ═══ In order to capture data to a log file, you must have a session running. There are several ways to capture data to a log file.  Click on the logfile icon in the toolbox. (The logfile icon is the third icon from the left) A file open dialog will appear. Choose a file name. Click on OK  Press Alt+L. A file open dialog will appear. Choose a file name. Click on OK  Click the right mouse button on the screen of an open session. A popup menu will appear. Click on File. Click on Logfile. Click on Open. A file open dialog will appear. Choose a file name. Click on OK ═══ 5.6. Dial a number that is not in a Phone Book ═══ In order to manually dial a phone number, you must have a session running. There are several ways to dial a number that is not in one of the Phone Books.  Click on the Telephone icon in the toolbox. (The Telephone icon is the fourth icon from the left) An entryfield will appear. Enter the phone number. Click on OK.  Press Alt+M. An entryfield will appear. Enter the phone number. Click on OK.  Click the right mouse button on the screen of an open session. A popup menu will appear. Click on Dial. An entryfield will appear. Enter the phone number. Click on OK. ═══ 5.7. Print a Phone Book ═══ To print an entire Phone Book Use the right mouse button to drag the Phone Book icon to a printer object on the OS/2 desktop. To print a single Phone Book entry Open the Phone Book Select the entry you want to print Use the right mouse button to drag the Phone Book entry to a printer object on the OS/2 desktop. ═══ 5.8. Use Copy and Paste ═══ These features allow you to use the OS/2 clipboard to transfer data between TE/2 Pro! and another program. To copy all the data in a session window Click the right mouse button anywhere in the client area of the session window When the popup menu appears, click on Copy all To copy selected data from a session window Hold down the left mouse button Drag the mouse across the data you want to capture from the session window Press Control+Insert or... Click on the right mouse button. When the popup menu appears, click on Copy. Data copied to the clipboard can then be pasted into other OS/2 applications To paste data into a session from another application Press Shift+Insert or... Click the right mouse button anywhere in the client area of the session window. When the popup menu appears, click on Paste. ═══ 5.9. Use Chat mode ═══ TE/2 Pro! supplies a built in, split window chat mode for use with the CB Simulators provided by some on-line services, multiuser real-time conferences provided by some services and bulletin boards, and chatting with bulletin board sysops if they offer a chat mode on their BBS. To activate the "Remote Input Window":  Press Alt+G or ...  Click the right mouse button on the screen of an open session. A popup menu will appear. Click on Options. Click on Remote Input Window. When the Remote Input Window is active, anything you type into it will be transmitted as though you had typed it into the TE/2 Pro! terminal window (with some differences, noted below). The regular terminal window is still active while the Remote Input Window is displayed and it may be used as normal. The Remote Input Window has its own popup menu that is activated by clicking the right mouse button anywhere in its window. The special features of the Remote Input Window are:  Buffered Input: If Buffered Input is active, no typed characters will be transmitted until you press ENTER. If Buffered Input is not active, typed characters are transmitted as you type them.  The options submenu allows you to: Turn the scroll bars for this window on and off. Change the character font for this window. Change the size (rows and columns) for this window. ═══ 6. Scripting ═══ TE/2 Pro! scripts are all written using the REXX scripting language which is built into OS/2. This document is not intended to be a tutorial on the REXX language. For information on the REXX language, you can begin by reading the online REXX document which comes with OS/2. This document is usually located in the OS/2 "Information" folder. There are also many good books available which cover the REXX language in detail. Because of the extensible nature of REXX, you can use TE/2 Pro! REXX scripts in conjuction with any of the REXX extension packages available:  OS/2 includes a REXXUTIL package which provides OS/2 system and file services.  Visual REXX tools, such as Hockware's VisPro REXX and Watcom's VXREXX give you the ability to create dialog boxes and other GUI features with your REXX programs and scripts.  Communications Manager/2 provides a REXX extension package if you need to use HLLAPI to communicate with your host sessions.  DB2/2 provides a REXX package for accessing its databases.  REXX socket services and FTP services are available from IBM and others for use in REXX programs and scripts.  And so on... When TE/2 Pro! executes a REXX script, it acts as a subcommmand handler. That is, any command which REXX doesn't recognize will be routed back into TE/2 Pro! to be executed. This documents will cover the subcommands which TE/2 Pro! recognizes. How to execute TE/2 Pro! scripts Subcommand reference ═══ 6.1. How to execute TE/2 Pro scripts ═══ In general, TE/2 Pro! scripts must reside in the current working directory. That is, the directory in which the TE/2 Pro! executable is running. Alternately, you may define an environment variable TPSCRIPTPATH which should contain a semi-colon delimited list of directories in which TE/2 Pro! should look for its scripts. If no path is provided when you execute the script, TE/2 Pro! will always look in the current directory first and then in the directories listed in TPSCRIPTPATH. There are several ways to execute TE/2 Pro! scripts:  Automatically when you dial a Phone Book entry Enter the script name in the "Script" field of the Phone Book entry. The script will be executed once a successful connection has been made to this site.  Automatically when you open or close a Terminal Session Enter the script name(s) in the Terminal Settings Notebook on the Session->Scripts page. Scripts can be executed: - When the terminal starts, before the device has been opened. - When the terminal starts, after the device has been opened. - When the terminal closes, before the device is closed. - When the terminal closes, after the device is closed.  Manually from a Terminal Session's popup menu - From the popup menu select File->Script->Run... - To re-run the last script, select File->Script->Repeat - To halt a running script, select File->Script->Halt - If you expect to run a particular script quite often during the current session, you may load it into memory by selecting File->Script->Load. This will save on disk access time on subsequent executions of the script. ═══ 6.2. Subcommand reference ═══ The following subcommands are recognized by TE/2 Pro! CLOSE CLS DOWNLOAD EXECWAIT HANGUP LOGFILE MESSAGEBOX MESSAGEBOXV QUERY BAUD QUERY CARRIER QUERY DATABITS QUERY DEVICE QUERY DEVICEHANDLE QUERY DEVICESTATE QUERY PARITY QUERY STOPBITS RCVCAPTURE RECEIVE RUN SAY SET BAUD SET DATABITS SET PARITY SET STOPBITS SLEEP STARTSESSION TRANSMIT UPLOAD WAIT WAITV WAITXFER ═══ 6.2.1. CLOSE ═══ Parameters: None Note: This posts a "CLOSE" message to the terminal window. It will close within microseconds so you are STRONGLY advised to make this the final statement in your script just before the REXX "exit" statement. If the terminal has either an UnInit or CleanUp script (or both) defined, they will be executed as normal. Returns: Always 0 ═══ 6.2.2. CLS ═══ Parameters: None Note: Clears the terminal screen to blanks. Returns: Always 0 ═══ 6.2.3. DOWNLOAD ═══ Parameters: protocol (Required) Must be one of:  xmodem  xmodem1k  ymodem  ymodemg  zmodem filename Required for xmodem and xmodem1k. Ignored otherwise. Note: File transfer proceeds asynchronously. See WAITXFER. Returns: 0 transfer started 1 transfer did not start 256 terminal is busy Examples: 'DOWNLOAD XMODEM1K file.dat' 'DOWNLOAD ZMODEM' ═══ 6.2.4. EXECWAIT ═══ Parameters: program (Required) File path/name to executable program arguments (Optional) Command line parameters for executed program Note: Runs the specified program with all defaults set (see STARTSESSION) and waits for it to complete before returning. Returns: Return value from executed program Example: 'EXECWAIT c:\os2\chkdsk.com a:' ═══ 6.2.5. HANGUP ═══ Parameters: None Note: Sends the defined hangup sequence to the device. Returns: FALSE if CD is high after hangup, TRUE otherwise ═══ 6.2.6. LOGFILE ═══ Parameters: option Must be one of the following:  query  open  append  close  activate  pause  toggle filename Required for options "open" and "append". Ignored otherwise. Returns: The state and filename of the current logfile. Note: If the state is "CLOSED", there is no filename. Possible states are:  ACTIVE  PAUSED  CLOSED ═══ 6.2.7. MESSAGEBOX ═══ Parameters: text (Required) The text to display in the message box area. title (Optional) Title bar text for message box. style (Optional) Style for the message box. See notes. Note: If "title" is not specified, the name of the running script is placed in the title bar. If "style" is not specified, the message box will be movable, have the OS/2 "Info" icon, and an Enter button. If "style" is specified, it must be a numeric value which represents the style. A list of useful style values is given below. If your "style" does not otherwise contain a button, an Enter button will be added. Returns: The return value from the message box. Possible values are: 1 OK button pressed 2 CANCEL button pressed 3 ABORT button pressed 4 RETRY button pressed 5 IGNORE button pressed 6 YES button pressed 7 NO button pressed 8 HELP button pressed 9 ENTER button pressed Else An error occurred Styles: These values may be combined by binary ORing them together: Buttons 0 OK 1 OK, CANCEL 2 RETRY, CANCEL 3 ABORT, RETRY, IGNORE 4 YES, NO 5 YES, NO, CANCEL 6 CANCEL 7 ENTER 8 ENTER, CANCEL Icons 0 No icon 16 Question 32 Warning 48 Info 64 Critical Other 256 Button 2 is default 512 Button 3 is default 4096 System modal 16384 Moveable Example: /* 0x4046 is moveable+critical+cancel button */ 'MESSAGEBOX "A critical error occurred!" "Error!"' X2D('4046') ═══ 6.2.8. MESSAGEBOXV ═══ Parameters: (Required) REXX stem variable name (see note) Note: This is another, perhaps more concise way to call MESSAGEBOX. All notes regarding return codes and style given there apply here as well. The stem variable can contain the following fields: text (Required) The text to display in the message box area. title (Optional) Title bar text for message box. style (Optional) Style for the message box. Returns: Same as MESSAGEBOX Example: msgbox.text = 'A Critical Error Occurred!' msgbox.title = 'Error!' msgbox.style = x2D('4046') /* moveable, critical, cancel button */ 'MESSAGEBOXV msgbox' ═══ 6.2.9. QUERY BAUD ═══ Parameters: (Optional) REXX variable name Note: If supplied, the REXX variable will be filled in with the same value as the return code. Since REXX treats return values as signed integers, you will get negative results in RC for 38,400 baud and greater. Use this option for more consistant results. Returns: Current baud rate ═══ 6.2.10. QUERY CARRIER ═══ Parameters: (Optional) REXX variable name Note: If supplied, the REXX variable will be filled in with the same value as the return code. Returns: 0 Terminal is NOT online 1 Terminal is online ═══ 6.2.11. QUERY DATABITS ═══ Parameters: (Optional) REXX variable name Note: If supplied, the REXX variable will be filled in with the same value as the return code. Returns: Current databit setting ═══ 6.2.12. QUERY DEVICE ═══ Parameters: (Optional) REXX variable name Note: If supplied, the REXX variable will be filled in with the same value as the return code. Returns: Current device name ═══ 6.2.13. QUERY DEVICEHANDLE ═══ Parameters: (Optional) REXX variable name Note: If supplied, the REXX variable will be filled in with the same value as the return code. Returns: Current device handle ═══ 6.2.14. QUERY DEVICESTATE ═══ Parameters: (Required) REXX variable name Note: Uses the REXX variable as a stem variable and fills in the following fields: Device Current device name Baud Current baud rate Parity Current parity (see QUERY PARITY) DataBits Current databit setting StopBits Current stopbit setting (see QUERY STOPBITS) Carrier 1 if online, 0 if not Handle Current device handle Returns: Always 0 Example: devstate. = '' /* clear out the variable */ 'QUERY DEVICESTATE devstate' say devstate.device 'is set to' devstate.baud'bps' ═══ 6.2.15. QUERY STOPBITS ═══ Parameters: (Optional) REXX variable name Note: If supplied, the REXX variable will be filled in with the same value as the return code. Returns: Current stopbit setting: 1, 1.5, or 2 ═══ 6.2.16. QUERY PARITY ═══ Parameters: (Optional) REXX variable name Note: If supplied, the REXX variable will be filled in with the same value as the return code. Returns: Current parity setting: None, Even, Odd, Mark, or Space. ═══ 6.2.17. RCVCAPTURE ═══ Parameters: (Required) "TRUE' or "FALSE" Note: RCVCAPTURE TRUE ensures that all modem input will be held until the script issues a RECEIVE statement. Receive Capture mode MUST be turned off with RCVCAPTURE FALSE explicitly! Returns: Always 0 ═══ 6.2.18. RECEIVE ═══ Parameters: length (Required) "nnn" or "CRnnn" where "nnn" is a number between 1 and 255. If "CR" is specified, the receive will terminate early if it encounters a carriage return character from the remote. timeout (Required) Timeout value in seconds. -1 specifies an infinite timeout. echo (Optional) "ECHO" or "NOECHO". If it is neither, the first character of the string specifes the character to echo. If the parameter is omitted, defaults to NOECHO. prefix (Optional) string (one word) which will be prefixed to the result if the result string is longer than zero characters. Use this to overcome REXX's habit of modifying return strings which start with numeric values. Note that you must specify ECHO or NOECHO to use this parameter. Note: Filtering of backspaces from the remote occurs if 'length' is greater than 1. Returns: Length or received string. ═══ 6.2.19. RUN ═══ Parameters: script (Required) script file name args (Optional) arguments for script Note: Runs the indicated script synchrounously. Returns: return code from executed script. ═══ 6.2.20. SAY ═══ Parameters: any string Note: Exactly equivalent to the REXX SAY statement. Returns: Always 0 ═══ 6.2.21. SET BAUD ═══ Parameters: (Required) value Note: value must be one of: 110, 150, 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200, or 230400. Returns: "OK" or "ERROR" ═══ 6.2.22. SET DATABITS ═══ Parameters: (Required) value Note: value must be one of: 5, 6, 7, or 8. Returns: "OK" or "ERROR" ═══ 6.2.23. SET PARITY ═══ Parameters: (Required) value Note: value must be one of: "none", "even", "odd", "mark", or "space" Returns: "OK" or "ERROR" ═══ 6.2.24. SET STOPBITS ═══ Parameters: (Required) value Note: value must be one of: 1, 1.5, or 2 Returns: "OK" or "ERROR" ═══ 6.2.25. SLEEP ═══ Parameters: (Required) value Note: value is sleep time in seconds Returns: Always 0 ═══ 6.2.26. STARTSESSION ═══ Parameters: REXX var (Required) see note "WAIT" (Optional) If specified, execution of script pauses until child session ends. Note: The REXX variable may have any and all of the following fields set: Related 0 or 1 (default 1) indicates an independant or a child session, respectively FgBg 0 or 1 (default 0) indicates the session is to be run in the Foreground or Background respectively PgmTitle Window title for the session, default is the empty string which results in the default title bar text (usually the executable file name). PgmName The program to run, must include the file extension although the file extension must be specified. If left blank, CMD.EXE will run. PgmInputs Commandline arguments for the program. Environment Do not use this unless you are familiar with environment blocks. This field is ignored for DOS (VDM) sessions. InheritOpt 0 or 1 (default 1) indicates that the session is to inherit the OS/2 shell's environment or TE/2 Pro's respectively. SessionType Default is 0 (default session type based on the program file itself). Otherwise, the value is chosen from this list: 1 Fullscreen OS/2 session 2 Windowed OS/2 session 3 Presentation manager session 4 Fullscreen DOS (VDM) session 7 Windowed DOS (VDM) session IconFile If left blank (the default), OS/2 provides a default icon for the session. PgmControl Choose from the table below, the default is 0. This field is ignored for fullscreen sessions. 0 visible 1 invisible 2 maximized 4 minimized +8 Do not close on exit Returns: Return code from program or OS/2 error code. Example: pgm. = '' pgm.PgmName = 'c:\os2\apps\pmseek' pgm.InheritOpt = 0 pgm.SessionType = 3 'STARTSESSION pgm WAIT' ═══ 6.2.27. TRANSMIT ═══ Parameters: (Required) quoted string Note: Use double quotes to quote the string. If the string does not contain any space characters, it does not need to be quoted. Returns: Number of bytes transmitted. Examples: 'TRANSMIT "Hello World"' Reset = 'ATZ'||D2C(13) 'TRANSMIT' Reset Hello = 'Hello World' 'TRANSMIT "'Hello'"' ═══ 6.2.28. UPLOAD ═══ Parameters: protocol (Required) Must be one of:  xmodem  xmodem1k  ymodem  ymodemg  zmodem  ascii filename(s) (Required) see note Note: If "protocol" is "xmodem" or "xmodem1k", then "filename" must be a single, non-ambiguous filename. If "protocol" is anything else, then "filename" may contain a comma-delimited list of filenames, any of which may or may not be ambiguous. File transfer proceeds asynchronously. See WAITXFER. Returns: 0 transfer started 1 transfer did not start 256 terminal is busy ═══ 6.2.29. WAIT ═══ Parameters: value (Required) seconds to wait string(s) At least one string is required, may have up to 10 total Note: arguments after the 10th string are ignored and do not cause an error Returns: index of matched string or 0 if timeout, 10000 if keyboard abort Examples: 'WAIT 60 "OK"' 'WAIT 10 "ERROR" "OK"' ═══ 6.2.30. WAITV ═══ Parameters: value (Required) seconds to wait REXX var (Required) see note Note: variable.0 must contain count, strings must be in variable.1, variable.2, etc. If more than 10 are specified, only the first 10 are used and no error is generated Returns: index of matched string or 0 if timeout, 10000 if keyboard abort Example: srch.0 = 2 srch.1 = 'OK' srch.2 = 'ERROR' 'WAITV 10 srch' ═══ 6.2.31. WAITXFER ═══ Parameters: None Note: Pauses script execution until the current file transfer ends. Returns: 0 transfer succeeded 1 transfer failed 256 no transfer in progress ═══ 7. Help for Open ═══ Help for Open Menu ═══ 7.1. Help for Open Settings ═══ Choose this if you wish to open the settings notebook for the TE/2 Pro! main container. ═══ 7.2. Help for Open Terminal ═══ Help for Open Settings Terminal ═══ 7.3. Help for Open Phonebook ═══ Help for Open Settings Phonebook ═══ 7.4. Help for Open Dialer ═══ Help for Open Dialer ═══ 8. Help for View ═══ Choose this if you wish to select between an Icon, Details, Name, or Text view of the dialing directory entries. ═══ 8.1. Help for View Icon ═══ Choose this if you wish to select an Icon view of the dialing directory entries. ═══ 8.2. Help for View Details ═══ Choose this if you wish to select a Details view of the dialing directory entries. ═══ 8.3. Help for View Name ═══ Choose this if you wish to select a Name view of the dialing directory entries. ═══ 8.4. Help for View Text ═══ Choose this if you wish to select a Text view of the dialing directory entries. ═══ 9. Help for Refresh ═══ Choose this if you want to Refresh the window for the TE/2 Pro! main container. ═══ 10. Help for Help Menu ═══ Choose this if you want Help for the TE/2 Pro! main container window. ═══ 11. Help for Create ═══ Choose this if you wish to either create a terminal or a phone book. ═══ 11.1. Help for Create Terminal ═══ Choose this if you wish to create a new terminal session. The session will be a copy of the default session. You will, however, be prompted to change any or all of the settings of the newly created session. ═══ 11.2. Help for Copy Terminal ═══ Choose this if you wish to create a copy of the currently selected terminal session. You will be prompted to change any or all of the settings of the original session. ═══ 11.3. Help for Delete Terminal ═══ Help for Delete Terminal Choose this if you wish to delete the currently selected terminal session. ═══ 11.4. Help for Create Phone Book ═══ Choose this if you wish to create a new phone book. You will be prompted to choose between a copy of the currently selected phone book and a copy of the default phone book. ═══ 11.5. Help for Copy Phone Book ═══ Choose this if you wish to copy the currently selected phone book. ═══ 11.6. Help for Delete Phone Book ═══ Choose this if you wish to delete the currently selected phone book. ═══ 11.7. Help for Create Directory Entry ═══ Choose this if you want to create a directory entry. You will be asked to supply various items of information for the directory entry such as Name, Number, Baud Rate, etc. ═══ 11.8. Help for Duplicate Directory Entry ═══ Choose this if you wish to duplicate the currently selected directory entry or entries. ═══ 12. Help for Copy Directory Entry ═══ Choose this if you want to copy the currently selected directory entry or entries. You will be prompted for a phone book to copy the selected entry or entries to. ═══ 13. Help for Move Directory Entry ═══ Choose this if you want to move the currently selected directory entry or entries from the currently active phone book to some other phone book. ═══ 14. Help for Delete Directory Entry ═══ Choose this if you wish to delete the currently selected directory entry or entries from the currently active phone book. ═══ 15. Help for Select ═══ Choose this if you want to select or deselect every entry in the dialing directory of the currently active phone book. ═══ 15.1. Help for Select All ═══ Choose this if you want to select every entry in the dialing directory of the currently active phone book. ═══ 15.2. Help for Deselect All ═══ Choose this if you want to deselect every entry in the dialing directory of the currently active phone book. ═══ 16. Help for Sort ═══ Choose this if you wish to sort the currently active phone book. You will be prompted with a choice of sort criteria including ID, Name, Number, Last Connect, and Connect Count. ═══ 16.1. Help for Sort by Name ═══ Choose this if you wish to sort the main container according to the names of the sessions. ═══ 16.2. Help for Sort by Type ═══ Choose this if you wish to sort the main container according to the Type (Description) of the sessions. ═══ 16.3. Help for Sort Directory by Tag ═══ Choose this if you wish to sort the currently active phone book by ID. ═══ 16.4. Help for Sort Directory by Name ═══ Choose this if you wish to sort the currently active phone book by Name. ═══ 16.5. Help for Sort Directory by Number ═══ Choose this if you wish to sort the currently active phone book by Number. ═══ 16.6. Help for Sort Directory by Connect Date ═══ Choose this if you wish to sort the currently active phone book by Connect Date. ═══ 16.7. Help for Sort Directory by Connect Count ═══ Choose this if you wish to sort the currently active phone book by Connect Count. ═══ 17. Help for Arrange ═══ Choose this if you wish to arrange icons. ═══ 18. Help for File ═══ Choose this if you wish to upload or download a file, open, close or pause a logfile, run, repeat, halt, load or unload a script file. ═══ 18.1. Help for Upload ═══ Choose this if you wish to upload a file. You will be prompted for the name and path of the file to be uploaded. Once that information is obtained, the file will be placed in the upload queue. ═══ 18.2. Help for Download ═══ Choose this if you wish to download a file. You will be prompted for a choice of protocol for the download. Available protocols include XModem, XModem1k, YModem, YModem-G, ZModem. ═══ 18.3. Help for Logfile ═══ Choose this if you wish to open, close or pause a logfile. If you choose to open a logfile, you will be asked to supply a name for the logfile. This can be an already existing file or a new file. ═══ 18.4. Help for Script ═══ Choose this if you wish to Run, Repeat, Halt, Load, or Unload a script file. ═══ 18.5. Help for Options ═══ Choose this if you wish to affect the following options: Horizontal Scrollbar, Vertical Scrollbar Font, Local Echo, Carriage Return - Carriage Return Line Feed Conversion, Toolbox, Remote Input Window, and Review Window ═══ 18.6. Help for Emulations ═══ Choose this if you wish to change the currently selected emulation. Available emulations include TTY, ANSI, ANSI-TE2, VT 100/102, IBM3101, and Avatar. ═══ 19. Help for Copy ═══ Choose this if you wish to copy the selected contents of the terminal screen to the copy buffer. ═══ 20. Help for Copy all ═══ Choose this if you wish to copy the entire terminal screen to the copy buffer. ═══ 21. Help for Paste ═══ Choose this if you wish to paste the contents of the copy buffer to terminal screen. ═══ 22. Help for Clear (mark) ═══ Choose this if you wish to unmark a marked area of the terminal session. ═══ 23. Help for Clear screen ═══ Choose this if you wish to clear the terminal screen. ═══ 24. Help for Send break ═══ Choose this if you wish to send a break signal to the terminal. ═══ 25. Help for Send init ═══ Choose this if you wish to send an initialization signal to the modem. ═══ 26. Help for Manual Dial ═══ Choose this if you wish to perform a manual dial. You will be prompted for a phone number to dial. ═══ 27. Help for Hangup ═══ Choose this if you wish to send a hangup signal to the modem. ═══ 28. Help for Close ═══ Choose this if you wish to close the currently open terminal session. ═══ 29. Help for Window Menu ═══ ═══ 29.1. Help for Restore Window ═══ Choose this if you wish to restore the window of the currently active terminal session. ═══ 29.2. Help for Move Window ═══ Choose this if you wish to move the window of the currently active terminal session. ═══ 29.3. Help for Size Window ═══ Choose this if you wish to change the size of the window of the currently active terminal session. ═══ 29.4. Help for Minimize Window ═══ Choose this if you wish to minimize the window of the currently active terminal session. ═══ 29.5. Help for Maximize Window ═══ Choose this if you wish to maximize the window of the currently active terminal session. ═══ 29.6. Help for Hide Window ═══ Choose this if you wish to hide the window of the currently active terminal session. ═══ 29.7. Help for Close Window ═══ Choose this if you wish to close the window of the currently active terminal session. ═══ 29.8. Help for Window List ═══ Choose this if you wish to see a list of active programs. This has the same effect as pressing Ctrl-Esc. ═══ 30. Help for Buffered Chat Mode ═══ Choose this if you wish to buffer the current chat session. In an unbuffered session, all typed characters are sent immediately to the modem; in a buffered session, typed characters are not sent to the modem until a carriage return is entered. ═══ 31. Help for Switch to Main Window ═══ Choose this if you wish to switch from the Chat window to the Main window of the currently active terminal session. ═══ 32. Help for Refresh Scrollback ═══ Choose this if you wish to Refresh the Scrollback Buffer. ═══ 33. Dialer Help ═══ Help for Dialer ═══ 34. Keys Help ═══ Choose this if you wish to obtain help on the various key assignments in TE/2 Pro!