OS/2 Shareware BBS: 3 Comm

home *** CD-ROM | disk | FTP | other *** search

/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / te2pro20.zip / TE2PRO.INF (.txt) < prev next >

Wrap

OS/2 Help File | 1996-05-31 | 50KB | 1,519 lines

ΓòÉΓòÉΓòÉ 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!