®

PowerTerm® Quick Reference Guide (Linux Edition)

Contents 1 PowerTerm Requirements

1 PowerTerm Requirements • Red Hat 7.3 and higher, Minimum system requirements Mandrake 9.0 and higher, SuSE to run PowerTerm. and higher, and Xandros 2.0 and higher. These distributions have 2 Installation been officially tested by Ericom How to install PowerTerm. Software. However, PowerTerm 3 Connection Requirements may run on other Linux What you must know before you distributions as well. make a connection. • 386 data processor or higher. 4 Quick Start • Connection to a host computer. The ‘quick’ way to make a • 4.3 MB free on your hard disk. connection. 5 PowerTerm at a Glance 2 Installation A look at the PowerTerm window. Access the Linux installation zip 6 Customization file from either the Emulation CD Programming keyboard and or from the Ericom Software Soft keys. evaluation page: 7 Slave Printing www.ericom.com/ptsoftware.asp Description and supported Select PowerTerm InterConnect emulations with their Linux Edition. corresponding sequences. 1. Log on as root. 8 Print Screen & Auto Print 2. Extract the zip file Brief description and how to use. (e.g. demo installation – 9 Advanced Printing PowerTermInstEval.zip) to an instal- 5250 and non-5250 parameters’ lation directory of your choice. description and setup. 3. Switch to your installation 10 Saving Terminal Settings directory. How to save your settings and 4. Run, at the shell prompt, start a session with your selected ./ptDDmmYY.sh (where settings. DDmmYY is the build date). 11 Providing Support The Installation Wizard will start. 5. Follow the instructions.

www.ericom.com 1 [email protected] 3 Connection Requirements 6 Customization

In order to make a connection, you Key mapping must know the following: Select; or ...Click on: 1. Type of emulation needed in order to connect to the host. 2. Method of communication: Restore default • TCP/IP Terminal keyboard keyboard mapping • Modem/direct serial (must have a modem installed or a direct connection to the host).

4 Quick Start 1. Launch PowerTerm. 2. Click Communication | Connect. 3. In the Connect dialog, set the Terminal Type (emulation). Desktop keyboard Waste basket 4. Set the Terminal ID, if necessary. Two ways to map keys: 5. Select the appropriate Session • Drag and drop – With your Type. mouse, drag the key to be moved 6. Fill in the appropriate parameter to the new desired location. fields. • Right-click Enter Script 7. Click Connect. Command on a desktop key to program a ‘complex’ key mapping. 5 PowerTerm at a Glance Examples: Menu options Toolbar Emulation screen send 23~ send ‘abc123’ send \x7f (mapping hex) key f1 do {send 23~} key numpad1 do {send ‘abc123’} key delete do {send \x7f} Soft keys • Right-click the Soft key button Soft keys Status bar History scroll bar that you want to program. • Enter its description (the new

www.ericom.com 2 [email protected] name that will appear on the If you have problems printing, check button). under Terminal | Setup | Printer tab to be • Enter the script command to be sure that ‘Print Device’ is correct: run by this button. • Click OK.

7 Slave Printing

Slave Printing means an automatic 9 Advanced Printing routing of an input data stream, such as a report, to the Linux’s printer port. To use this facility it is necessary to precede the data stream with an escape sequence, and to terminate the data stream with an escape sequence. For VT and SCO: • enable: [5l • disable: [4l Advanced Printing For Wyse 50/60: How to define printing • enable: R parameters • disable: T In Text Mode: This is designated in the Printer tab by setting the 8 Print Screen & Auto Print two data conversion combo Print boxes (Print Screen and Slave Screen Printer) to None. Prints the selected text or the entire contents of the work area (works for all terminal types). In Text mode, the LPI, CPI, Start/Stop & Fonts are functional, while the Auto Print Printer Rows & Printer Columns are Accumulates incoming non-functional. data while it is displayed (works only with non-IBM terminal types).

www.ericom.com 3 [email protected] In Graphics Mode: This is designated 4. Select the paper size from the in the Printer tab by setting the Drawer 1 dropdown list. two data conversion combo boxes 5. Select the paper size from the (Print Screen and Slave Printer) to Drawer 2 dropdown list. Graphics. 6. Select the paper size from the Envelope Hopper dropdown list. 7. Specify whether the printer has 899 installed in the Supports ASCII Code-Page 899 In Graphics mode the LPI, CPI, & field, if appropriate. Fonts are not functional, while the Printer Rows and Printer Columns Special notes about the fields are functional. selection areas: Advanced Printing – How to Enable Host Printer Transform define AS/400 Host Print (5250 Printer only): Transform settings (5250 Printer) Enables the host to send printer specific format commands to the emulation. If disabled, the host sends general format commands, which the emulation, in turn, translates into printer specific commands. Host Printer Transform is only relevant for non- graphic mode. Printer Type/Model: Specifies the destination printer. The default is ‘HP LaserJet Series II’. If your manufacturer Printer Type/Model are not listed, then choose one that is compatible. 1. In the Advanced Printing Customizing Object: dialog, select Enable Host Print Specifies the object name, which Transform. you have previously defined on the 2. Select the manufacturer printer AS/400. type and model from the Printer Library: Type/Model dropdown list. Specifies the customizing object’s 3. If ‘Other Printer’ is selected for library on the AS/400. The above Printer Type/Model, specify the: fields are applicable when you first • Customizing Object define a customizing object for your • Customizing Object’s Library printer on the AS/400.

www.ericom.com 4 [email protected] Select ‘Other Printer’ from the • Save Terminal Setup – This stores Printer Type/Model dropdown your settings to the PowerTerm list and the Customizing Object default profile. These settings will and Library fields become be used at the initial start of enabled. PowerTerm. Drawer 1: • Save Terminal Setup As – This allows you to create multiple setup Specifies the size for the paper in files in cases where you have Paper Source 1. The default multiple hosts to connect to and depends on what you choose for are in need of different settings. the Printer Type/Model. To start a session with stored Drawer 2: parameters: Specifies the size for the paper in 1. Start PowerTerm and select Paper Source 2. The default Communication | Connect. depends on what you choose for the Printer Type/Model. 2. Select your Terminal Type. 3. Select Terminal ID, if necessary. Envelope Hopper: 4. Select your Session Type. Specifies the size of the envelope. The default depends on what you 5. Fill out the necessary parameters. choose for the Printer 6. Click the browse button adjacent Type/Model. to the Setup File field. PowerTerm displays the Open Supports ASCII Code-Page 899: File dialog. The list of .pts files Specifies whether the printer has contained in the PowerTerm installed. The directory is shown. default is disabled, as most printers do not have Code Page 899 7. Double-click the file you created. installed. Your recently created file now appears in the Setup File field. Font: 8. Click Save As to save connection Specifies the name of the desired settings in the Sessions List. The font. The default is Courier-10. Save Session dialog appears. 9. Enter a session name for these 10 Saving Terminal Settings settings and click OK. Once you have selected all of your 10. To start the connection, double- settings, i.e. colors, printer click your session in the Sessions selections, emulation type, etc., List. you can save these settings to be used later. Select the File menu, and choose from one of the following options:

www.ericom.com 5 [email protected] 11 Providing Support Press key Appears on the combination Status bar In order for us to provide you with ctrl+shift+s “capture.log with send” the highest level of support, please ctrl+shift+k “capture.log with send supply us with: with keys” • Version of PowerTerm ctrl+shift+t “tcpip.log with send” • Linux operating system Connect to host and arrive at the • Emulation type trouble spot. ctrl+shift+s “capture log end” • Communication type ctrl+shift+t “tcpip.log end” • External software being used that interfaces with PowerTerm 3. Open your PowerTerm settings (e.g. NW SAA, MS SNA) directory (~/.PowerTerm-config- • Describe the problem and how to dir) and email us the following recreate it files: • Attach files if necessary capture.log, tcpip.log setup files: How to create a log file: ptdef.*, ptcomm.ini 1. Open PowerTerm. 2. Perform the following: Contact us: [email protected]

Ericom and PowerTerm are registered trademarks of Ericom Software. All brand and product names mentioned in this document are trademarks of their respective owners.

®

Ericom North America Ericom Europe Ericom International Ericom Software Inc. Ericom Software (UK) Ltd. Ericom Software Ltd. M1033-1.0-211003 231 Herbert Ave., Bldg.#4 11a Victoria Square 8 Hamarpeh Street Closter, NJ 07624 Droitwich, Worcestershire Har Hotzvim Technology Park Tel: +1 201 767 2210 WR9 8DE United Kingdom Jerusalem 91450 Israel Fax: +1 201 767 2205 Tel: +44 (0)1905 777 970 Tel: +972 (0)2 571 4774 Toll Free: 1 888 769 7876 Fax: +44 (0)1905 777 971 Fax: +972 (0)2 571 4737 E-mail: [email protected] E-mail: [email protected] E-mail: [email protected]

www.ericom.com 6 [email protected]