IBM TN5250 manual

TN5250 T erminal Emulation User’ s Guide[...]

TN5250 T erminal Em ulation User’ s Guide[...]

Contents Over view Introductio n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v About Th is Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v About TN 5250 Terminal Emulation . . . . . . . . . . . . . . . . . . . . . . . . . . . v Product Feat ures . . . . . . . . [...]

ii Content s Edit Key Conflict Me nu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15 Help Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16 3 Terminal Keyboard Keyboard L ayouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 5250 Key board . [...]

Content s iii 2-9 Edit Keys Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13 2-10 Auto Key Entry Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14 2-11 Edit Key Conflict Me nu . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15 2-12 Main Menu - TN5250 - Help . . . . . . . . . . . . . . . . . . .[...]

Copyright Notice © 1998 ALL RI GHTS RESER VED. This manual and the software and firmw are described in it are copyrigh ted. Y ou may no t repr oduce, transmi t, transcr ibe, store in a retr ie v al system , or translate into any language or co mputer language, in any fo rm or by an y means, electronic, mechanical, magnetic, op tical, chemical, man[...]

Control No . 075B Licens e Agreement Y OU SHOULD CAREFUL L Y READ THE FOLLOWING TERMS AND CONDITIONS BEFORE USIN G T HI S SO FT W ARE (T OG ET HE R WI TH ANY S U PPL IE D D OCU MEN T A TION, HE R EA FTER “SOF TW ARE”), WHICH I S CO PYRIGH TED BY LICENS OR. USING THIS SOFTW ARE INDI CA TES Y OUR A CCEPT ANCE OF THE FOLLO WING TER MS AN D CO NDIT[...]

Over vie w Introduction The TN5 250 T erminal Emulation User’ s Guide , e xplains how to conf igure and use the TN52 50 emulat ion on your terminal. This emulat ion is an optio n for terminals. About This Guide This guide is o rganized into three ch apters and two appendixes: ◆ Chapter 1, “Getting S tarted,” explains TN5250 terminal emulati[...]

vi Overv iew The TN5250 Connection T o oper ate TN525 0 emulation, y ou must connect to an AS/ 400 serv er operating with OS/4 00 V ersion 1, release level 3.0 or higher . Addi tionally , you must be operating the emulator acro ss a TCP/IP network, using an IBM 82 09 or equi valent TCP/IP at tachment. Wh en you use TN5250 term inal emulat ion, you [...]

Over view vii Command and Ke y Sequence Form at T able 2 lists the command and key sequence formats used in th is guide. T able 2 Command and Ke y Sequence Format Con ventions Con vention Description command < xxx > Command fo rmat. The right and left angle brack ets indicate the bound aries of the parameter list. Alt + x or Alt + X Ke y sequ[...]

1 Getting Star ted This chapter disc us ses how to initiate TN5250 terminal emulation an d e xplains: ◆ Do wnloading th e TN5250 terminal em ulation o ption. ◆ Defi ning and using TN525 0 connection s. ◆ Opening and e xiting ses sio ns . Read this chapter caref ully before attempting to connect to a TN525 0 server . Do wnloading TN5250 Option[...]

1-2 Chapter 1 Y ou will connect to th e host you specified in the conn ectio n definition selected. Connection def initions appearing in the Connecti ons list can be edited. T o edit: 1 Select the connection that you w ant to edit from th e Connection s list. 2 Click o n th e Setup comm a nd bu tton in th e Conn ections di alog box. 3 Click o n th [...]

Getting Sta rted 1-3 6 Enter a serv er name and an y command option s (see T able 1-1 , TN5250 Comm a nd Opt i on s), in t he Server Name entry field. ❖ Note The port command option (for e xample 5250 ) should b e includ ed in the server name entry . ❖ Note If the TN5250 term inal type is grayed out, check with your Administ rator to see if the[...]

1-4 Chapter 1 ❖ Note The def ault command option s are: ◆ Host Name: OCS_Gateway . ◆ Port Number: 2 3 . ❖ Note Press ing F4 when th e cursor i s positi oned nex t to an y f ield li sted in T able 1-1 displays a list of choices for that fun ction. Sessions If you co nnect to a TN52 50 serv er using a d efin ition that contains an IP address,[...]

Getting Sta rted 1-5 Emulator -Opened Sessions If you hav e specified an IP address in your conn ectio n definition, then once connected the Pass Th rough Screen displays (s ee Fig ure 1-2 ). Figure 1-2 P ass Through Screen An initial session has been opened by the emulator . From the Pass Throu gh Screen , press Ctrl (right ) to go to the first op[...]

1-6 Chapter 1 3 In th e Open Session menu with the Ta b key select: a Session: E nter a name for you r session. b Host Name : (skip ping Au to S tart ) Enter the address of the serv er . c Port Numb er: Specify 23 or other appropriate nu mber . 4 Skip IBM T erminal T ype , and press Ctrl . Y our initial ses sion will be o pened . ❖ Note The maxi [...]

2 The Menu System The TN5250 menu syst em is used to: ◆ Contr ol se ssions ◆ In voke utility functions ◆ Map ke yboards Additionally , the TN5250 menu system inclu des a help section. The help section is discussed in Help Menu at the end of this c hapter , and pr esents additional informati on about emu lator menus and functi ons. Main Menu F[...]

2-2 Chapter 2 Figure 2-1 Main Menu - Emulator -Opened Sessions Figure 2-2 Main Menu - User-Opened Sessions Menu Control K e ys Menus are in voked by positioning th e cursor next to a menu selection , then pressing the Ctrl key . Menu functions are selected by using a combination o f control k eys and alph anumeric ke ys (ke y sequences). The co ntr[...]

The Menu System 2-3 The ke ys that appe ar at the bottom of each menu allow y ou to na vigate through th e menus. These are menu co ntrol ke ys, and are described in T able 2 -1. Sessions Menu Depending on the w ay you conf igure your con nection, on e of two sessions ’ menus d isplays: ◆ If you c onnect t o a serv er us in g a n IP addres s , [...]

2-4 Chapter 2 Inv oke the Sessions menu by: 1 Position the cu rsor next to Sessions . 2 Press Ctrl (right). The Sessions menu displays . Figure 2- 3 sho ws the Session s menu. The menu displays a l ist of pree xisting connection d efinitions. Figure 2-3 Sess ions Menu The functi ons displayed in this men u are numbered 1 through 6 . T o use: 1 Posi[...]

The Menu System 2-5 T able 2 -2 describes the function s in the Sessions m enu. Open Session Menu This me nu display s only in a user -opene d session. It is us ed for creati ng ne w sessio ns.Y ou in voke the Open Session men u by: 1 Position the cu rsor next to Open Sessio n in the main menu. 2 Press Ctrl (right) Figure 2- 4 sho ws the Open Sessi[...]

2-6 Chapter 2 Figure 2-4 Open Session Menu The paramet ers displayed in this menu appear as dat a entry f ields. T o use these fields: 1 Position the cursor to the lef t of each f ield in the menu, and en ter the appropriate data. 2 Press F6 to save your data and exit the menu . T able 2 -3 describes the data field s in the Open Session m enu. T ab[...]

The Menu System 2-7 ❖ Note For t he Session, Auto Start, Host Name, and IB M T er minal T ype dat a fields, u ser-selectable lists are a v ailable. T o in v oke a list, position the cursor at the appropria te fi eld , then press F4 . About TN5250 Menu The Abou t TN5250 menu dis plays the r elease inform ation f or your t erminal emulator software[...]

2-8 Chapter 2 Utili tie s Me nu The Utiliti es menu dis plays the Set Loc al Pa ramet ers function. In voke this menu b y: 1 Position the cu rsor next to Utilit ies in th e Main menu. 2 Press Ctrl (rig ht). Figure 2- 6 sho ws the Util ities menu. Figure 2-6 Utilities Me nu Set Local Parameters lets yo u control som e add itional local te rmin al fe[...]

The Menu System 2-9 Remapping Local Pa ra m et e r K ey s The key seq uence s listed in T abl e 2 -4 can be re m apped by: 1 Position the cursor at the ke y sequence yo u want to remap . 2 Press the F4 key to display th e av ailable key sequences. 3 Position t he cursor at the ke y sequence yo u want, and press Ctrl ( right). The Set Local Paramete[...]

2-10 Chapter 2 Screen Attr ib utes Menu The terminal emulator will di splay IBM TN5250-style screen attributes, depending on th e local terminal type setting and application that you are using. The Screen Attributes men u display s these TN5250-st yle attrib utes. Inv oke the menu by: 1 Position the cu rsor next to Screen Attributes in th e Main me[...]

The Menu System 2-11 K eyboar d Mapping Menu Y ou can vie w y our emu lator’ s cur rent k e y map ping s (sequen ces) b y accessing the Keyboard Mapping menu. Inv oke this menu by: 1 Position the cu rsor next to Keyboa rd Mapping in the Main me nu . 2 Press Ctrl (right). Figure 2- 8 sho ws the Keyb oard Mappin g menu. Figure 2-8 Ke yboard Mapping[...]

2-12 Chapter 2 T able 2 -5 describes the function s of the Keyboard Mappin g men u. T able 2-5 K eyboard Mapping Functions Function Description Host Functi on Keys Lists the host sy stem contro l keys. Cursor Co ntrol K eys Lists the key s that control cursor mo vement. Screen Control Keys Lists the keys that contro l the terminal screen. Local Fun[...]

The Menu System 2-13 Edit K eys Menu Keys can be ed ited or c hange d by using the F2 key , entered in the Keyboar d Mapping menu. Posi tion the cursor next to the key you want to edit, in any of the k ey mapp ing me nus, and pr ess F2 . This key inv okes the Edit Keys menu. W ith thi s menu, you can change or rem ap an y of the emul ator ke ys dis[...]

2-14 Chapter 2 A uto Ke y Entr y Menu Ke y sequences can be entered automa tically . T o do this, enter the Auto Key Entr y mode b y pressi ng F2 in the Edit Keys men u. The Auto Key Entry menu appears. F igure 2- 10 sho ws th e Auto Key Entry menu. Figure 2-10 Auto Key Entry Menu T o use this menu: 1 Position the cu rsor next to the key you want t[...]

The Menu System 2-15 Edit Ke y Conflict Menu If you attempt to map two functions to th e sam e key , the Edit Key Confl ict menu appears. See Figure 2- 11. Figure 2-11 Edit Ke y Conflict Menu The Edit K ey Conflict m enu disp lays bot h the ke y function that yo u are attempting to map, an d the ke y that is curre ntly mapped to the k ey sequence. [...]

2-16 Chapter 2 Help Menu The Help menu can b e in voked from a ll to p level and second ary me nus by press ing F1 . Figure 2-12 sho ws the Mai n Menu - TN5 250 - He lp menu. Figu re 2- 12 Main Men u - TN 5 250 - Help ❖ Note The me nu displa yed in F i gu re 2-1 2 is the first pa g e of He lp . Thre e more pages follo w , and are accessed b y the[...]

3 T erminal K e yboar d The TN5250 emulation automatically r emaps the term inal ke yboard t o the IBM 5250 terminal functionali ty . “T erminal Keyboard” discusses: ◆ The dif ferences between the I BM 5250 ke yboar d and your terminal’ s ke yboard. ◆ T erminal ke yboard f eatures. K e yboar d La y outs This sect ion compares the layo ut [...]

3-2 Chapter 3 T erminal Keyboard Figure 3- 2 sho ws the terminal k e yboard lay out. Figure 3-2 T erminal Keyboar d La y out Key s The following section comp ares the TN5250 ke y def initions with the terminal key definition s. TN5250 Key Definitions The IBM 525 0 ke yboard k ey def init ions (refer t o Figure 3-1 ) are listed i n T able 3-1. The p[...]

Terminal K eyboard 3-3 Delete Deletes a character where the cursor is positio ned. Double Speed Left Moves cursor four positions to the left. Double Speed Right Moves cursor four positions to the right . Dup Duplicates the last fi eld. Enter Executes commands, o r accepts data and/or selected options currently on the screen. Er Inp Clears all modif[...]

3-4 Chapter 3 ❖ Note F or a more detai led des cri pti on about IB M 5250 ke ys, refer t o the IBM 5250 Inf ormatio n Display S ystem Funct ions Refer ence Manual. Host Function Ke ys T able 3-2 list s the host function k e ys and your terminal ’ s equi v alent ke y o r ke y sequence. See “K e yboard Mapping” in the TN5250 main menu (discus[...]

Terminal K eyboard 3-5 Cmd8 F8 none Cmd9 F9 none Cmd10 F10 none Cmd11 F11 none Cmd12 F12 none Cmd13 (shift) F1 no ne Cmd14 (shift) F2 no ne Cmd15 (shift) F3 no ne Cmd16 (shift) F4 no ne Cmd17 (shift) F5 no ne Cmd18 (shift) F6 no ne Cmd19 (shift) F7 no ne Cmd20 (shift) F8 no ne Cmd21 (shift) F9 no ne Cmd22 (shift) F10 no ne Cmd23 (shift) F11 no ne C[...]

3-6 Chapter 3 Cursor Contr ol Ke ys T able 3-3 lists the TN5250 cur sor control k e ys and your terminal’ s equi v alent cursor co ntrol k ey or ke y sequence. See “K eyboard Mappi ng” in the TN525 0 main menu (d iscussed in Chapter 2) for further infor mation. Screen Control K eys T able 3- 4 lists t he TN525 0 scr een control k e ys and yo [...]

Terminal K eyboard 3-7 Local Function Ke ys T able 3 -5 lis ts th e IBM 5250 ses sion ke ys, and your termi nal emul ation’ s equi v alent k ey . See “K e yboard Mappi ng” in the T N5250 main menu (discussed in Chapter 2) for further details . For war d T a b Ta b none Insert Inser t (key pad) Ins Roll Down Pg Up (ke ypad) PgUp Roll Up Pg Dn [...]

3-8 Chapter 3 T ext Assist Keys T able 3 -6 lis ts th e TN5250 te xt as sist ke ys and y our te rminal’ s equi v alent k e y sequence. See “K e yboard Mapping” in the TN5250 main menu (discussed in Chapter 2) for further details. T able 3-6 T ext Assi st Keys TN5250 Key T erminal Key(s) Alternate T e rmina l Ke y( s) Cmd A Alt a none Cmd B Al[...]

Terminal K eyboard 3-9 T ypeAhead Buffering Applications such as data processing and word processing programs normally accept ke ystrokes as you enter information. Ho we ver , these applications can lock yo ur k eyb oard when data i s being process ed. When a k ey board l ocks, the II (Input Inhibited) i ndicator appears on the status line ( see Ap[...]

A Err or Messa g es This section describes th e error messages that might di splay on your terminal screen during a TN5250 session. These error messages are grouped into three categories: ◆ T elnet errors ◆ TN5250 intern al errors ◆ Status Li ne errors T elnet Err or s T elnet errors are gen erated by T elnet commu nications software within a[...]

A-2 Appen dix A TN5250 Int ernal Errors T able A- 2 lists TN52 50 internal errors. TELNET : socket connection failed Unable to create a sock et for the TCP/IP client . Possible TCP/IP networ k proble m . See your system administr ator . TELNET : Unable to connect to remo te ho st Unable to make connection to the specifi ed host. Either the suppli e[...]

Error Mes sages A-3 The Status Line The Statu s Line displays real-time system messages that appear during terminal emulation. Th is field r esides at the bottom of your terminal scre en, and cons ists of s ev en se parate sect ions. Fi gure A-1 sho ws the Stat us Line . Figure A-1 Status Line T able A-3 de scribes each section of the Status Li ne [...]

A-4 Appen dix A Status errors and their d escriptions are listed in T able A-4. Refer to the IBM 5394 Remote Contr ol Unit Functions Refer ence Manual for further information. T ab le A-4 S tatus Line Err or s Error Description 0000 Hel p key not allowed Either no system reference code app ears, or the applica tion do es no t supp ort the key yo u [...]

Error Mes sages A-5 0009 Th is field requ ires numeric characters Y ou attempted to enter non-nu meric characters into a field designated nu meric. V alid characters for this fi eld are: ◆ Zero (0) thr ough nine (9 ). ◆ Blank ( ), c omma (,), period (.), plus (+), an d minus (-). ◆ (pad ) 1 key . The (pad) 1 ke y is used to duplicate these ch[...]

A-6 Appen dix A 0019 Dup key not allowed in th is field Y ou pressed the (p ad) 1 key when it is not allowed in this field. 0020 Fun ction Ctrl key inv alid i n this field Y ou pressed a function key that is not allowed in this field. Press an escape key sequen ce (field ke ys) to exit this field, before pressing any mo re function ke ys or key seq[...]

B T r oub leshooting Aids Answer the follo wing questions and r ecord the information bef ore you contact technical support. Th is information can then be used by support engineers, to help you with y our pro blem. Network Inf ormation ◆ Ha ve so ftware or hardware chan ges been made to your net work? ◆ Are you us ing Domain Name Service or a h[...]

Index-1 Index A About t his guid e vi i About TN5250 vii A uto ke y entr y me nu 2-14 C Command op tions 1 -3 Connectio n proper ties dial og bo x 1-2 Connectio ns viii command o ptions 1-3 definitio ns, preexisting 2- 4 new 1-2 preexisting 1 -1 Conv entions vi ii Creating se ss io ns 2-5 Cursor co ntrol ke ys 3-6 D Downloading fir mware 1-1 E Edit[...]

Index-2 open ses sion menu 2-5 screen attributes me nu 2-10 sessio ns me nu 2-3 TN5250 menu 2-7 util ities 2- 8 O Open se ss io n menu 2-5 functions 2-6 P P ass through scr een 1- 5 R Remapping local pa rameter keys 2-9 Requirem ents viii S Screen attributes me nu 2-10 Screen control ke ys 3-6 Sessio ns 2-3 emulator-ope ned 1-5 ending 1-6 menu 2-3 [...]

883554-0 2 Re v . A J une 199 8 Printed in U.S.A.[...]