Note: Information in this document is subject to change without notice. Trademarks Notice YEStation is a registered trademark of Affirmative Computer Products. • ™ YESterm/IP is a trademark of Affirmative Computer Products.
Table of Contents Introduction ...1 About this manual ...1 LBT Installation ...3 Mounting the LBT...3 Connecting the LBT ...5 Power-up and Boot Sequence ...7 The LBT Desktop...9 Taskbar ...11 Application Launcher ...12 Adding and Removing Application Launcher Entries ...12 Main Menu ...13 Working with Application Windows ...14 Switching between Windows ...15 Virtual Desktops...16...
Page 6
Default Session (Session 1)...38 New ...39 RWin Client Settings (RDP) ...39 RWin Sessions...40 RDP Session 1 ...41 New ...42 Set Time ...42 Set Host ...43 Update ...44 Firmware Upgrade Instructions...44 Log in ...46 Log out ...46 Exit ...47 YESterm/IP TN5250E Emulator...49 AS/400 Requirements ...49 Technical Characteristics ...49 Display Session Characteristics ...49...
Page 7
Toolbar ...68 Printer Session...68 Menu Bar...68 File...69 Tools...69 View ...70 Help ...70 Toolbar ...71 How To …...72 Create a Custom Language Code Page ...72 Display Session ...75 Record a Keystroke Sequence (Macro)...75 Play a Recorded Keystroke Sequence (Macro)...76 Create a Custom Keyboard Map ...76 Printer Session...78 Modify the Passthrough Driver ...78 General ...78...
Introduction Welcome to the YEStation Linux Based Terminal User’s Guide describing the Linux Based Terminal (LBT) desktop environment and configuration. The LBT solution provides a seamless ® ® integration of heterogeneous computing environments including Microsoft Windows Terminal ® ® ® Services, Citrix WinFrame and MetaFrame...
LBT Installation Mounting the LBT The LBT can be mounted on a desk or under a table or attached to a wall. The LBT has no internal fan, and relies on natural airflow for cooling. When you mount or place the LBT, make sure to keep as many ventilation holes, as possible, unobstructed.
Connecting the LBT To connect the LBT to your server, please make all connections to the rear panel before turning on the power. The following figure shows the LBT's rear panel connectors. LBT Rear Panel Connectors Page 5...
Page 14
Please follow the procedures below: 1. Connect the monitor to the VGA connector. 2. Connect the PS/2 keyboard to the Keyboard connector. 3. Connect the PS/2 mouse to the Mouse connector. 4. If you are ready to use a network connection, connect a CAT5 UTP cable to the Ethernet connector.
Power-up and Boot Sequence When you first switch on the LBT, a splash screen is displayed while the system performs self-test routines and then loads the operating software from the flash memory. When the boot loader takes over the start-up sequence a corresponding message is shown on the screen: Normally, you will have no need to select a boot option, since the default is a Quiet Boot.
Page 16
When the boot loader takes over the start-up sequence, a corresponding message is shown on the screen: Uncompressing Linux ... OK, booting the kernel Boot loader start-up message You can switch off the LBT any time in any stage since the operating software is stored in a flash memory module and thus protected from data-loss.
The LBT Desktop After power-on, the LBT will first go through several boot sequence procedures. When the operating system is successfully loaded from the flash memory, the desktop is displayed and you can start working. The LBT desktop consists of three areas: •...
Page 18
Start LBT desktop with taskbar and Application Launcher As a default setting, the Application Launcher is paged out of the desktop and “hidden” outside the visible display area. This method is referred to as Smart Mode. Hiding the Application Launcher outside the visible screen provides a greater desktop area for the display of application windows.
Taskbar The taskbar contains the Main menu, the virtual desktop window list, the list of active client windows and a clock. Click on Start to open the Main menu and select an application from the list. Click on the window symbol to show a list of virtual desktops and the active windows on these desktops.
Application Launcher The Application Launcher is used as a quick access to applications that are frequently used. It can be adjusted to your requirements by adding or removing items from it. Simply click on an icon with the left mouse button to start the associated application. By default, the Application Launcher is in Smart Mode at the right edge of the screen, and thus hidden until you move the mouse pointer towards the edge of the screen.
Main Menu Click on Start in the taskbar or right-click on the desktop area to open the Main menu and select an application from the list. The Main menu usually contains the following entries (depending on actual system configuration): • Setup. Use this application to configure the LBT device and the LBT desktop.
Working with Application Windows Working with application windows on a Linux desktop is very similar to windows manipulation on a Windows desktop. The major difference is the use of Virtual Desktops in Linux and the Stick option for each window. To manipulate a window’s position and/or size, the following functions are available: •...
You can also right-click on the window’s titlebar or the placeholder in the taskbar to display the window menu. Switching between Windows You can have several windows open at the same time. To change between these windows simply: • Press and hold down the Ctrl key and then press the Tab key to toggle through active windows, •...
Virtual Desktops Up to ten desktops can be configured in Setup extending the display area. Start Virtual desktops window list You can easily switch between desktops by clicking on the window list button of the taskbar or press Ctrl - Alt - → to toggle forward or Ctrl - Alt - ← to toggle backwards through the desktops one by one, or click on the “Window list”...
How to get started Here are a few tips to get you up and running: • To start an application, click on the Start button on the taskbar panel and choose an entry from the list or sub-menus. • Click on an icon in the Application Launcher to start the corresponding application. •...
Client Applications This section describes the built-in client applications on the LBT: • Local Shell • Citrix ICA Client • RDP Client Local Shell Select “Local Shell” to open a window providing a bash shell (Bourne Again Shell) on the local host: Local shell The following commands are built into the operating system by default and can be used in the local...
Citrix ICA Client Select from up to three predefined ICA client sessions. The LBT will then connect to the selected server and initiate the login sequence: Citrix ICA client user logon screen After you have successfully logged on to a server running Citrix software, the remote session is displayed in the pre-configured window state (full screen or selected window size), and the remote host desktop is shown in the client window.
RDP Client Select from up to three predefined RDP client sessions. The LBT will then connect to the selected server and initiate the login sequence: RDP client user logon screen After a successful log-on to the terminal server, the remote session is started and displayed in the configured window state (full screen or selected window size), and the remote host desktop is displayed in the client window (see example below).
LBT Setup After bootup, the LBT comes up in Linux desktop mode, with a blank desktop except for the Task Bar at the bottom and the Start button in the lower left corner. If you move the cursor to the far right, a Launch Bar will appear.
System Information Click on this and you will see a lot of esoteric information, most of which is of interest only to a Linuxphile. But scroll down to IFCONFIG, using the keyboard arrow keys, and you will see the LBT IP address, the MAC hardware address, the subnet mask, and the Broadcast IP address. You can only look;...
Parameters Most of the Setup changes you make will be made from this section. Show Parameters Window. Initially, you must be logged in as “ root ” to make any changes. If you did not log in previously, a login screen is displayed the first time you select a parameter. Leave the password blank. Later, you can change user name and password if you wish.
To save your changes, you must back up through all the menus until you are asked if you want to Apply changes . If you exit the menu sub-windows in any other way, you will lose all the changes you have made since your last save. If you reply Yes to the Apply changes question, the configuration file will be updated in the system’s writeable file system, and the device will either restart the window manager or perform a full system reboot for your changes to take effect.
Hardware Window Language The first Language window shows the current selected language. Language Window If you wish to change the language, you will be given the choices of English, German, or Italian. Page 27...
Language Choices Window System Update If you want to use FTP to update your firmware, you must first enter the FTP server parameters here. System Update Window Page 28...
• FTP Server. Enter the IP address of the FTP server providing the update files. • Directory Path. Your entry here depends upon the specifics of your FTP server software. If the path to the upgrade files is completely defined in the server’s FTP software configuration, this field will be left blank.
Network This is used to specify the network parameters for the LBT. Network Window Network Don’t let the double use of the term “Network” confuse you. Click on the second Network to specify your DNS server IP address and select DHCP. Be sure that Activate is set to no in the Ethernet sub-window.
• Default Nameserver. Click here to enter your DNS server IP address. You must have an entry here if you wish to use the Netscape browser with “friendly” URLs. Without a DNS server specification, you could only browse web sites for which you had the actual IP address. •...
Printer When using a local printer on the LBT, only LPD/LPR printing on LPT1 is supported. The COM ports are not supported for local printing, except when printing from the YES term /IP printer emulator. Printer Window Port 9100 Daemon Leave the values in this window at default.
LP Daemon Leave the values in this window at default. LP Daemon Window To use this local printer, set it up as a local printer on your server. For instance, on a Windows server, you would execute the following steps: 1.
Display This configuration path sets the display parameters for the LBT desktop. Display Window General All the display parameters except resolution settings are configured here. We show two windows here because the window must be scrolled to see all the parameters. General Window (Scrolled Up) Page 34...
Page 43
• Smartmode. Select Yes to hide the Task bar off the bottom edge of the desktop. • Launcerbar. Select No if you do not want a Launcherbar. • Smartmode. Select No to hide the Launcherbar off the edge of the desktop. •...
Resolution Display Resolution Window • Color depth. Select 8 for 8-bit color or 16 for 16-bit color. • Resolution. Select one of four resolutions from 640x480 to 1280x1024. Applications Here you configure parameters for all your Windows sessions. You can have up to three Citrix ICA sessions and/or up to three Microsoft RDP sessions.
ICA6 Client Settings In these screens, you set global ICA session parameters as well as individual parameters for each session. You can configure up to three Citrix Independent Computing Architecture (ICA) channels to access servers running Citrix WinFrame or Citrix MetaFrame. These items are displayed in the “Citrix ICA Client”...
• ICA sessions. Select this parameter to add sessions and configure individual parameters for each session. See below for details about these individual windows. • Windows Warningsounds. Enable or disable Windows warning sounds. • Autoupdate client. Enable or disable automatic update of the ICA client firmware, if your server is set up to do this.
• Session Server. If you identified the Master Browser server in Server, you can put the name of the desired Citrix server here. If not, enter the IP address of the desired Citrix server. • Compression. Activate or deactivate data compression over the network. •...
RWin Client Settings Window • RWin sessions. This is a rather redundant screen. Select the only selection to get to the next screen. RWin Sessions Select the RDP session that you wish to configure, or add a new one. RWin Sessions Window Page 40...
• RDP Session 1. This is the default session. Make this selection to configure your first RDP session. • New. Make this selection to configure additional RDP sessions. RDP Session 1 Configure the default RDP session from this screen. RDP Session 1 Window (Scrolled Up) RDP Session 1 Window (Scrolled Down) Page 41...
• Session Name. Enter a descriptive name for the session. This string is used to identify the session in the Main menu and the Application Launcher, if applicable. Please do not use special characters for the descriptive session title. • Session Server. Enter the IP address of the desired Terminal Server here. •...
The Linux Based Terminal is upgraded using the FTP process. This process requires an FTP server accessible via TCP/IP from the terminal. The upgrade steps are: 1. Download the latest-version firmware from the Affirmative Computer Products web site, per the Affirmative Computer Products Technical Support instructions.
Page 53
28. Enter your FTP logon password. Even if you do not require a password at the server, type something in this field anyway. The Setup software does not like a blank field here. 29. Tab to OK and press Enter. 30.
Log in Log in as an authorized user. Currently only “root” is authorized to make changes to the system configuration. If no login is performed, the user is defaulted as “nobody” and can only display parameter settings. Log In Window Log out Use this function to log out.
Exit Exit Setup and restart the window manager. If the desktop cannot be displayed on the monitor attached (e.g. unsupported frequency setting) or the LBT fails to boot properly due to configuration problems, use the Setup boot option in the boot menu to start Setup in text mode.
• OS/400 V3R2 with appropriate PTFs or higher Technical Characteristics YES term /IP Emulator is one of the YES term 5250 TCP/IP solutions developed by Affirmative Computer Products. YES term /IP is a powerful Telnet TN5250e emulator that provides Windows Based Terminal users with the capability to connect to an AS/400 via the TCP/IP protocol.
Setup The LBT is pre-configured with four 5250 display sessions (Display 1-4) and three 5250 printer sessions (Printer 1-3). The first time that you open one of the sessions, you will be faced with a blank 5250 window and a small sub-window asking for the setup password. The default password is no password, so just click on OK to open a new sub-window that allows configuration of session properties.
Keyboard Map. See: • 101 PC. Choose this type if you are using a standard PC keyboard. • 101 Terminal. Choose this type if you are using an Affirmative Computer Products 101-key 5250/PC keyboard. • 122 Keys. Choose this type if you are using an Affirmative Computer Products 122-key 5250/PC keyboard.
• Keyboard in accordance with the keyboard map, typically the Print (not PrtSc ) key. • Key Pad, if it contains a corresponding button. Cursor. Select the type of cursor you want to use • • Euro Support. When this option is enabled, you can display the Euro symbol when you press Alt+E .
appears on the screen. You will see a preview of the “new look” in the Sample field. Be careful with the colors you choose; a wrong choice can cause text or fields to be invisible on the screen because of lack of color contrast. •...
Page 63
A Hot Spot is an area of the session window on which you can double-click the left mouse button to execute a command or function. Actually, a Hot Spot is the result of a text search by the emulator for the specified Keyword on the screen. The Function Key and Numeric fields (from 1 to 99 followed by a "period"...
there is a word “More” to the left of that column, it will not be defined as a Keyword or Hot Spot. 7. In c.132, specify where, in a 132-column screen, the text search engine should start looking for the specified Keyword. 8.
Page 65
To Edit a Key Pad button: 1. Select the button you want to modify. 2. Click on Edit. 3. If you want to send a Text String to the host every time you click on the Hot Spot, type it into the Text String field.
14. Click on Accept. 15. When you have made all your configuration changes, click on Apply or OK. NOTE: If you click on the Default button, you will lose all changes and added buttons that you have previously made. Sign On The Sign On feature of the emulator uses the "Enhanced Display Auto-Signon and Password Encryption"...
Printer Session Properties In a 5250 printer session window, you will see the “Printer Session Properties” sub-window showing five tabs. Click on a tab to bring up the corresponding properties sheet. At the bottom of the sub-window are four buttons. Ignore the Help button; it won’t help you. After you have entered all of your configuration properties in all six sheets, click on either OK or Apply ;...
Input The Input Tab allows you to define specific parameters that will modify the printer data stream from the host to affect the appearance of the printed page. Language • Host Code Page. YES term /IP supports numerous Language Code Pages. The Code Page selected here from the drop-down list should be the same one configured on the AS/400 for this specific device.
Furthermore, depending upon the type of printer you are using, the performance can dramatically slow down. The Passthrough Drivers used here, specifically developed by Affirmative, generate a standard text data stream. This means that everything is sent to the printer in text mode allowing better control of the printer and better performance.
Hex Pass Through (HPT) Hex Pass Through allows portions of a data stream to be sent directly from the host to the printer. There is no modification done to these portions by the emulator driver. In order for the emulator to recognize these inviolate data stream portions, they must be identified at the beginning and end by escape sequences –...
Advanced The Advanced Tab allows you to set default message parameters and enable the Host Transform feature. Advanced Sheet Default Message Parameters You can set the following Default options: • Message Queue Name. Default is QSYSOPR . • Message Queue Library. Default is *LIBL . •...
Emulator Operation Display Session Here is a typical display session Sign-On screen. The Menu bar, Tool bar, and Status bar will be identical for all display session screens. Display Session Sign-On Screen Menu Bar Menu bar commands of the Display Session window consist of commands and functions that are unique for each window (session).
File Administrator. This selection is not used in the LBT. • • Connect. A display session typically comes up in the connected state. But if, for some reason, the session is not connected, this command will attempt to connect the Display Session to the host.
Tools Tools commands allow you to work with the Record/Playback function. If you regularly do the same things when you work with a host system, it is convenient to record the keystrokes you make and have YES term /IP play them back when you want to do the same job again. Record/Playback allows you to do this.
View Commands in the View menu are used to manipulate the display emulator window • Toolbar. This toggle command hides or displays the Toolbar near the top of the screen, just below the Menu bar. When the command is checked, the Toolbar is displayed. Status Bar.
Toolbar The Toolbar is displayed across the top of the application window just below the Menu bar. The Toolbar provides quick access to commands you use on a regular basis, but if you do not need it, you can hide it and the Menu bar to increase the size of your display window. When the Toolbar is displayed, a check mark appears next to the Toolbar command on the View menu.
File • Administrator. Not used in the LBT. • Connect. A printer session typically comes up in the connected state. But if, for some reason, the session is not connected, this command will attempt to connect the Printer Session to the host.
• Playback Trace. This command allows you to play a pre-recorded trace. Note: This command is for diagnostic purpose only. • Clear Document List. This command will clear the Document List. The Document List contains a history of all printed documents. •...
Toolbar The Toolbar is displayed across the top of the printer application window below the Menu bar. The Toolbar provides quick access to commands you use on a regular basis. Printer Session Toolbar Place the cursor over a Toolbar button to see its command equivalent. From left to right, the command/button definitions are: •...
How To …. This section provides detailed instructions for executing the custom configuration options that are available for the YES term /IP emulator sessions. Create a Custom Language Code Page This procedure is the same for either a display or a printer session. To do this, select one of the available Code Pages (the one that comes closest to the one you want to create) and click on Edit .
Display Session This section provides detailed instructions for executing the custom configuration options that are unique to the YES term /IP display emulator sessions Record a Keystroke Sequence (Macro) If you regularly do the same things when you work with a host system, it is convenient to record the keystrokes you make and have YES term /IP play them back when you want to do the same job again.
Play a Recorded Keystroke Sequence (Macro) In order to play a recorded keystroke sequence, you have to: 1. Place the cursor on the screen where you want to play the sequence. 2. Click on Tools from the Menu bar, or the Play icon, or the Play button on the keyboard Select the sequence from the prompted list of stored sequences.
Page 85
You can select the action you want to associate to the selected key from among the following options: • No operation . No action will be performed when you press the key. • Command . Choose the desired 5250 command function from the drop-down list. •...
Printer Session This section provides detailed instructions for executing the custom configuration options that are unique to the YES term /IP printer emulator sessions. Modify the Passthrough Driver Any Passthrough Driver in the drop-down list can be customized, and it is also possible to create a new Driver.
Transcode Table • Code Page. Select a code page from the drop-down list. • Edit Code Page. If you want, you can also edit the Code Page by clicking on Edit Code Page . How To…|Create a Custom Language Code Page •...
Escape Sequences Escape Sequences Sheet This tab allows you to customize all the Escape commands used to perform specific functions. Select a function, click on Edit , and an Escape Sequence Edit sub-window will appear. Make your changes there. Euro Euro Sheet Page 80...
This tab allows you to customize the Escape sequence used to print the Euro symbol. This special function allows you to print the Euro symbol even on those printers that are not Euro ready. Select the symbol you wish to customize, then click on Edit , and a Euro Sequence Edit screen will appear where you can enter the new values.
Affirmative Computer Products offers Technical Support services for all the Affirmative products. You can access Affirmative Technical Support in one of the following ways: • via Phone o 480-946-1444 o 888-353-5250 • via Fax o 480-946-9250 • via E-mail o support@affirmative.net...
Need help?
Do you have a question about the 2614 and is the answer not in the manual?
Questions and answers