Page 1
5250 Terminal Emulation
PROGRAMMER’S
REFERENCE GUIDE
" " " " " " " " " " " " " " " " " " " " " " " " " " " "
P/N 977-047-039
Revision C
July 1998
Page 2
" NOTICE This publication contains information proprietary to Intermec Technologies Corpo-
ration. It is being supplied to you with the express understanding that the information contained herein is for the benefit of the contracting party only, and
may not be copied, distributed, or displayed to third parties without the express
written consent of Intermec Technologies Corporation, and shall be returned to
Intermec Technologies Corporation upon written request. If a purchase, license, or
nondisclosure agreement has been executed, the terms of that agreement shall
govern this document.
This publication is furnished for information only, and the information in it is
subject to change without notice. Although every effort has been made to provide
complete and accurate information, Intermec Technologies Corporation assumes
no responsibility or liability for any errors or inaccuracies that may appear in this
document.
Disclaimer of Warranties. The sample source code included in this document is
presented for reference only. The code does not necessarily represent complete,
tested programs. The code is provided “AS IS WITH ALL FAULTS.” ALL
WARRANTIES ARE EXPRESSLY DISCLAIMED, INCLUDING THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE.
We welcome your comments concerning this publication. Although every effort has
been made to keep it free of errors, some may occur. When reporting a specific
problem, please describe it briefly and include the book title and part number, as
well as the paragraph or figure number and the page number.
Send your comments to:
Intermec Technologies Corporation
Publications Department
550 Second Street SE
Cedar Rapids, IA 52401
INTERMEC, NORAND, and PEN*KEY are registered trademarks of Intermec
Technologies Corporation.
Ó 1992 Intermec Technologies Corporation. All rights reserved.
This publication is printed on recycled paper.
Acknowledgements
AS/400, OS/400, System/36, and System/38 are trademarks, and IBM is a
registered trademark, of International Business Machines Corporation.
Ethernet is a trademark of Xerox Corporation.
Some material in this programmer’s reference guide reproduced courtesy of IBM.
European Notice
The 902--928 MHz SST (Spread Spectrum Transmission) radio referred to in this
manual is not available for sale or use in Europe (including, but not limited to,
Great Britain, Italy, Germany, France, Spain, Norway, Denmark, Sweden,
Finland, Portugal, and the Benelux countries). Any references in this manual to
902--928 MHz SST, or modules containing 902--928 MHz SST radios, should be
disregarded by users of this product in Europe.
Page 3
CONTENTS
" " " " " " " " " " " " " " " " " " " " " " " " " " " "
SECTION 1
Introduction 1-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Purpose of This Guide 1-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Intended Audience 1-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
What to Read First 1-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Organization of This Guide 1-3. . . . . . . . . . . . . . . . . . . . . . . . . . .
Conventions 1-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
If You Need Help 1-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Related Publications 1-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Wireless Stations 1-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Controllers and Gateways 1-5. . . . . . . . . . . . . . . . . . . . . . . .
Multiple Base Adapter 1-5. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Access Points and Base Radios 1-5. . . . . . . . . . . . . . . . . . . .
Other Publications 1-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Radio Network Description 1-7. . . . . . . . . . . . . . . . . . . . . . . . . . .
Host Computer 1-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Controller 1-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Base Radios 1-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Wireless Stations 1-11.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Types of Radio Networks 1-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
UHF Radio Network 1-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SST Radio Network With Ethernet Backbone 1-13. . . . . . .
Open Wireless LAN 1-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SECTION 2
RT3210 Radio Terminal 2-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Overview 2-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen Size 2-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Character Sizes 2-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5250 Terminal Emulation Programmer’s Reference Guide i
Page 4
CONTENTS "
Screen Modes 2-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Center Cursor Mode 2-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Corner Mode 2-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Page Mode 2-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Lazy Mode 2-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Locked Mode 2-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Annunciators 2-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Keyboard 2-7.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Shift Keys 2-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Alphabetic Keys 2-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Numeric Keys 2-9.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Characters 2-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Function Keys 2-11.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
AID-Generating Keys 2-11.. . . . . . . . . . . . . . . . . . . . . . . . . . .
Cursor Movement Keys 2-13. . . . . . . . . . . . . . . . . . . . . . . . . . .
Field Exit Key 2-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Signal Keys 2-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Control Keys 2-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Host Keys 2-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Other Keys 2-17.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key Ahead 2-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scan Ahead 2-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key Repeat 2-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System Messages 2-20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SECTION 3
RT1100 Radio Terminal 3-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Overview 3-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen Size 3-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen Modes 3-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Center Cursor Mode 3-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Corner Mode 3-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Page Mode 3-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Lazy Mode 3-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Locked Mode 3-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Annunciators 3-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Keyboard 3-5.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Shift Keys 3-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Alphabetic Keys 3-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Numeric Keys 3-8.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ii 5250 Terminal Emulation Programmer’s Reference Guide
Page 5
CONTENTS "
Special Characters 3-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Function Keys 3-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
AID-Generating Keys 3-10.. . . . . . . . . . . . . . . . . . . . . . . . . . .
Cursor Movement Keys 3-12. . . . . . . . . . . . . . . . . . . . . . . . . . .
Field Exit Key 3-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Signal Keys 3-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Control Keys 3-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Host Keys 3-16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Other Keys 3-16.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key Ahead 3-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scan Ahead 3-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System Messages 3-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SECTION 4
RT1700 Radio Terminal 4-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Overview 4-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen Size 4-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen Modes 4-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Center Cursor Mode 4-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Corner Mode 4-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Page Mode 4-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Lazy Mode 4-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Locked Mode 4-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Annunciators 4-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Keyboard 4-6.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
57-Key Keyboard 4-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
37-Key Keyboard 4-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Shift Keys 4-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Alphabetic Keys 4-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Numeric Keys 4-11.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Characters 4-11.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Function Keys 4-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
AID-Generating Keys 4-13.. . . . . . . . . . . . . . . . . . . . . . . . . . .
Cursor Movement 4-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Field Exit 4-16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Signal Keys 4-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Control Keys 4-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Host Keys 4-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5250 Terminal Emulation Programmer’s Reference Guide iii
Page 6
CONTENTS "
Other Keys 4-20.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key Ahead 4-21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scan Ahead 4-21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key Repeat 4-21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System Messages 4-23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SECTION 5
RT5900 Radio Terminal 5-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Overview 5-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen Size 5-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen Modes 5-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Center Cursor Mode 5-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Corner Mode 5-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Page Mode 5-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Lazy Mode 5-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Locked Mode 5-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Annunciators 5-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Keyboard 5-6.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Shift Keys 5-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Alphabetic Keys 5-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Numeric Keys 5-9.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Characters 5-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Function Keys 5-11.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
AID-Generating Keys 5-11.. . . . . . . . . . . . . . . . . . . . . . . . . . .
Cursor Movement Keys 5-13. . . . . . . . . . . . . . . . . . . . . . . . . . .
Field Exit Key 5-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Signal Keys 5-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Control Keys 5-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Host Keys 5-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Other Keys 5-17.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key Ahead 5-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scan Ahead 5-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key Repeat 5-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System Messages 5-20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
iv 5250 Terminal Emulation Programmer’s Reference Guide
Page 7
CONTENTS "
SECTION 6
PEN*KEYR6400 Computer 6-1.. . . . . . . . . . . . . . . . . . . . . . . . . .
Overview 6-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen Size 6-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen Modes 6-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Center Cursor Mode 6-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Corner Mode 6-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Page Mode 6-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Lazy Mode 6-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Locked Mode 6-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Annunciators 6-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Keyboard 6-5.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
51-Key Keyboard 6-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
41-Key Keyboard 6-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Shift Keys 6-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Alphabetic Keys 6-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
51-Key Keyboard 6-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
41-Key Keyboard 6-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Numeric Keys 6-12.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Characters 6-12.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Function Keys 6-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
AID-Generating Keys 6-15.. . . . . . . . . . . . . . . . . . . . . . . . . . .
Cursor Movement 6-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Field Exit 6-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Signal Keys 6-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Control Keys 6-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Host Keys 6-21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Other Keys 6-22.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key Ahead 6-23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scan Ahead 6-23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key Repeat 6-23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System Messages 6-25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SECTION 7
PEN*KEY 6500 Computer 7-1. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Overview 7-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen Size 7-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5250 Terminal Emulation Programmer’s Reference Guide v
Page 8
CONTENTS "
Screen Modes 7-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Center Cursor Mode 7-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Corner Mode 7-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Page Mode 7-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Lazy Mode 7-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Locked Mode 7-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Annunciators 7-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Keyboard 7-5.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Shift Keys 7-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Alphabetic Keys 7-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Numeric Keys 7-8.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Characters 7-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Function Keys 7-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
AID-Generating Keys 7-10.. . . . . . . . . . . . . . . . . . . . . . . . . . .
Cursor Movement 7-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Field Exit Key 7-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Signal Keys 7-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Control Keys 7-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Host Keys 7-16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Other Keys 7-16.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key Ahead 7-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scan Ahead 7-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key Repeat 7-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System Messages 7-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SECTION 8
Display Data Stream 8-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Overview 8-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen Design Aid 8-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Applications 8-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Data Stream Command Structure 8-3. . . . . . . . . . . . . . . . . . . . .
Input Commands 8-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Read Immediate (Immediate) Command 8-4. . . . . . . . . . . .
Read Modified Immediate Alternate Command 8-6. . . . .
Read Input Fields Command 8-7. . . . . . . . . . . . . . . . . . . . . .
Read MDT Fields Command 8-9. . . . . . . . . . . . . . . . . . . . . .
Read MDT Alternate Command 8-11. . . . . . . . . . . . . . . . . . .
Read Screen (Immediate) Command 8-11. . . . . . . . . . . . . . .
Save Screen (Immediate) Command 8-12. . . . . . . . . . . . . . .
vi 5250 Terminal Emulation Programmer’s Reference Guide
Page 9
CONTENTS "
Output Commands 8-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Clear Format Table Command 8-14. . . . . . . . . . . . . . . . . . . . .
Clear Unit Command 8-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restore Screen Command 8-16. . . . . . . . . . . . . . . . . . . . . . . . .
Roll Command 8-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Write Error Code Command 8-19. . . . . . . . . . . . . . . . . . . . . . .
Write to Display (WTD) Command 8-22. . . . . . . . . . . . . . . . .
Orders 8-24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Insert Cursor (IC) Order 8-25. . . . . . . . . . . . . . . . . . . . . . . . . .
Move Cursor (MC) Order 8-26. . . . . . . . . . . . . . . . . . . . . . . . .
Repeat to Address (RA) Order 8-27. . . . . . . . . . . . . . . . . . . . .
Set Buffer Address (SBA) Order 8-28. . . . . . . . . . . . . . . . . . .
Start of Field (SF) Order 8-28. . . . . . . . . . . . . . . . . . . . . . . . . .
Start of Header (SOH) Order 8-38.. . . . . . . . . . . . . . . . . . . . .
Transparent Data (TD) Order 8-40. . . . . . . . . . . . . . . . . . . . .
Asynchronous 5250 Prefixes 8-40. . . . . . . . . . . . . . . . . . . . . . . . . .
System Messages and Parameter Errors 8-41. . . . . . . . . . . . . . .
SECTION 9
Extended Commands 9-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Overview 9-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Transmit and Receive On RS-232 Port (#F) 9-2. . . . . . . . . . . . .
Flow Control 9-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Return AID Key Characters 9-7. . . . . . . . . . . . . . . . . . . . . . .
Return Codes for Transmit and Receive 9-9. . . . . . . . . . . .
Example of Transmit and Receive 9-10. . . . . . . . . . . . . . . . .
Transmit Only On RS-232 Port (#P) 9-11. . . . . . . . . . . . . . . . . . .
Flow Control 9-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Return Codes for Transmit Only 9-14. . . . . . . . . . . . . . . . . . .
Example of Transmit Only 9-16. . . . . . . . . . . . . . . . . . . . . . . .
Receive Only On RS-232 Port (#G) 9-17. . . . . . . . . . . . . . . . . . . .
Return Codes for Receive Only 9-20. . . . . . . . . . . . . . . . . . . .
Example of Receive Only 9-21. . . . . . . . . . . . . . . . . . . . . . . . .
Set Parameters (#H) 9-22. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Return Codes for Set Parameters 9-25. . . . . . . . . . . . . . . . . .
Example of Set Parameters 9-26. . . . . . . . . . . . . . . . . . . . . . .
Return Version (#V) 9-27. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tone (#T) 9-27. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5250 Terminal Emulation Programmer’s Reference Guide vii
Page 10
CONTENTS "
Scan Bar Code Parameters (#S) 9-29. . . . . . . . . . . . . . . . . . . . . . .
Control Character Byte 1 9-30.. . . . . . . . . . . . . . . . . . . . . . . .
Control Character Byte 2 9-31.. . . . . . . . . . . . . . . . . . . . . . . .
Control Character Byte 3 9-32.. . . . . . . . . . . . . . . . . . . . . . . .
Bar Code Length 9-33. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
UPC 9-33. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
EAN Algorithms 9-34. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Code 39 9-35. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Plessey 9-36. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Codabar 9-36. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Code 11 9-37. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Code 93 9-38. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Code 128 9-38. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Straight or Computer Identics 2of5 9-39. . . . . . . . . . . . . . . .
Interleaved 2of5 9-40.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Return Codes for Scan Bar Code Parameters 9-41. . . . . . .
Example of Scan Bar Code Parameters 9-41.. . . . . . . . . . . .
Encoded Code 39 9-43. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Terminating Keys 9-48. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Escape Characters 9-49. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Concatenation 9-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
APPENDIX A
Bar Code Scanning A-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Overview A-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
How to Enable Algorithms A-2. . . . . . . . . . . . . . . . . . . . . . . . . . . .
How Scanning Works A-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Encoded Code 39 Exception A-3. . . . . . . . . . . . . . . . . . . . . .
How Stream Scan Works A-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
How Scan All Fields Works A-5. . . . . . . . . . . . . . . . . . . . . . . . . . .
How to Scan Individual Fields A-5. . . . . . . . . . . . . . . . . . . . . . . .
What Scan Ahead Allows A-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
How the Host Gets Bar Codes A-6.. . . . . . . . . . . . . . . . . . . . . . . .
APPENDIX B
Conversion Tables B-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Decimal to Hexadecimal B-1.. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Binary to EBCDIC B-5.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
viii 5250 Terminal Emulation Programmer’s Reference Guide
Page 11
CONTENTS "
APPENDIX C
System/36 Line Generations C-1. . . . . . . . . . . . . . . . . . . . . . . . .
Overview C-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Line Generations C-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
APPENDIX D
System/38 Line Generations D-1. . . . . . . . . . . . . . . . . . . . . . . . .
Overview D-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
APPENDIX E
AS/400 Line Generations E-1.. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Overview E-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Multipoint Line Configuration Example E-2. . . . . . . . . . . . . . .
5394 Description Example E-6. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Device Description Example E-9. . . . . . . . . . . . . . . . . . . . . . . . . .
Sample Configuration E-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
INDEX Index-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FIGURES
Figure 1-1 Controller Emulating 5394 Control Units
for AS/400 Host 1-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 1-2 Controller Emulating 5294 Control Units
for System/36 or System/38 Host 1-10. . . . . . . . . . . . . . . . . .
Figure 1-3 Sample UHF Radio Network 1-13. . . . . . . . . . . . . . .
Figure 1-4 Sample SST Radio Network With Ethernet
Medium 1-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 1-5 Sample Open Wireless LAN 1-15. . . . . . . . . . . . . . . .
Figure 2-1 RT3210 Keyboard 2-7. . . . . . . . . . . . . . . . . . . . . . . . .
Figure 2-2 RT3210 Windowing Mode 2-13. . . . . . . . . . . . . . . . . .
Figure 3-1 RT1100 Keyboard 3-6. . . . . . . . . . . . . . . . . . . . . . . . .
Figure 3-2 RT1100 Windowing Mode 3-12. . . . . . . . . . . . . . . . . .
5250 Terminal Emulation Programmer’s Reference Guide ix
Page 12
CONTENTS "
Figure 4-1 RT1700 57-Key Keyboard 4-7.. . . . . . . . . . . . . . . . .
Figure 4-2 RT1700 37-Key Keyboard 4-8.. . . . . . . . . . . . . . . . .
Figure 4-3 RT1700 Windowing Mode 4-15. . . . . . . . . . . . . . . . . .
Figure 5-1 RT5900 Keyboard 5-7. . . . . . . . . . . . . . . . . . . . . . . . .
Figure 5-2 RT5900 Windowing Mode 5-13. . . . . . . . . . . . . . . . . .
Figure 6-1 PEN*KEY 6400 51-Key Keyboard 6-7. . . . . . . . . .
Figure 6-2 PEN*KEY 6400 41-Key Keyboard 6-8. . . . . . . . . .
Figure 6-3 PEN*KEY 6400 Windowing Mode 6-17. . . . . . . . . .
Figure 7-1 PEN*KEY 6500 Keyboard 7-6. . . . . . . . . . . . . . . . .
Figure 7-2 PEN*KEY 6500 Windowing Mode 7-12. . . . . . . . . .
TABLES
Table 2-1 RT3210 Special Characters 2-9.. . . . . . . . . . . . . . . .
Table 2-2 RT3210 AID-Generating Keys 2-12. . . . . . . . . . . . . . .
Table 2-3 RT3210 Signal Keys 2-15. . . . . . . . . . . . . . . . . . . . . . . .
Table 2-4 RT3210 Special Control Keys 2-15. . . . . . . . . . . . . . . .
Table 2-5 RT3210 Special Host Keys 2-17. . . . . . . . . . . . . . . . . .
Table 2-6 Other RT3210 Keys and Operations 2-17. . . . . . . . .
Table 2-7 RT3210 Key Repeat 2-19. . . . . . . . . . . . . . . . . . . . . . . .
Table 3-1 RT1100 Special Characters 3-8.. . . . . . . . . . . . . . . . .
Table 3-2 RT1100 AID-Generating Keys 3-11. . . . . . . . . . . . . . .
Table 3-3 RT1100 Signal Keys 3-14.. . . . . . . . . . . . . . . . . . . . . . .
Table 3-4 RT1100 Special Control Keys 3-14. . . . . . . . . . . . . . . .
Table 3-5 RT1100 Special Host Keys 3-16. . . . . . . . . . . . . . . . . .
Table 3-6 Other RT1100 Keys and Operations 3-17. . . . . . . . .
Table 4-1 RT1700 Letters, 37-Key Keyboard 4-10. . . . . . . . . . .
Table 4-2 RT1700 Special Characters 4-11.. . . . . . . . . . . . . . . .
Table 4-3 RT1700 AID-Generating Keys 4-13. . . . . . . . . . . . . . .
Table 4-4 RT1700 Signal Keys 4-17. . . . . . . . . . . . . . . . . . . . . . . .
Table 4-5 RT1700 Special Control Keys 4-18. . . . . . . . . . . . . . . .
Table 4-6 RT1700 Special Host Keys 4-19. . . . . . . . . . . . . . . . . .
Table 4-7 Other RT1700 Keys and Operations 4-20. . . . . . . . .
Table 4-8 RT1700 Key Repeat 4-22. . . . . . . . . . . . . . . . . . . . . . . .
x 5250 Terminal Emulation Programmer’s Reference Guide
Page 13
CONTENTS "
Table 5-1 RT5900 Special Characters 5-9.. . . . . . . . . . . . . . . .
Table 5-2 RT5900 AID-Generating Keys 5-12. . . . . . . . . . . . . . .
Table 5-3 RT5900 Signal Keys 5-15. . . . . . . . . . . . . . . . . . . . . . . .
Table 5-4 RT5900 Special Control Keys 5-16. . . . . . . . . . . . . . . .
Table 5-5 RT5900 Special Host Keys 5-17. . . . . . . . . . . . . . . . . .
Table 5-6 Other RT5900 Keys and Operations 5-17. . . . . . . . .
Table 5-7 RT5900 Key Repeat 5-19. . . . . . . . . . . . . . . . . . . . . . . .
Table 6-1 PEN*KEY 6400 Letters, 51-Key Keyboard 6-10. . .
Table 6-2 PEN*KEY 6400 Letters, 41-Key Keyboard 6-11. . .
Table 6-3 PEN*KEY 6400 Special Characters 6-12. . . . . . . . . .
Table 6-4 PEN*KEY 6400 Special Characters, Alpha
Lock Mode 6-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 6-5 PEN*KEY 6400 AID-Generating Keys 6-15. . . . . . .
Table 6-6 PEN*KEY 6400 Function Keys, Alpha
Lock Mode 6-16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 6-7 PEN*KEY 6400 Signal Keys 6-19.. . . . . . . . . . . . . . .
Table 6-8 PEN*KEY 6400 Special Control Keys 6-20. . . . . . . .
Table 6-9 PEN*KEY 6400 Special Host Keys 6-21. . . . . . . . . . .
Table 6-10 Other PEN*KEY 6400 Keys and Operations 6-22.
Table 6-11 PEN*KEY 6400 Key Repeat 6-24. . . . . . . . . . . . . . . .
Table 7-1 PEN*KEY 6500 Special Characters 7-8. . . . . . . . . .
Table 7-2 PEN*KEY 6500 AID-Generating Keys 7-11. . . . . . .
Table 7-3 PEN*KEY 6500 Signal Keys 7-14.. . . . . . . . . . . . . . .
Table 7-4 PEN*KEY 6500 Special Control Keys 7-15. . . . . . . .
Table 7-5 PEN*KEY 6500 Special Host Keys 7-16. . . . . . . . . . .
Table 7-6 Other PEN*KEY 6500 Keys and Operations 7-16. .
Table 7-7 PEN*KEY 6500 Key Repeat 7-18. . . . . . . . . . . . . . . . .
Table 8-1 Input Commands and Hex Codes 8-3. . . . . . . . . . . .
Table 8-2 Output Commands and Hex Codes 8-4. . . . . . . . . . .
Table 8-3 Write to Display Control Byte 1 8-23.. . . . . . . . . . . .
Table 8-4 Write to Display Control Byte 2 8-24.. . . . . . . . . . . .
Table 8-5 Write to Display Command Orders 8-25. . . . . . . . . .
Table 8-6 Field Format Word for Start of Field Order 8-30. . .
Table 8-7 Field Control Words 8-31. . . . . . . . . . . . . . . . . . . . . . . .
Table 8-8 Start of Field Control Word 8-36. . . . . . . . . . . . . . . . .
Table 8-9 Start of Field Attributes 8-36. . . . . . . . . . . . . . . . . . . .
Table 8-10 Function Key Bit Switches 8-39. . . . . . . . . . . . . . . . .
Table 8-11 Resequencing 8-39. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5250 Terminal Emulation Programmer’s Reference Guide xi
Page 14
CONTENTS "
Table 8-12 System Codes and Descriptions 8-42. . . . . . . . . . . .
Table 8-13 Parameter Errors 8-44. . . . . . . . . . . . . . . . . . . . . . . . .
Table 9-1 Transmit and Receive Characters 9-4. . . . . . . . . . . .
Table 9-2 Return AID Keys 9-7. . . . . . . . . . . . . . . . . . . . . . . . . .
Table 9-3 Transmit Only Characters 9-12. . . . . . . . . . . . . . . . . .
Table 9-4 Receive Only Characters 9-17. . . . . . . . . . . . . . . . . . . .
Table 9-5 Set Parameters Characters 9-22. . . . . . . . . . . . . . . . .
Table 9-6 Return Version Characters 9-27.. . . . . . . . . . . . . . . . .
Table 9-7 Tone Options 9-28. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 9-8 Scan Bar Code Parameters 9-29. . . . . . . . . . . . . . . . . .
Table 9-9 Control Byte 1 Characters 9-30. . . . . . . . . . . . . . . . . .
Table 9-10 Control Byte 2 Characters 9-31.. . . . . . . . . . . . . . . .
Table 9-11 Control Byte 3 Characters 9-32. . . . . . . . . . . . . . . . .
Table 9-12 Bar Code Length 9-33.. . . . . . . . . . . . . . . . . . . . . . . . .
Table 9-13 UPC Bar Code Characters 9-34. . . . . . . . . . . . . . . . .
Table 9-14 EAN Algorithms 9-35. . . . . . . . . . . . . . . . . . . . . . . . . .
Table 9-15 Code 39 Algorithms Characters 9-35.. . . . . . . . . . .
Table 9-16 Plessey Characters 9-36. . . . . . . . . . . . . . . . . . . . . . . .
Table 9-17 Codabar Characters 9-36.. . . . . . . . . . . . . . . . . . . . . .
Table 9-18 Plessey Check Digit Characters 9-37. . . . . . . . . . . .
Table 9-19 Code 11 Characters 9-38. . . . . . . . . . . . . . . . . . . . . . .
Table 9-20 Code 93 Characters 9-38. . . . . . . . . . . . . . . . . . . . . . .
Table 9-21 Code 128 Characters 9-38. . . . . . . . . . . . . . . . . . . . . .
Table 9-22 2of5 Characters 9-39. . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 9-23 Interleaved 2of5 Characters 9-40. . . . . . . . . . . . . . . .
Table 9-24 Key Press Sequences for Encoded Code 39 9-44. . .
Table A-1 Bar Code Data String Formats A-7. . . . . . . . . . . . . .
xii 5250 Terminal Emulation Programmer’s Reference Guide
Page 15
Section 1
Introduction
" " " " " " " " " " " " " " " " " " " " " " " " " " " "
Purpose of This Guide
This programmer’ s reference guide describes INTERMEC
R
radio products using Systems Network Architecture and
Synchronous Data Link Control (SNA/SDLC). The radio
products emulate IBM products that communicate using
the 5250 data stream.
The 5250 data stream governs the data flow between the
host computer and wireless terminal emulation stations. It
specifies what data can be displayed on the wireless station
and how it must be positioned. It also defines the types of
data a wireless station can collect for each input field.
The purpose of this guide is to define the differences
between IBM’s implementation of the data stream and
adaptation of the 5250 data stream for hand-held wireless
stations.
This guide contains descriptions of:
" How the wireless stations’ keyboards and overlays
emulate the IBM 5291 Display Station
" 5250 display data stream commands and orders sup-
ported by the wireless stations
" Extended commands for the wireless stations
" Line configurations for IBM host computers
5250 Terminal Emulation Programmer’s Reference Guide 1-1
Page 16
SECTION 1 " Introduction
Two types of 5250 products are available: those for an IBM
midrange host computer (such as System/36, System/38,
and AS/400) and those for personal computers serving as
host. This programmer’ s guide describes products for IBM
midrange host computers.
Intended Audience
This guide is prepared assuming you are already familiar
with the operation of the 5250 data stream and equipment.
The intended audience is the host computer programmer
who needs to design interfaces to wireless stations set up
for 5250 terminal emulation.
What to Read First
Before you begin using the wireless station as an emulation
product, read the sections about the wireless stations you
are designing interfaces to. The information will give you a
basic understanding of the equipment you will be working
with. You can also skim the appropriate data stream commands for programming guidance on the 5250 commands
the wireless stations support.
If your wireless station network has not yet been installed,
read first the installation and user guides provided with
your hardware. The guide describes how to install the
hardware and configure it according to the requirements of
your site.
1-2 5250 Terminal Emulation Programmer’s Reference Guide
Page 17
Organization of This Guide
This guide is divided into sections that specifically address
the operation and programming of wireless stations. This
Introduction contains a brief overview of this programmer’ s
guide. It also describes the components on the radio network.
Sections 2 through 7 describe how the wireless stations’ annunciators and keyboards emulate IBM 5291 Display Station operation. Specific sections are:
Section 2, “RT3210 Radio Terminal”
Section 3, “RT1100 Radio Terminal”
Section 4, “RT1700 Radio Terminal”
Section 5, “RT5900 Radio Terminal”
Section 6, “PEN*KEYR6400 Computer”
Section 7, “PEN*KEY 6500 Computer”
The remaining sections do the following:
SECTION 1 " Introduction
" Section 8, “Display Data Stream” describes host data
stream commands (SNA and asynchronous) and
orders supported by the wireless stations can be found
in this section. The section also lists system codes and
parameter errors.
" Section 9, “Extended Commands” describes the com-
mands you can use to print, scan bar codes, and send
communications over the wireless station’s RS-232
port. Extended commands provide additional functions for physical characteristics that extend beyond
the normal operation of an IBM 5291 Display Station.
" Appendixes contain bar code scanning information,
conversion charts, and line configuration guides for
IBM System/36, System/38, and AS/400 host computers.
5250 Terminal Emulation Programmer’s Reference Guide 1-3
Page 18
SECTION 1 " Introduction
Conventions
To help you quickly locate and interpret information, this
publication uses the conventions in the following chart.
Convention Meaning
ALL CAPS Wireless station firmware menu options.
[KEY] On the wireless station, press the key or
If Y ou Need Help
The best way to reach us is by phone. Following are Customer Response Hotline phone numbers.
keys specified in brackets.
In the United States, call: 1-800-221-9236
In Canada, call: 1-800-633-6149
Related Publications
The following publications provide information beyond the
purpose of this programmer’ s guide. Numbers in parentheses are publication part numbers.
Wireless Stations
The user’ s guide for each wireless station describes each
firmware menu option in detail and how to operate and
maintain the computer .
1-4 5250 Terminal Emulation Programmer’s Reference Guide
Page 19
SECTION 1 " Introduction
Specific user guides are:
PEN*KEY Model 6400 (961-047-093)
PEN*KEY Model 6500/6550 (961-047-099)
RT1100 (961-047-069)
RT1700 (961-047-068)
RT3210 (961-047-074)
RT5900 (961-047-121)
Controllers and Gateways
RC4030E Gateway User’s Guide (961-047-087)
The user guide for the RC4030E Gateway describes how to
install, configure, and troubleshoot the gateway.
RCB4030 Base and Base/Controller User’s Guide
(961-047-075)
The user’ s guide for the RCB4030 base describes how the
base operates. The guide also describes how to install the
base, interpret its LEDs, set its switches, and troubleshoot.
Multiple Base Adapter
MBA3000 Multiple Base Adapter User’s Guide
(961-047-032)
This guide describes how to operate the MBA3000 Multiple
Base Adapter .
Access Points and Base Radios
6710 Access Point User’s Guide (961-047-081)
The user guide for the 6710 Access Point describes how to
install, configure, and troubleshoot the access point.
RB3000 Base Station User’s Guide (962-047-012)
This guide describes how to operate the RB3000 and
RB3001 Base Stations.
5250 Terminal Emulation Programmer’s Reference Guide 1-5
Page 20
SECTION 1 " Introduction
RCB4030 Base and Base/Controller User’s Guide
(961-047-075)
The user’ s guide for the RCB4030 base describes how the
base operates. The guide also describes how to install the
base, interpret its LEDs, set its switches, and troubleshoot.
Other Publications
Application Developer’s Kit Reference Manual
(961-051-001)
This manual covers the commands that programmers can
use to write various applications for RT1100, RT1700, and
RT5900 Radio Terminals.
IBM 5250 Information Display System Functions Reference Manual
This reference manual provides more detailed descriptions
of 5250 data stream commands than what is presented in
this reference guide. The manual is available through IBM.
IBM 5394 Remote Control Unit Functions Reference
Release 1 and Release 2
This publication provides information about implementing
the 5250 data stream for the control unit. This manual is
available through IBM.
IBM 5394 Remote Control Unit User’s Guide
This publication provides general information about the
control unit. This manual is available through IBM.
Maintaining NiCd Batteries User’s Guide
(961-028-063)
The battery user’ s guide describes how to maintain the life
of nickel-cadmium batteries.
1-6 5250 Terminal Emulation Programmer’s Reference Guide
Page 21
Radio Network Description
A radio network using the 5250 data stream corresponds
directly to an IBM 5250 hard-wired network. A controller
emulates an IBM 5294 or 5394 Control Unit. Wireless stations emulate IBM 5291 Display Stations. The radio link
between a base radio and a wireless station replaces the
coax link between a control unit and display station. Programs are written for the wireless stations exactly as they
would be written for a 5291 Display Station, with the exception of screen size and specific extensions. Nomenclature
for commands, orders, and functions are the same where
possible.
The following pages briefly describe the components on the
radio network. For more information about each component, refer to its user guide.
SECTION 1 " Introduction
Host Computer
The radio network operates with an IBM AS/400, System/36, or System/38 host computer as a central distribution point for commands and data storage. Commands originate in the application program on the host computer .
The 5250 host communicates in strings of EBCDIC characters. The sequence of events that make up the communication cycle is the same for any protocol, data stream, or system of transmission:
1. The host computer’s operating system makes a connection with the controller , or vice versa.
2. Each wireless station starts a session with the host
computer’ s operating system.
3. The wireless station selects the host connection and
application.
4. The application communicates with the wireless station.
5250 Terminal Emulation Programmer’s Reference Guide 1-7
Page 22
SECTION 1 " Introduction
Controller operation in use is transparent to the host.
The host computer’ s application program serves as a con-
duit to the controller . The controller, in turn, serves as a
distribution point for the radio network. When a wireless
station logs onto the system, the controller activates the
host program. Based on data from the host computer , the
controller program then controls the screens sent to the
wireless station and uses the wireless station’s responses to
access or update the host computer’ s database.
Controller
The controller is the “gateway” that passes messages
between a host computer and the wireless stations. The
controller links the host computer to a base radio, which
communicates with the portable wireless stations on the
wireless network. The wired and wireless network is transparent to the host computer , which sees the wireless network as a set of desktop terminals.
The controller establishes a communication session with
each wireless station to exchange digital information.
While the wireless station’s application program handles
the individual wireless stations, the controller makes the
complement of wireless stations look like a hard-wired network to the host computer operator .
Controllers can emulate four multidrop IBM 5394 or eight
5294 Control Units. The primary consideration governing
the configuration is which IBM host is in use:
" Emulation of 5394 Control Units works best for IBM
AS/400 host computers.
" Emulation of 5294 Control Units works best for IBM
System/36 and System/38 host computers.
1-8 5250 Terminal Emulation Programmer’s Reference Guide
Page 23
SECTION 1 " Introduction
The controller supports 64 logical units (LUs) which correspond with wireless station network addresses 0 to 63.
When emulating four 5394 Control Units, each logical controller handles 16 LUs. A group of 16 LUs is linked to each
SDLC address, numbers 1 through 4. Figure 1-1 shows a
logical representation of four 5394 Control Units emulated
by the controller .
Physical Controller
5394 5394
SDLC address #1
(up to 16 LUs)
(wireless station addresses 00--15)
5394 5394
SDLC address #3
(up to 16 LUs)
(wireless station addresses 32--47)
SDLC address #2
(up to 16 LUs)
(wireless station addresses 16--31)
SDLC address #4
(up to 16 LUs)
(wireless station addresses 48--63)
Figure 1-1
Controller Emulating 5394 Control Units for AS/400 Host
Figure 1-2 shows a different configuration. The controller
emulates eight 5294 Control Units with 8 LUs each. The
LUs are located at SDLC addresses 1 through 8. This provides up to 64 LUs and is suitable for IBM System/36 or
System/38 host computers.
5250 Terminal Emulation Programmer’s Reference Guide 1-9
Page 24
SECTION 1 " Introduction
Physical Controller
5294 5294
SDLC address #1
(up to 8 LUs)
(wireless station addresses 0--7)
5294 5294
SDLC address #3
(up to 8 LUs)
(wireless station addresses 16--23)
5294
SDLC address #5
(up to 8 LUs)
(wireless station addresses 32--39)
5294
SDLC address #7
(up to 8 LUs)
(wireless station addresses 48--55)
Controller Emulating 5294 Control Units
for System/36 or System/38 Host
SDLC address #2
(up to 8 LUs)
(wireless station addresses 8--15)
SDLC address #4
(up to 8 LUs)
(wireless station addresses 24--31)
5294
SDLC address #6
(up to 8 LUs)
(wireless station addresses 40--47)
5294
SDLC address #8
(up to 8 LUs)
(wireless station addresses 56--63)
Figure 1-2
In either emulation, SDLC addresses can range from 1 to
254. Each SDLC address must be unique.
In either emulation, you can eliminate unused PUs by
reducing, through the controller’ s setup parameters, the
number of LUs supported. Refer to the controller’ s user
guide for more information about setting up the controller .
1-10 5250 Terminal Emulation Programmer’s Reference Guide
Page 25
SECTION 1 " Introduction
Base Radios
Base radios (also called access points) directly connect to
the network and pass information from the wireless stations to the controller . Wireless stations passing from the
coverage area of one base radio to another are tracked automatically by the network. This is called “roaming.”
Multiple base radios can be hard-wired to an RS-485 or
Ethernet backbone, or linked through a radio connection
between base radios. One base radio must be hard-wired to
the controller .
The controller communicates with the base radios over a
wired network. Messages to the wireless stations from the
controller are passed over the wired network to the base radio. The base radio converts the message into the protocol
used by the wireless station, and distributes the message
onto the network. The wireless station receives the message over the radio link. The process of formatting and
handling the messages between base radios and the wireless stations is transparent to the operator .
Base radios operate within the 900 MHz or at 2.4 GHz
(WLIF) frequency range. UHF base radios operate in the
450 to 470 MHz band of radio waves.
Wireless Stations
The wireless stations are the portable components on the
network. Their small size allows them to be used in the
warehouse or plant to gather information through the keyboard or integrated bar code scanner . The portable wireless
stations provide interactive communication between the operator and host computer .
5250 Terminal Emulation Programmer’s Reference Guide 1-11
Page 26
SECTION 1 " Introduction
Wireless stations provide portable, wireless interactive data
communication and support bar code scanning for real-time
data collection. They are the network-addressable software
entity which interfaces the wireless data network to the
base radio.
Each wireless station monitors all messages from the host
computer and responds only to those containing its unique
address number . This communication process allows commands and data to be received, stored, and processed. Data
collected by the wireless station’s keyboard or scanner is
returned in a similar fashion. The controller buffers (saves)
the data to be forwarded to the host computer .
The information in this programmer’ s guide applies to all
wireless stations set up for 5250 terminal emulation. Wireless stations have UHF, 900 MHz, or WLIF radios.
Types of Radio Networks
The following pages briefly describe how radio networks
emulate an IBM 3270 hard-wired network. Multiple network configurations are possible.
UHF Radio Network
A UHF radio network has the following components:
" Host computer
" RC3240 or RC3250 Controller
" RB3000, RB3001, RB3020, or RB3021 Base with UHF
radio
" RT3210, RT1100, RT1700, or RT5900 Radio Terminals
with UHF radios
1-12 5250 Terminal Emulation Programmer’s Reference Guide
Page 27
SECTION 1 " Introduction
Figure 1-3 shows a sample UHF radio network. Note how
the radio link from the base radio to the radio terminals
replaces the coax links (dotted lines) between the control
unit and Model 2 terminals.
IBM Host
Computer
Front End
Processor
IBM 3278
Model 2
Terminal
IBM 3274
Control Unit
Controller
IBM 3278
Model 2
Terminal
RT5900 Radio
Terminal
RT1100 Radio
Terminals
Base Radio
Figure 1-3
Sample UHF Radio Network
SST Radio Network With Ethernet
Backbone
A radio network with an Ethernet backbone has the following components:
" Host computer
" RCB4030 Base/Controller
" RCB4030 Base/Controller with SST 900 MHz radio
" RT3210, RT1100, RT1700, or RT5900 Radio Terminals
with 900 MHz radios
5250 Terminal Emulation Programmer’s Reference Guide 1-13
Page 28
SECTION 1 " Introduction
Figure 1-4 shows a sample radio network. Note how the
radio links from the base radios to the radio terminals
replace the coax links (dotted lines) between the control
unit and Model 2 terminals.
IBM Host
Computer
Front End
Processor
IBM 3278
Model 2
Terminal
IBM 3274
Control Unit
Base/Controller or Gateway
Ethernet Medium
IBM 3278
Model 2
Terminal
Base Radio
Figure 1-4
Sample SST Radio Network With Ethernet Medium
Open Wireless LAN
RT5900 Radio
Terminal
RT1700 Radio
Terminals
Open wireless LAN components connect to an Ethernet medium. Components include the following:
1-14 5250 Terminal Emulation Programmer’s Reference Guide
Page 29
SECTION 1 " Introduction
" Host computer
" RC4030E Gateway, Wireless Network Access Server,
or 6950 Enterprise Gateway Server
" 6710 Access Point with synthesized UHF, 900 MHz, or
WLIF radio
" Wireless stations with synthesized UHF, 900 MHz, or
WLIF radios
Figure 1-5 shows a sample radio network with an RC4030E
Gateway. Note how the radio links from the 6710 Access
Point to the wireless terminal emulation stations replace
the coax links (dotted lines) between the control unit and
Model 2 terminals.
IBM Host
Computer
IBM 3278
Model 2
Terminal
IBM 3274
Control Unit
RC4030E
Gateway
Ethernet Medium
IBM 3278
Model 2
Terminal
6710 Access
Point
Figure 1-5
Sample Open Wireless LAN
RT5900 Radio
Terminal
PEN*KEY 6400
Computers
5250 Terminal Emulation Programmer’s Reference Guide 1-15
Page 30
SECTION 1 " Introduction
1-16 5250 Terminal Emulation Programmer’s Reference Guide
Page 31
Section 2
RT3210 Radio Terminal
" " " " " " " " " " " " " " " " " " " " " " " " " " " "
Overview
The RT3210 Radio Terminal is designed to appear to the
host computer as an IBM 5291 Display Station. To help the
system programmer design interfaces to the radio terminal,
this section describes the screen size, screen modes, annunciators, keyboard, and IBM display emulation for the radio
terminal as part of the 5250 data stream.
"
NOTE: RT3210 Radio Terminals have UHF radios only.
RT3210 Radio Terminals are compatible with other radio
terminals with UHF radio modules in the RT1100, RT1700,
and RT5900 Series. This lets the RT3210 Radio Terminal
work interchangeably with other radio terminals on a network.
"
NOTE: On a UHF network the RT3210, RT1100, RT1700, and RT5900 oper-
ate at 4800 baud only.
You can set up the radio terminal through its firmware
menus or from the host through the Set Parameters extended command. Extended commands are described in
Section 9. For information about firmware menus, refer to
the radio terminal’s user guide.
5250 Terminal Emulation Programmer’s Reference Guide 2-1
Page 32
SECTION 2 " RT3210 Radio Terminal
Screen Size
The RT3210 Radio Terminal has a 128 by 128 pixel supertwist liquid crystal display. The display shows terminal
and host computer prompts, and data entered by the operator .
Because a 5291 Display Station has a screen size of 80 characters by 24 lines, the radio terminal presents a part of the
information on the larger display station.
Character Sizes
The RT3210 Radio Terminal has two character sizes: a 5by 7-dot, or a 7- by 9- dot set. Each dot occupies one pixel
on the LCD display. The 5- by 7-dot characters are smaller,
but allow the operator to view a larger portion of the
1920-byte buffer represented on the display station.
When the radio terminal powers up, it defaults to a 7- by
9-dot character size. This yields a usable screen size of 9
rows by 16 columns. The bottom row is reserved for annunciators and system messages. The total number of characters this size can display is 144. By using the firmware
menus or the Set Parameters extended command, you can
change the character size to the smaller 5- by 7-dot pixel
characters. This yields a usable screen size of 15 lines by
21 characters (the bottom row is reserved for system use).
The maximum number of characters with this size is 315.
2-2 5250 Terminal Emulation Programmer’s Reference Guide
Page 33
Screen Modes
The radio terminal has these screen modes: center cursor ,
corner , page, lazy, and locked. The modes present a window
onto a standard 5291 Display Station’s 80-character by
24-line display buffer . You can set the type of screen mode
through the radio terminal’s firmware menus.
You can move the cursor by using the four direction arrows
on the radio terminal’s diamond-shaped keypad. When you
try to move the cursor onto one of the boundaries, an error
tone sounds and the display retains its last position.
The screen modes govern which portion of the larger 5291
Display Station’s screen the radio terminal first presents
and how the window moves as the cursor moves.
Center Cursor Mode
SECTION 2 " RT3210 Radio Terminal
Center cursor mode works best for applications that use the
entire 5250 data stream’s 80-character by 24-line logical
display. In this mode, the cursor remains in the center of
the radio terminal’s window.
As the cursor moves within the window, the radio terminal’s
display window moves to keep it centered. When the cursor
moves off the right, left, top, or bottom edge of the 5291 Display Station, the window remains fixed despite the cursor’ s
movement.
Corner Mode
Corner mode begins with the window in the upper left corner of the larger 5291 Display Station. It keeps the cursor
in the lower right corner of the display. Corner mode works
best for applications that use the upper left corner of the
logical screen.
5250 Terminal Emulation Programmer’s Reference Guide 2-3
Page 34
SECTION 2 " RT3210 Radio Terminal
As the cursor moves off the right or bottom edge of the radio
terminal’s display, the window moves to show the cursor.
When you use corner mode with the [FUNC] or [ALT] key,
you can move the cursor a predetermined number of key
presses in all four directions.
Page Mode
Page mode provides predefined pages within the larger
5291 Display Station. The size of these pages depends on
the number of rows and columns selected for display. The
radio terminal moves the window by a multiple of the page
size. As the cursor moves off the edge of the radio terminal’s display, the window changes to the next page.
Lazy Mode
Lazy mode starts the cursor in the upper left corner of the
display. The cursor moves across the display in the scrolled
direction. When the cursor goes beyond the edge of the display, the data begins to move in the scrolled direction and
the cursor remains at the edge of the display. When you try
to go beyond an outside boundary, an error tone sounds.
Locked Mode
If locked mode is selected through the firmware menus, the
view window is locked to the upper left-hand corner of the
display.
The screen does not window around, and only the area that
has been selected to be the screen size is visible. Locked
mode disables the windowing keys, or only allows you to
window around the physical display size selected through
the firmware menus. Locked mode also moves the error
line to the last position in the display.
2-4 5250 Terminal Emulation Programmer’s Reference Guide
Page 35
Annunciators
The RT3210 Radio Terminal’ s display reserves a location for
icons or small pictures, called “annunciators,” which show
the radio terminal’s current status or operation in progress.
The following annunciators can appear in the radio terminal’s display.
SECTION 2 " RT3210 Radio Terminal
The radio terminal is transmitting information
to the base radio.
The radio terminal is receiving information
from the base radio. This annunciator appears
only when the information is for the radio terminal’s unique address number.
Communications loss. No communication
with the host computer has occurred for at least
60 seconds. The radio terminal may be out of
radio range, the base radio may not have power,
or communications from the host computer to
the base radio may not be properly set up.
The radio terminal’s keyboard is in function
mode. The key you press on the keyboard in
combination with [FUNC] returns the function
assigned by the programmer, or does an operation. Key codes and operations are located just
above the keys and to the left (black lettering).
The radio terminal’s keyboard is in alternate
mode. The key you press on the keyboard in
combination with [ALT] types the character or
does the operation just above the key and to the
right (yellow lettering).
5250 Terminal Emulation Programmer’s Reference Guide 2-5
Page 36
SECTION 2 " RT3210 Radio Terminal
The radio terminal’s keyboard is in shift mode.
The letters you press on the keyboard after you
press [SFT] will be in uppercase, until you press
[SFT] again.
The battery needs to be recharged. When this
annunciator appears, you have only two minutes
of operating time left before the radio terminal
disables operator input and radio communications. After two minutes, the message
“CONNECT UNIT TO CHARGER” blinks.
Recharging. The radio terminal is connected to
a battery charger.
The radio terminal’s battery pack is fully
charged. This annunciator is used by the fast
charge algorithm to indicate the fully charged
condition.
High speed. The base radio is transmitting information at 9600 baud (versus 4800 baud).
Input inhibited. The keyboard has accepted
enough information for the defined input field.
The “key ahead” feature stores keystrokes after
this annunciator appears. These are saved for
the next field.
Insert mode. The keyboard inserts characters
instead of overwriting them.
Message waiting. The host has a message
waiting for the radio terminal operator.
2-6 5250 Terminal Emulation Programmer’s Reference Guide
Page 37
Keyboard
SECTION 2 " RT3210 Radio Terminal
The radio terminal’s 50-key keyboard (Figure 2-1) has shift
keys, alphabetic keys, numeric keys, special characters,
special function keys, and keys that do other operations.
5250 Terminal Emulation Programmer’s Reference Guide 2-7
Figure 2-1
RT3210 Keyboard
Page 38
SECTION 2 " RT3210 Radio Terminal
Shift Keys
Use the shift keys to type uppercase letters and special
characters, and to do special functions. Shift keys are described in the following chart.
Shift Key Description
[SFT] Press [SFT] plus a letter to type the letter in up-
[FUNC] The [FUNC] key puts the keyboard into function
[ALT] The [ALT] key puts the keyboard into alternate
percase. The [SFT] key is located near the top of
the keyboard.
mode. Press the [FUNC] key plus a keyboard
key to do an operation printed in black on the
overlay.
mode. Press the [ALT] key plus a keyboard key
to type a special character printed in yellow on
the overlay.
Notice that the [FUNC] key is to the left of the [ALT] key.
Characters and operations printed on the overlay have the
same relative relationship; the operation above a key and to
the left (black lettering) indicates function mode, and the
character above a key and to the right (yellow lettering)
indicates alternate mode. For example:
" To type the special character “@” (printed in yellow on
the overlay and to the right of F1), press [ALT]+[A].
" Press [FUNC]+[U] to do the [F21] function (printed in
black on the overlay and to the left of the backslash).
When you press [SFT], [FUNC], or [ALT], an annunciator in
the display indicates the current shift mode.
2-8 5250 Terminal Emulation Programmer’s Reference Guide
Page 39
Alphabetic Keys
Press a letter without first pressing [SFT] to type a lowercase letter . Press [SFT] plus a letter to type the letter in
uppercase. For example, [SFT]+[A] types a capital “A.”
To lock the keyboard into shift mode, press
[BLACK]+[GOLD]. To unlock the keyboard, press
[BLACK]+[GOLD] again. The annunciator of a triangle
pointing up means the keyboard is in shift mode.
Numeric Keys
Ten numeric keys are arranged in a 10-key format on the
bottom half of the keyboard. Use them to enter numeric
data.
SECTION 2 " RT3210 Radio Terminal
Special Characters
Table 2-1 describes how to type special characters.
Special Character Press
@ (at) [ALT]+[A]
-- (minus) [ALT]+[B]
+ (plus) [ALT]+[C]
( (left parenthesis) [ALT]+[D]
$ (dollar) [ALT]+[E]
) (right parenthesis) [ALT]+[F]
5250 Terminal Emulation Programmer’s Reference Guide 2-9
Table 2-1
RT3210 Special Characters
Page 40
SECTION 2 " RT3210 Radio Terminal
Special Character Press
# (pound) [ALT]+[G]
* (asterisk) [ALT]+[H]
% (percent) [ALT]+[I]
/ (forward slash) [ALT]+[J]
& (ampersand) [ALT]+[K]
; (semicolon) [ALT]+[L]
, (comma) [ALT]+[M]
: (colon) [ALT]+[N]
? (question mark) [ALT]+[O]
_ (underscore) [ALT]+[P]
{ (left brace) [ALT]+[Q]
} (right brace) [ALT]+[R]
’ (single quote) [ALT]+[S]
” (double quote) [ALT]+[T]
\ (backslash) [ALT]+[U]
= (equal) [ALT]+[V]
< (left angle bracket) [ALT]+[W]
> (right angle bracket) [ALT]+[X]
~ (tilde) [ALT]+[Y]
| (vertical bar) [ALT]+[Z]
(not symbol) [ALT]+[ . ]
¢ (cent) [ALT]+[SP]
! (exclamation mark) [ALT]+[7]
| (piping symbol) [ALT]+[8]
‘ (grave accent) [ALT]+[9]
Table 2-1 (Continued)
RT3210 Special Characters
2-10 5250 Terminal Emulation Programmer’s Reference Guide
Page 41
Special Function Keys
Special function keys are:
" AID-generating keys
" Cursor movement keys
" Field Exit key
" Signal keys
" Special control keys
" Special host keys
The following pages describe special function keys on the
RT3210 Radio Terminal. For complete descriptions refer to
the appropriate IBM 5250 functions reference manual.
AID-Generating Keys
AID-generating keys generate AID codes that go in the display data stream to the host system. They alert the host
system that the controller requires some action.
SECTION 2 " RT3210 Radio Terminal
The RT3210 Radio Terminal emulates all of the AID-generating keys on a 5291 Display Station. Table 2-2 lists key
sequences.
5250 Terminal Emulation Programmer’s Reference Guide 2-11
Page 42
SECTION 2 " RT3210 Radio Terminal
Table 2-2
RT3210 AID-Generating Keys
5291 AID Key Press Description
Clear [FUNC]+[1] The system environment determines
the results of this key. If the radio
terminal is in session, [CLEAR] issues
the AID code hex BD, which requests
that the host system issue a Clear
Unit command to the RT3210 to clear
the display. If not in session,
[CLEAR] clears the entire display
regeneration buffer.
Enter/Rec Adv [ENTER] Enters information.
Help (nonerror
state)
F1--F24 [FUNC]+[A] --
[FUNC]+[2] Issues a hex F3 AID byte to the host
system.
User-defined command functions.
[FUNC]+[X]
Print [FUNC]+[8] Tells the controller that the operator
wants to print the contents of the
present display. Issues hex F6 to the
host system.
Record Backspace
(Home)
[FUNC]+[RESET] When pressed with the cursor in the
home position, a record backspace is
requested. The AID code hex F8 and
cursor address are sent to the host
system.
Roll - (Roll up/
Page down)
Roll ¯ (Roll down/
Page up)
[B]
[Y]
Rolls display down one page; issues
AID code hex F5.
Rolls display up one page; issues AID
code hex F4.
2-12 5250 Terminal Emulation Programmer’s Reference Guide
Page 43
SECTION 2 " RT3210 Radio Terminal
Cursor Movement Keys
The four cursor control keys in the upper right corner of the
keyboard move the cursor within the screen buffer . Each
key moves the cursor in the direction indicated by the
arrow.
Cursor left and right move the cursor one character position
at a time in the display buffer . The cursor up and down
keys move the cursor up or down one line. The screen mode
governs how the radio terminal represents this movement.
Attempting to move the cursor off the screen in any direction causes the window to shift in the direction of movement. This feature allows you to move the viewing window
around within the larger 5291 Display Station’s 80-character by 24-line screen (Figure 2-2).
INDOW DISPL
S THE TERMI
TO VIEW ANY
E ACTUAL 52
O MOVE ABOU
THE WINDOW DISPLAY MODE
ALLOWS THE TERMINAL
USER TO VIEW ANY PART
OF THE ACTUAL 5291 SCREEN
AND TO MOVE ABOUT THE
5291 SCREEN USING THE
CURSOR CONTROL KEY.
Figure 2-2
RT3210 Windowing Mode
5250 Terminal Emulation Programmer’s Reference Guide 2-13
RT3210 Radio Terminal
5291 Display Station
Page 44
SECTION 2 " RT3210 Radio Terminal
Cursor location is not limited to the current window. All
cursor movement keys (for example, Field Exit, New Line,
and the cursor keys) respond just as they would on the
80x24 display. For example, when you press the [FIELD +]
key and the next field is outside the current window, the
window moves to the new location.
Use the cursor control keys in combination with [FUNC]
and [ALT] to move through the radio terminal’s display a
single space at a time or eight spaces at a time. The following chart shows key combinations.
To Press
Forward tab
Reverse tab
Move 1 space right
Move 1 space left
Move 1 space up
Move 1 space down
Move 8 spaces right
Move 8 spaces left
Move 8 spaces up
Move 8 spaces down
["]
[A]
[FUNC]+["]
[FUNC]+[A]
[FUNC]+[Y]
[FUNC]+[B]
[ALT]+["]
[ALT]+[A]
[ALT]+[Y]
[ALT]+[B]
Field Exit Key
Field Exit clears to the end of the field and tabs to the next
field. The key on the RT3210 keyboard is [FIELD EXIT].
Signal Keys
Signal keys cause a Signal command to go from the controller to the host system. Signal keys are Attn and Help
(Table 2-3).
2-14 5250 Terminal Emulation Programmer’s Reference Guide
Page 45
SECTION 2 " RT3210 Radio Terminal
Table 2-3
RT3210 Signal Keys
5291 Signal
Key Press Description
Attn [FUNC]+[3] The operator presses this key
to alert the host system that
the function requested (for
example, [ENTER]) is not
being honored. Attn is valid
when the keyboard is locked or
unlocked. It does not change
the keyboard state or the
cursor location.
Help (from
error state)
[FUNC]+[2] The operator uses this key to
request that the host system
send data about the error to
the display.
Special Control Keys
Use the special control keys (Table 2-4) to change operatorgenerated information in the radio terminal’s display. The
keys do not work when the keyboard is locked.
Table 2-4
RT3210 Special Control Keys
5291 Special
Control Key Press Description
Del
Display mode (None) You must set the radio
5250 Terminal Emulation Programmer’s Reference Guide 2-15
[FUNC]+[¬]
Deletes the character in
the position where the
cursor was located. All
remaining characters in
the field shift to the left
to fill the column.
terminal’s display
contrast through the
firmware menus.
Page 46
SECTION 2 " RT3210 Radio Terminal
5291 Special
Control Key DescriptionPress
Erase Input [FUNC]+[4] Clears all fields to nulls,
Error Reset [RESET] Restores the original
Hex [FUNC]+[Z] Enters hexadecimal
Home [FUNC]+[RESET] Moves the cursor to the
Insert [FUNC]+[5] Sets or turns off the
Shift Lock [FUNC]+[ALT] Puts the keyboard into
Alternate cursor (None) You must change the
Display cursor
location
Table 2-4 (Continued)
RT3210 Special Control Keys
and the cursor moves to
the first input field.
data on the error line of
the display and resets
the state.
codes from the keyboard
to generate any
EBCDIC characters
needed for input or display.
position specified by the
insert cursor (IC)
address.
insert mode for the
input field the operator
has the cursor in. The
operator must reset the
insert state before exiting it, by either pressing
[RESET] or [INSERT]
again.
shift lock mode.
cursor type through the
firmware menus.
(None) The radio terminal does
not support this feature.
On the 5291 keyboard,
it displays the cursor
location.
2-16 5250 Terminal Emulation Programmer’s Reference Guide
Page 47
SECTION 2 " RT3210 Radio Terminal
Special Host Keys
Special host keys are Sys Req and Test Request (Table 2-5).
Table 2-5
RT3210 Special Host Keys
5291 Special
Host Key Press Description
Sys Req [FUNC]+[7] Data on the error line is saved,
the error line is cleared, a
column separator and
underscore field attribute are
supplied to column 1 of the error
line, and the cursor is located
under column 2 to begin polling
keystrokes.
Test Request (None) The radio terminal does not
support Test Request.
Other Keys
Table 2-6 lists other radio terminal keys and their operations.
Operation Press Description
Backspace
Menu [FUNC]+
Table 2-6
Other RT3210 Keys and Operations
[¬]
[FIELD EXIT]
5250 Terminal Emulation Programmer’s Reference Guide 2-17
Moves cursor one space to
the left.
Brings up the radio
terminal’s main menu and
firmware parameters.
Page 48
SECTION 2 " RT3210 Radio Terminal
Other RT3210 Keys and Operations
Operation DescriptionPress
Dup (duplicate
enabled fields
only)
(New Line) [FUNC]+[Y] Moves cursor to beginning
Field-- [FUNC]+[9] For numeric fields, makes
Field+ [FUNC]+[6] Advances cursor to the
Backlight [FUNC]+[SP] Toggles display’s
Table 2-6 (Continued)
[FUNC]+[0] Controller repeats hex
“1C” from the cursor position to the end of the field.
This shows in the display
as an overstruck asterisk.
of next field.
the input a negative
number.
next input field. For
numeric fields, makes the
input a positive number.
backlight on and off.
You can also use the keyboard to do key ahead, scan ahead,
and repeat key operations.
Key Ahead
Key ahead stores keystrokes after the Input Inhibited annunciator appears, and saves them for the next input field.
The Input Inhibited annunciator appears on the status line
while the radio terminal is waiting for the host to respond.
Key ahead is enabled as a default but can be disabled
through the radio terminal’s firmware.
2-18 5250 Terminal Emulation Programmer’s Reference Guide
Page 49
SECTION 2 " RT3210 Radio Terminal
Cursorcontrolkeysusedwith[FUNC]and[ALT]
Scan Ahead
Scan ahead stores one bar code after the Input Inhibited
annunciator appears, and saves it for the next input field.
The Input Inhibited annunciator appears on the status line
while waiting for the host to respond.
Key Repeat
Key repeat on the radio terminal’s keyboard is similar to
the key repeat on a 5291 Display Station. For example, to
fill an input field with the letter “a,” do one of the following:
" Press the “A” key repeatedly until the field is full.
" Press and hold the “A” key until the field is full.
Key repeat does not work with all keys. Table 2-7 shows
which keys do and do not repeat.
Table 2-7
RT3210 Key Repeat
Repeating Nonrepeating
Del Alt
EBCDIC characters Attn
Forward Tab Backlight
New Line Clear
Reverse Tab Dup
Cursor control keys used
5250 Terminal Emulation Programmer’s Reference Guide 2-19
Enter/Rec Adv
Erase Input
Error Reset
F1--F24
Page 50
SECTION 2 " RT3210 Radio Terminal
Repeating Nonrepeating
Table 2-7 (Continued)
RT3210 Key Repeat
Field Exit
Field-Field+
Func
Help
Hex
Home
Insert
Menu
Print
Roll - (Roll up/Page down)
Roll ¯ (Roll down/Page up)
Shift
Shift Lock
Sys Req
System Messages
The radio terminal’s display reserves a line for status information. The status line can display system (nonlocal)
information such as a message waiting from the host computer , help messages in response to the [HELP] key, or the
system request state of the radio terminal.
System codes can also appear on the status line. System
messages and codes are described in Section 8, “Display
Data Stream.”
2-20 5250 Terminal Emulation Programmer’s Reference Guide
Page 51
Section 3
RT1100 Radio Terminal
" " " " " " " " " " " " " " " " " " " " " " " " " " " "
Overview
The RT1100 Radio Terminal is designed to appear to the
host computer as an IBM 5291 Display Station. To help the
system programmer design interfaces to the radio terminal,
this section describes the screen size, screen modes, annunciators, keyboard, and IBM display emulation for the radio
terminal as part of the 5250 data stream.
"
NOTE: Radio terminals in the RT1100 Series have UHF, 900 MHz, or WLIF
radio modules.
RT1100 Radio Terminals are compatible with RT3210 (UHF
only), RT1700, and RT5900 Radio Terminals; and
PEN*KEYR6400 Computers (900 MHz and WLIF only).
This lets the RT1100 Radio Terminal work interchangeably
with other wireless stations on a network.
You can set up the radio terminal through its firmware
menus or from the host through the Set Parameters extended command. Extended commands are described in
Section 9. For information about firmware menus, refer to
the radio terminal’s user guide.
5250 Terminal Emulation Programmer’s Reference Guide 3-1
Page 52
SECTION 3 " RT1100 Radio Terminal
Screen Size
The RT1100 Radio Terminal has a supertwist, liquid crystal
display with 4, 6, 8, or 9 lines with 12 or 16 characters per
line. You can set the screen size through the radio terminal’s firmware menus.
The display shows radio terminal and host computer
prompts, as well as data entered by the operator. Because a
5291 Display Station has a screen size of 80 characters by
24 lines, the radio terminal presents a part of the information on the larger display station.
Screen Modes
The radio terminal has these screen modes: center cursor ,
corner , page, lazy, and locked. The modes present a window
onto a standard 5291 Display Station’s 80-character by
24-line display buffer . You can set the type of screen mode
through the radio terminal’s firmware menus.
The screen modes govern which portion of the larger 5291
Display Station’s screen the radio terminal first presents
and how the window moves as the cursor moves.
Center Cursor Mode
Center cursor mode works best for applications that use the
entire 5250 data stream’s 80-character by 24-line logical
display. In this mode, the cursor remains in the center of
the radio terminal’s window.
As the cursor moves within the window, the radio terminal’s
display window moves to keep it centered. When the cursor
moves off the right, left, top, or bottom edge of the 5291 Display Station, the window remains fixed despite the cursor’ s
movement.
3-2 5250 Terminal Emulation Programmer’s Reference Guide
Page 53
SECTION 3 " RT1100 Radio Terminal
Corner Mode
Corner mode begins with the window in the upper left corner of the larger 5291 Display Station. It keeps the cursor
in the lower right corner of the display. Corner mode works
best for applications that use the upper left corner of the
logical screen.
As the cursor moves off the right or bottom edge of the radio
terminal’s display, the window moves to show the cursor.
When you use corner mode with the gold-colored key, you
can move the cursor a predetermined number of key presses
in all four directions.
Page Mode
Page mode provides predefined pages within the larger
5291 Display Station. The size of these pages depends on
the number of rows and columns selected for display. The
radio terminal moves the window by a multiple of the page
size. As the cursor moves off the edge of the radio terminal’s display, the window changes to the next page.
Lazy Mode
Lazy mode starts the cursor in the upper left corner of the
display. The cursor moves across the display in the scrolled
direction. When the cursor goes beyond the edge of the display, the data begins to move in the scrolled direction and
the cursor remains at the edge of the display. When you try
to go beyond an outside boundary, an error tone sounds.
5250 Terminal Emulation Programmer’s Reference Guide 3-3
Page 54
SECTION 3 " RT1100 Radio Terminal
Locked Mode
If locked mode is selected through the firmware menus, the
view window is locked to the upper left-hand corner of the
display. The screen does not window around, and only the
area that has been selected to be the screen size is visible.
Locked mode disables the windowing keys, or only allows
you to window around the physical display size selected
through the firmware menus. Locked mode also moves the
error line to the last position in the display.
Annunciators
The RT1100 Radio Terminal’ s display reserves a location for
icons or small pictures, called “annunciators,” which show
the radio terminal’s current status or operation in progress.
The following annunciators can appear in the radio terminal’s display.
T
X
C
L
Y
A
3-4 5250 Terminal Emulation Programmer’s Reference Guide
The radio terminal is transmitting information to
the base radio.
Communications loss. The radio terminal cannot
communicate with the host computer. The radio terminal may be out of radio range, the base radio may
not have power, or communication from the host to
the access point may not be properly set up.
The radio terminal’s keyboard is in shift mode. The
letter key you press while the keyboard is in this
mode types the letter in uppercase.
The radio terminal’s keyboard is in black shift
mode. The key you press while the keyboard is in
this mode does the operation printed in black on the
overlay and to the upper left of the key.
Page 55
SECTION 3 " RT1100 Radio Terminal
"
X
C
+
--
The radio terminal’s keyboard is in gold shift
mode. The key you press while the keyboard is in
this mode types the special character or does the
operation printed in gold on the overlay and to the
upper right of the key.
Input inhibited. The keyboard has accepted
enough information for the defined input field. The
“key ahead” feature stores keystrokes after “input
inhibited” appears. These are saved for the next
field.
Insert mode. The keyboard inserts characters
instead of overwriting them.
Message waiting. The host has a message
waiting for the radio terminal operator.
The battery is charging.
The battery needs to be recharged. When this
annunciator appears, you will not be able to operate
your radio terminal until you place it on a charger.
Keyboard
S
C
A
N
Laser scanner is in use. This annunciator ensures
you are aware of the laser scanner and the cautions
you must exercise. Read and obey the caution
labels on your laser scanner so that you do not
injure your eyes.
The radio terminal’s 47-key keyboard (Figure 3-1) has shift
keys, alphabetic keys, numeric keys, special characters,
special function keys, and keys that do other operations.
5250 Terminal Emulation Programmer’s Reference Guide 3-5
Page 56
SECTION 3 " RT1100 Radio Terminal
ON/OFF
F1 @ F2 -- F3 + F4 ( F5 $
A
F6 ) F7 # F8 * F9 % F10 /
W W W W
RESET
SHIFT
B C D E
F G H I J
F11 & F12 ; F13 , F14 : F15 ?
K L M N O
F16 _ F17 { F18 } F19 ’ F20 ”
P Q S T
F21 \ F22 = F23 < F24 >
U
HEX |
V W X Y
HOME ! DEL MENU
R
Z SP
SYS REQ ‘
7
ERASE INPUT ROLL
PRINT |
8 9
INSERT .
ROLL ¢
4 5 6
CLEAR
HELP
ATTN
1 2 3
FIELD- FIELD+
DUP
~
341-071-007 5250
0 ENTER
FIELD EXIT
Unlabeled key colors:
Black
Gold
Brown
Figure 3-1
RT1100 Keyboard
3-6 5250 Terminal Emulation Programmer’s Reference Guide
Page 57
Shift Keys
SECTION 3 " RT1100 Radio Terminal
Use the shift keys to type uppercase letters and special
characters, and to do special functions. Shift keys are described in the following chart.
Shift Key Description
[SHIFT] Press the brown-colored [SHIFT] key plus a let-
ter to type the letter in uppercase. The [SHIFT]
key is located near the top of the keyboard.
[GOLD] The gold-colored key puts the keyboard into gold
shift mode. Press the [GOLD] key plus a keyboard key to type a special character or do an
operation printed in gold on the overlay.
[BLACK] The black-colored key puts the keyboard into
black shift mode. Press the [BLACK] key plus a
keyboard key to do an operation printed in black
on the overlay.
The special characters and functions printed on the overlay
are color-coded to correspond with the shift keys. For example:
" To type the special character “@” (printed in gold on
the overlay), press [GOLD]+[A].
" Press [BLACK]+[U] to do the [F21] function (printed
in black on the overlay).
When you press [SHIFT], [GOLD], or [BLACK], an annunciator in the display indicates the current shift mode.
One of the keys on the keyboard — the [FIELD EXIT] key
— has its operation printed to the left of it. The operation
printed to the left is its unshifted value. The operations
printed above [FIELD EXIT] are the shifted values.
5250 Terminal Emulation Programmer’s Reference Guide 3 -7
Page 58
SECTION 3 " RT1100 Radio Terminal
Alphabetic Keys
Press a letter without first pressing [SHIFT] to type a lowercase letter . Press [SHIFT] plus a letter to type the letter
in uppercase. For example, [SHIFT]+[A] types a capital
“A.”
To lock the keyboard into shift mode, press [BLACK]+
[GOLD]. To unlock the keyboard, press [BLACK]+[GOLD]
again. The annunciator of a triangle pointing up means the
keyboard is in shift mode.
Numeric Keys
Ten numeric keys are arranged in a 10-key format on the
bottom half of the keyboard. Use them to enter numeric
data.
Special Characters
Table 3-1 describes how to type special characters.
Table 3-1
RT1100 Special Characters
Special Character Press
@ (at) [GOLD]+[A]
-- (minus) [GOLD]+[B]
+ (plus) [GOLD]+[C]
( (left parenthesis) [GOLD]+[D]
$ (dollar) [GOLD]+[E]
3-8 5250 Terminal Emulation Programmer’s Reference Guide
Page 59
SECTION 3 " RT1100 Radio Terminal
Table 3-1 (Continued)
RT1100 Special Characters
Special Character Press
) (right parenthesis) [GOLD]+[F]
# (pound) [GOLD]+[G]
* (asterisk) [GOLD]+[H]
% (percent) [GOLD]+[I]
/ (forward slash) [GOLD]+[J]
& (ampersand) [GOLD]+[K]
; (semicolon) [GOLD]+[L]
, (comma) [GOLD]+[M]
: (colon) [GOLD]+[N]
? (question mark) [GOLD]+[O]
_ (underscore) [GOLD]+[P]
{ (left brace) [GOLD]+[Q]
} (right brace) [GOLD]+[R]
’ (single quote) [GOLD]+[S]
” (double quote) [GOLD]+[T]
\ (backslash) [GOLD]+[U]
= (equal) [GOLD]+[V]
< (left angle bracket) [GOLD]+[W]
> (right angle bracket) [GOLD]+[X]
~ (tilde) [GOLD]+[Y]
| (vertical bar) [GOLD]+[Z]
! (exclamation mark) [GOLD]+[SP]
‘ (grave accent) [GOLD]+[7]
| (piping symbol) [GOLD]+[8]
¢ (cent) [GOLD]+[9]
. (period) [GOLD]+[5]
(not symbol) [GOLD]+[6]
5250 Terminal Emulation Programmer’s Reference Guide 3 -9
Page 60
SECTION 3 " RT1100 Radio Terminal
Special Function Keys
Special function keys are:
" AID-generating keys
" Cursor movement keys
" Field Exit key
" Signal keys
" Special control keys
" Special host keys
The following pages describe special function keys on the
RT1100 Radio Terminal. For complete descriptions refer to
the appropriate IBM 5250 functions reference manual.
AID-Generating Keys
AID-generating keys generate AID codes that go in the display data stream to the host system. They alert the host
system that the controller requires some action.
The RT1100 Radio Terminal emulates all of the AID-generating keys on a 5291 Display Station. Table 3-2 lists key
sequences.
3-10 5250 Terminal Emulation Programmer’s Reference Guide
Page 61
SECTION 3 " RT1100 Radio Terminal
Table 3-2
RT1100 AID-Generating Keys
5291 AID Key Press Description
Clear [BLACK]+[1] The system environment determines the
results of this key. If the radio terminal
is in session, [CLEAR] issues the AID
code hex BD, which requests that the
host system issue a Clear Unit command
to the RT1100 to clear the display. If not
in session, [CLEAR] clears the entire
display regeneration buffer.
Enter/Rec Adv [ENTER] Enters information.
Help (nonerror state) [BLACK]+[2] Issues a hex F3 AID byte to the host sys-
tem.
F1-- F24 [BLACK]+[A] --
User-defined command functions.
[BLACK]+[X]
Print [BLACK]+[8] Tells the controller that the operator
wants to print the contents of the pres-
ent display. Issues hex F6 to the host
system.
Record Backspace
(Home)
[BLACK]+[SP] When pressed with the cursor in the
home position, a record backspace is re-
quested. The AID code hex F8 and cur-
sor address are sent to the host system.
Roll - (Roll up/
Page down)
Roll ¯ (Roll down/
Page up)
[BLACK]+[6] Rolls display down one page; issues AID
code hex F5.
[BLACK]+[9] Rolls display up one page; issues AID
code hex F4.
5250 Terminal Emulation Programmer’s Reference Guide 3 -11
Page 62
SECTION 3 " RT1100 Radio Terminal
Cursor Movement Keys
The four cursor control keys at the top of the keyboard
move the cursor within the screen buffer . Each key moves
the cursor in the direction indicated by the arrow.
Cursor left and right move the cursor one character position
at a time in the display buffer . The cursor up and down
keys move the cursor up or down one line. The screen mode
governs how the radio terminal represents this movement.
Attempting to move the cursor off the screen in any direction causes the window to shift in the direction of movement. This feature allows you to move the viewing window
around within the larger 5291 Display Station’s 80-character by 24-line screen (Figure 3-2).
INDOW DISPL
S THE TERMI
TO VIEW ANY
E ACTUAL 52
O MOVE ABOU
THE WINDOW DISPLAY MODE
ALLOWS THE TERMINAL
USER TO VIEW ANY PART
OF THE ACTUAL 5291 SCREEN
AND TO MOVE ABOUT THE
5291 SCREEN USING THE
CURSOR CONTROL KEY.
Figure 3-2
RT1100 Windowing Mode
3-12 5250 Terminal Emulation Programmer’s Reference Guide
RT1100 Radio Terminal
5291 Display Station
Page 63
SECTION 3 " RT1100 Radio Terminal
Cursor location is not limited to the current window. All
cursor movement keys (for example, Field Exit, New Line,
and the cursor keys) respond just as they would on the
80x24 display. For example, when you press the [FIELD +]
key and the next field is outside the current window, the
window moves to the new location.
Use the cursor control keys in combination with [BLACK]
and [GOLD] to move through the radio terminal’s display a
single space at a time or eight spaces at a time. The following chart shows key combinations.
To Press
Move 8 spaces right
Move 8 spaces left
Move 8 spaces up
Move 8 spaces down
Move 1 space right
Move 1 space left
Move 1 space up
Move 1 space down
[BLACK]+["]
[BLACK]+[A]
[BLACK]+[Y]
[BLACK]+[B]
[GOLD]+["]
[GOLD]+[A]
[GOLD]+[Y]
[GOLD]+[B]
Field Exit Key
Field Exit clears to the end of the field and tabs to the next
field. The key on the RT1100 keyboard is [FIELD EXIT],
which is the brown-colored key in the lower left corner of
the keyboard.
Signal Keys
Signal keys cause a Signal command to go from the controller to the host system. Signal keys are Attn and Help
(Table 3-3).
5250 Terminal Emulation Programmer’s Reference Guide 3 -13
Page 64
SECTION 3 " RT1100 Radio Terminal
5291 Signal Key Press Description
Attn [BLACK]+[3] The operator presses this key
Help (from
error state)
Special Control Keys
Table 3-3
RT1100 Signal Keys
to alert the host system that
the function requested (for
example, [ENTER]) is not
being honored. Attn is valid
when the keyboard is locked or
unlocked. It does not change
the keyboard state or the cursor location.
[BLACK]+[2] The operator uses this key to
request that the host system
send data about the error to
the display.
Use the special control keys (Table 3-4) to change operatorgenerated information in the radio terminal’s display. The
keys do not work when the keyboard is locked.
Table 3-4
RT1100 Special Control Keys
5291 Special
Control Key Press Description
Del
Display mode (None) You must set the radio
3-14 5250 Terminal Emulation Programmer’s Reference Guide
[BLACK]+[¬]
Deletes the character in
the position where the
cursor was located. All
remaining characters in
the field shift to the left
to fill the column.
terminal’s display contrast through the firmware menus.
Page 65
SECTION 3 " RT1100 Radio Terminal
Table 3-4 (Continued)
RT1100 Special Control Keys
5291 Special
Control Key DescriptionPress
Erase Input [BLACK]+[4] Clears all fields to nulls,
and the cursor moves to
the first input field.
Error Reset [RESET] Restores the original
data on the error line of
the display and resets
the state.
Hex [BLACK]+[Z] Enters hexadecimal
codes from the keyboard
to generate any EBCDIC
characters needed for
input or display.
Home [BLACK]+[SP] Moves the cursor to the
position specified by the
insert cursor (IC)
address.
Insert [BLACK]+[5] Sets or turns off the
insert mode for the input
field the operator has
the cursor in. The operator must reset the
insert state before exiting it, by either pressing
[RESET] or [Insert]
again.
Shift Lock [BLACK]+[GOLD] Puts the keyboard into
shift lock mode.
Alternate cursor (None) You must change the
cursor type through the
firmware menus.
Display cursor
location
(None) The radio terminal does
not support this feature.
On the 5291 keyboard, it
displays the cursor location.
5250 Terminal Emulation Programmer’s Reference Guide 3 -15
Page 66
SECTION 3 " RT1100 Radio Terminal
Special Host Keys
Special host keys are Sys Req and Test Request (Table 3-5).
5291 Special
Host Key Press Description
Sys Req [BLACK]+[7] Data on the error line is saved,
Test Request (None) The radio terminal does not
Table 3-5
RT1100 Special Host Keys
the error line is cleared, a column separator and underscore
field attribute are supplied to
column 1 of the error line, and
the cursor is located under column 2 to begin polling keystrokes.
support Test Request.
Other Keys
Table 3-6 lists other radio terminal keys and their operations.
3-16 5250 Terminal Emulation Programmer’s Reference Guide
Page 67
SECTION 3 " RT1100 Radio Terminal
Table 3-6
Other RT1100 Keys and Operations
Operation Press Description
Backspace
[¬]
Moves cursor one space to
the left.
Menu [GOLD]+
[BLACK]
Brings up the radio terminal’s main menu and firmware parameters.
Dup (duplicate
enabled fields only)
[BLACK]+[0] Controller repeats hex
“1C” from the cursor position to the end of the field.
This shows in the display
as an overstruck asterisk.
(New Line) [BLACK]+[Y] Moves cursor to beginning
of next field.
Field-- [BLACK]+
[BROWN]
For numeric fields, makes
the input a negative number.
Field+ [GOLD]+
[BROWN]
Advances cursor to the
next input field. For
numeric fields, makes the
input a positive number.
Forward Tab Forward tabs.
Reverse Tab Reverse tabs.
Backlight [GOLD]+[0] Toggles the display’s back-
light on and off.
You can also use the keyboard to key ahead and scan ahead
operations.
5250 Terminal Emulation Programmer’s Reference Guide 3 -17
Page 68
SECTION 3 " RT1100 Radio Terminal
Key Ahead
Key ahead stores keystrokes after the Input Inhibited
annunciator appears, and saves them for the next input
field. The Input Inhibited annunciator appears on the status line while the radio terminal is waiting for the host to
respond. Key ahead is enabled as a default but can be disabled through the radio terminal’s firmware.
Scan Ahead
Scan ahead stores one bar code after the Input Inhibited
annunciator appears, and saves it for the next input field.
The Input Inhibited annunciator appears on the status line
while waiting for the host to respond.
System Messages
The radio terminal’s display reserves a line for status information. The status line can display system (nonlocal)
information such as a message waiting from the host computer , help messages in response to the [HELP] key, or the
system request state of the radio terminal.
System codes can also appear on the status line. System
messages and codes are described in Section 8, “Display
Data Stream.”
3-18 5250 Terminal Emulation Programmer’s Reference Guide
Page 69
Section 4
RT1700 Radio Terminal
" " " " " " " " " " " " " " " " " " " " " " " " " " " "
Overview
The RT1700 Radio Terminal is designed to appear to the
host computer as an IBM 5291 Display Station. To help the
system programmer design interfaces to the radio terminal,
this section describes the screen size, screen modes, annunciators, keyboards, and IBM display emulation for the radio
terminal as part of the 5250 data stream.
"
NOTE: Radio terminals in the RT1700 Series have UHF, 900 MHz, or WLIF
radio modules.
RT1700 Radio Terminals are compatible with RT3210 (UHF
radio only), RT1100, and RT5900 Radio Terminals; and
PEN*KEYR6400 Computers (900 MHz and WLIF only).
This lets the RT1700 Radio Terminal work interchangeably
with other wireless stations on a network.
You can set up the radio terminal through its firmware
menus or from the host through the Set Parameters extended command. Extended commands are described in
Section 9. For information about firmware menus, refer to
the radio terminal’s user guide.
5250 Terminal Emulation Programmer’s Reference Guide 4 -1
Page 70
SECTION 4 " RT1700 Radio Terminal
Screen Size
The RT1700 Radio Terminal has a supertwist, liquid crystal
display with 12, 17, 22, or 26 characters per line by 4, 6, 8,
10, 12, 15, or 21 lines. You can set the screen size through
the radio terminal’s firmware menus.
The display shows radio terminal and host computer
prompts, as well as data entered by the operator. Because a
5291 Display Station has a screen size of 80 characters by
24 lines, the radio terminal presents a part of the information on the larger display station.
Screen Modes
The radio terminal has these screen modes: center cursor ,
corner , page, lazy, and locked. The modes present a window
onto a standard 5291 Display Station’s 80-character by
24-line display buffer . You can set the type of screen mode
through the radio terminal’s firmware menus.
The screen modes govern which portion of the larger 5291
Display Station’s screen the radio terminal first presents
and how the window moves as the cursor moves.
Center Cursor Mode
Center cursor mode works best for applications that use the
entire 5250 data stream’s 80-character by 24-line logical
display. In this mode, the cursor remains in the center of
the radio terminal’s window.
As the cursor moves within the window, the radio terminal’s
display window moves to keep it centered. When the cursor
moves off the right, left, top, or bottom edge of the larger
80x24 display, the window remains fixed despite the cursor’ s movement.
4-2 5250 Terminal Emulation Programmer’s Reference Guide
Page 71
SECTION 4 " RT1700 Radio Terminal
Corner Mode
Corner mode begins with the window in the upper left corner of the larger 5291 Display Station. It keeps the cursor
in the lower right corner of the display. Corner mode works
best for applications that use the upper left corner of the
logical screen.
As the cursor moves off the right or bottom edge of the radio
terminal’s display, the window moves to show the cursor.
When you use corner mode with the gold-colored key, you
can move the cursor a predetermined number of key presses
in all four directions.
Page Mode
Page mode provides predefined pages within the larger
5291 Display Station. The size of these pages depends on
the number of rows and columns selected for display. The
radio terminal moves the window by a multiple of the page
size. As the cursor moves off the edge of the radio terminal’s display, the window changes to the next page.
Lazy Mode
Lazy mode starts the cursor in the upper left corner of the
display. The cursor moves across the display in the scrolled
direction. When the cursor goes beyond the edge of the display, the data begins to move in the scrolled direction and
the cursor remains at the edge of the display. When you try
to move the cursor beyond an outside boundary, an error
tone sounds.
5250 Terminal Emulation Programmer’s Reference Guide 4 -3
Page 72
SECTION 4 " RT1700 Radio Terminal
Locked Mode
If locked mode is selected through the firmware menus, the
view window is locked to the upper left-hand corner of the
display. The screen does not window around, and only the
area that has been selected to be the screen size is visible.
Locked mode disables the windowing keys, or only allows
you to window around the physical display size selected
through the firmware menus. Locked mode also moves the
error line to the last position in the display.
Annunciators
The RT1700 Radio Terminal’ s display reserves a location for
icons or small pictures, called “annunciators,” which show
the radio terminal’s current status or operation in progress.
The following annunciators can appear in the radio terminal’s display.
T
X
C
L
Y
4-4 5250 Terminal Emulation Programmer’s Reference Guide
The radio terminal is transmitting information to
the base radio.
Communications loss. The radio terminal cannot
communicate with the host computer. The radio terminal may be out of radio range, the base radio may
not have power, or communication from the host to
the access point may not be properly set up.
The radio terminal’s keyboard is in shift mode. The
letter key you press while the keyboard is in this
mode types the letter in uppercase.
Page 73
SECTION 4 " RT1700 Radio Terminal
A
"
X
The radio terminal’s keyboard is in black shift
mode. The key you press while the keyboard is in
this mode does the operation printed in black on the
overlay and to the upper left of the key.
The radio terminal’s keyboard is in gold shift
mode. The key you press while the keyboard is in
this mode types the special character or does the
operation printed in gold on the overlay and to the
upper right of the key.
Input inhibited. The keyboard has accepted
enough information for the defined input field. The
“key ahead” feature stores keystrokes after this
annunciator appears. These are saved for the next
field.
Insert mode. The keyboard inserts characters
instead of overwriting them.
Message waiting. The host has a message waiting for the radio terminal operator.
C
+
--
The battery is charging.
The battery needs to be recharged. When this
annunciator appears, you will not be able to operate
your radio terminal until you place it on a charger.
S
C
A
N
Laser scanner is in use. This annunciator ensures
you are aware of the laser scanner and the cautions
you must exercise. Read and obey the caution
labels on your laser scanner so that you do not
injure your eyes.
5250 Terminal Emulation Programmer’s Reference Guide 4 -5
Page 74
SECTION 4 " RT1700 Radio Terminal
Keyboard
The RT1700 Radio Terminal has either a standard 57-key
keyboard or a 37-key keyboard.
57-Key Keyboard
The 57-key keyboard (Figure 4-1) has shift keys, alphabetic
keys, numeric keys, special characters, special function
keys, and keys that do other operations.
37-Key Keyboard
The 37-key keyboard (Figure 4-2) has standard numeric
keys, an [ENTER] key, and user-defined function keys in its
primary plane. It has alphabetic keys in its secondary
plane, and the special character
“ . ” (period).
Because a radio terminal with a 37-key keyboard does not
have alphabetic keys, follow these procedures when using
its firmware and downloading software to it:
" To access password-protected menus, press [F12] and
then [F11], and then enter the password. For example, the password for the SET-UP PARMS menu is
52401.
" To initiate the COLD START? menu option, press
[F10] to answer “yes.”
" To download software, hold down the [F1] key as you
power up the radio terminal to go into download mode.
This is similar to holding down the [I] key on the standard 57-key keyboard.
4-6 5250 Terminal Emulation Programmer’s Reference Guide
Page 75
SECTION 4 " RT1700 Radio Terminal
®¬
W
W
SCAN W W
ON/OFF
RESET
F9 F19F11F18F10F17
F1 F3F2 F4
F13 F15F14
F21
SHIFT
F5 F7F6 F8
@ -- + (
F22
F23
A B C D E
)
# * % /
F G H I J
&
;
,
: ?
K L M N O
_
{ }
’ ”
P Q R S T
\
=
< >
U V W X Y
HEX HOME
I
Z
SYS REQ PRINT
!
SP
‘
DEL MENU
ROLL
|
7 8 9
.
ERASE INPUT INSERT
ROLL
4 5 6
F16
F20F12
F24
$
~
341-232-002 5250
¢
CLEAR HELP ATTN
1 2 3
FIELD-- FIELD+ DUP
0
FIELD EXIT
RT1700 SERIES
Figure 4-1
RT1700 57-Key Keyboard
5250 Terminal Emulation Programmer’s Reference Guide 4 -7
ENTER
Unlabeled key colors:
Black
Gold
Brown
Page 76
SECTION 4 " RT1700 Radio Terminal
®¬
W W SCAN W W
ON/OFF
A B C D
E F G H
RESET
SHIFT
F13 F14 F15 F16
F17 F18 F19 F20
Y
HEX Z DUP
.
F5 F6 F7 F8
F21 F22 F23 F24
I J K L
M N
DEL
MENUHOME
SP
SYS REQ PRINT
O P Q
7 8 9
ERASE INPUT INSERT
R S T
4 5 6
CLEAR HELP A TTN
U V
W
1 2 3
F4F3F2F1
F12F9 F10 F11
341-243-002 5250
ROLL
ROLL
FIELD-- FIELD+
FIELD EXIT
X
0
ENTER
RT1700 SERIES
Figure 4-2
RT1700 37-Key Keyboard
4-8 5250 Terminal Emulation Programmer’s Reference Guide
Unlabeled key colors:
Black
Gold
Brown
Page 77
Shift Keys
SECTION 4 " RT1700 Radio Terminal
Use the shift keys on the 57- and 37-key keyboards to type
uppercase letters and special characters, and to do special
functions. Shift keys are described in the following chart.
Shift Key Description
[SHIFT] Press the [SHIFT] key plus a letter to type the
letter in uppercase. The [SHIFT] key is located
near the top of the keyboard.
[GOLD] The gold-colored key puts the keyboard into gold
shift mode. Press [GOLD] plus a keyboard key
to type a character or do an operation printed in
gold on the overlay.
[BLACK] The black-colored key puts the keyboard into
black shift mode. Press [BLACK] plus a keyboard key to do an operation printed in black on
the overlay.
The special characters and functions printed on the overlay
are color-coded to correspond with the shift keys. For example:
" On the 57-key keyboard, to type the special character
“@” (printed in gold on the overlay), press [GOLD]+[A].
" On the 57-key keyboard, press [BLACK]+[F5] to do
the F13 function (printed in black on the overlay).
" On the 37-key keyboard, press [BLACK]+[F1] to do
the F13 function (printed in black on the overlay).
The [FIELD EXIT] key has its operation printed to the left
of it. The operation printed to the left is its unshifted value.
The operations printed above [FIELD EXIT] are the shifted
values.
5250 Terminal Emulation Programmer’s Reference Guide 4 -9
Page 78
SECTION 4 " RT1700 Radio Terminal
Alphabetic Keys
On the 57-key keyboard, press a letter without first pressing [SHIFT] to type a lowercase letter . Press [SHIFT] plus
a letter to type the letter in uppercase. For example,
[SHIFT]+[A] types a capital “A.”
Table 4-1 describes how to type letters on the 37-key
keyboard.
Letter Press (37-Key Keyboard)
A--L [SHIFT]+[F1] -- [SHIFT]+[F12]
M [SHIFT]+[SP]
N
O--W [SHIFT]+[7] -- [SHIFT]+[3]
X [SHIFT]+[0]
Y [SHIFT]+[ . ]
Z
a--l [BLACK]+[F1] -- [BLACK]+[F12]
m [BLACK]+[SP]
n
o--w [BLACK]+[7] -- [BLACK]+[3]
x [BLACK]+[0]
y [BLACK]+[ . ]
z
Table 4-1
RT1700 Letters, 37-Key Keyboard
[SHIFT]+[¬]
[SHIFT]+[ ]
[BLACK]+[¬]
[BLACK]+[ ]
To lock the keyboard into shift mode, press
[BLACK]+[GOLD]. To unlock the keyboard, press
[BLACK]+[GOLD] again. The annunciator of a triangle
pointing up means the keyboard is in shift mode.
4-10 5250 Terminal Emulation Programmer’s Reference Guide
Page 79
Numeric Keys
Numeric keys are arranged in a 10-key format on the bottom half of the 57- and 37-key keyboards. Use the numbers
to enter numeric data.
Special Characters
Table 4-2 describes how to type special characters on the
57-key keyboard. The special character available on the
37-key keyboard is a “ . ” (period).
Special Character Press (57-Key Keyboard)
@ (at) [GOLD]+[A]
-- (minus) [GOLD]+[B]
+ (plus) [GOLD]+[C]
( (left parenthesis) [GOLD]+[D]
$ (dollar) [GOLD]+[E]
) (right parenthesis) [GOLD]+[F]
# (pound) [GOLD]+[G]
* (asterisk) [GOLD]+[H]
% (percent) [GOLD]+[I]
/ (forward slash) [GOLD]+[J]
& (ampersand) [GOLD]+[K]
; (semicolon) [GOLD]+[L]
, (comma) [GOLD]+[M]
: (colon) [GOLD]+[N]
? (question mark) [GOLD]+[O]
_ (underscore) [GOLD]+[P]
{ (left brace) [GOLD]+[Q]
SECTION 4 " RT1700 Radio Terminal
Table 4-2
RT1700 Special Characters
5250 Terminal Emulation Programmer’s Reference Guide 4 -11
Page 80
SECTION 4 " RT1700 Radio Terminal
Special Character Press (57-Key Keyboard)
} (right brace) [GOLD]+[R]
’ (single quote) [GOLD]+[S]
” (double quote) [GOLD]+[T]
\ (backslash) [GOLD]+[U]
= (equal) [GOLD]+[V]
< (left angle bracket) [GOLD]+[W]
> (right angle bracket) [GOLD]+[X]
~ (tilde) [GOLD]+[Y]
| (vertical bar) [GOLD]+[Z]
! (exclamation mark) [GOLD]+[SP]
‘ (grave accent) [GOLD]+[7]
| (piping symbol) [GOLD]+[8]
¢ (cent) [GOLD]+[9]
. (period) [GOLD]+[5]
(not symbol)
Table 4-2 (Continued)
RT1700 Special Characters
[GOLD]+[6]
Special Function Keys
Special function keys are:
" AID-generating keys
" Cursor movement keys
" Field Exit key
" Signal keys
" Special control keys
" Special host keys
4-12 5250 Terminal Emulation Programmer’s Reference Guide
Page 81
SECTION 4 " RT1700 Radio Terminal
The following pages briefly describe the special function
keys on the RT1700 Radio Terminal. For complete descriptions, refer to the appropriate IBM 5250 functions reference
manual.
AID-Generating Keys
AID-generating keys generate AID codes that go in the display data stream to the host system. They alert the host
system that the controller requires some action. Table 4-3
shows key combinations.
Table 4-3
RT1700 AID-Generating Keys
57-Key
5291 AID Key
F1 -- F8 [F1] -- [F8] [F1] -- [F8] User-defined function.
F9 -- F12 [BLACK]+[F1] --
F13 -- F16 [BLACK]+[F5] --
F17 -- F24 [GOLD]+[F1] --
Clear [BLACK]+[1] [GOLD]+[1] The system environment
Keyboard
[BLACK]+[F4]
[BLACK]+[F8]
[GOLD]+[F8]
37-Key
Keyboard Description
[F9] -- [F12] User-defined function.
[GOLD]+[F1] -[GOLD]+[F4]
[GOLD]+[F5] -[GOLD]+[F12]
User-defined function.
User-defined function.
determines the results of
this key. If the radio terminal is in session, it
issues the AID code hex
BD, which requests that
the host system issue a
Clear Unit command to
the RT1700 to clear the
display. If not in session,
[CLEAR] clears the entire
display regeneration
buffer.
5250 Terminal Emulation Programmer’s Reference Guide 4 -13
Page 82
SECTION 4 " RT1700 Radio Terminal
Table 4-3 (Continued)
RT1700 AID-Generating Keys
57-Key
5291 AID Key Description
Enter/Rec Adv [ENTER] [ENTER] Enters information.
Help
(nonerror state)
Print [BLACK]+[8] [GOLD]+[8] Tells the controller that
Record
Backspace(Home)
Roll - (Roll up/
Page down)
Roll ¯ (Roll down/
Page up)
Keyboard
[BLACK]+[2] [GOLD]+[2] Issues a hex F3 AID byte
[BLACK]+[SP] [GOLD]+[SP] When pressed with the
[BLACK]+[6] [GOLD]+[6] Rolls display down one
[BLACK]+[9] [GOLD]+[9] Rolls display up one page;
37-Key
Keyboard
to the host system.
the operator wants to
print the contents of the
present display. Issues
hex F6 to the host system.
cursor in the home position, a record backspace is
requested. The AID code
hex F8 and cursor address
are sent to the host system.
page; issues AID code hex
F5.
issues AID code hex F4.
Cursor Movement
The four cursor control keys at the top of the keyboard
move the cursor within the screen buffer . Each key moves
the cursor in the direction indicated by the arrow.
4-14 5250 Terminal Emulation Programmer’s Reference Guide
Page 83
SECTION 4 " RT1700 Radio Terminal
Cursor left and right move the cursor one character position
at a time in the display buffer . The cursor up and down
keys move the cursor up or down one line. The screen mode
governs how the radio terminal represents this movement.
Attempting to move the cursor off the screen in any direction causes the window to shift in the direction of movement. This feature allows you to move the viewing window
around within the larger 5291 Display Station’s 80-character by 24-line screen (Figure 4-3).
INDOW DISPL
S THE TERMI
TO VIEW ANY
E ACTUAL 52
O MOVE ABOU
THE WINDOW DISPLAY MODE
ALLOWS THE TERMINAL
RT1700 Radio Terminal
USER TO VIEW ANY PART
OF THE ACTUAL 5291 SCREEN
AND TO MOVE ABOUT THE
5291 SCREEN USING THE
CURSOR CONTROL KEY.
5291 Display Station
Figure 4-3
RT1700 Windowing Mode
5250 Terminal Emulation Programmer’s Reference Guide 4 -15
Page 84
SECTION 4 " RT1700 Radio Terminal
Cursor location is not limited to the current window. All
cursor movement keys (for example, Field Exit, New Line,
and the cursor keys) respond just as they would on the
80x24 display. For example, when you press the [FIELD+]
key and the next field is outside the current window, the
window moves to the new location.
Use the cursor control keys in combination with [BLACK]
and [GOLD] to move through the radio terminal’s display a
single space at a time or eight spaces at a time. The following chart shows key combinations for the 57- and 37-key
keyboards.
To Press
Forward tab
Reverse tab
Move 8 spaces right
Move 8 spaces left
Move 8 spaces up
Move 8 spaces down
Move 1 space right
Move 1 space left
Move 1 space up
Move 1 space down
[GOLD]+["]
[GOLD]+[A]
[BLACK]+["]
[BLACK]+[A]
[BLACK]+[Y]
[BLACK]+[B]
[GOLD]+["]
[GOLD]+[A]
[GOLD]+[Y]
[GOLD]+[B]
Field Exit
Field Exit clears to the end of the field and tabs to the next
field. The key on the RT1700 keyboard is [FIELD EXIT],
which is the brown-colored key in the lower left corner of
the 57- and 37-key keyboards.
4-16 5250 Terminal Emulation Programmer’s Reference Guide
Page 85
SECTION 4 " RT1700 Radio Terminal
Signal Keys
Signal keys cause a Signal command to go from the controller to the host system. Signal keys are Attn and Help.
Table 4-4 shows key combinations.
Table 4-4
RT1700 Signal Keys
5291 Signal
Key
Attn [BLACK]+[3] [GOLD]+[3] The operator presses this key to
Help (from
error state)
57-Key
Keyboard
[BLACK]+[2] [GOLD]+[2] The operator uses this key to request
37-Key
Keyboard Description
alert the host system that the function requested (for example,
[ENTER]) is not being honored.
Attn is valid when the keyboard is
locked or unlocked. It does not
change the keyboard state or the
cursor location.
that the host system send data about
the error to the display.
Special Control Keys
Use the special control keys to change operator-generated
information in the radio terminal’s display. The keys do not
work when the keyboard is locked. Table 4-5 shows key
combinations.
5250 Terminal Emulation Programmer’s Reference Guide 4 -17
Page 86
SECTION 4 " RT1700 Radio Terminal
Table 4-5
RT1700 Special Control Keys
5291 Special
Control Key
Del
57-Key
Keyboard
37-Key
Keyboard Description
[BLACK]+[¬] [GOLD]+[¬]
Deletes the character in
the position where the cur-
sor was located. All
remaining characters in
the field shift to the left to
fill the column.
Display Mode None None You must set the radio ter-
minal’s display contrast
through the firmware me-
nus.
Erase Input [BLACK]+[4] [GOLD]+[4] Clears all fields to nulls,
and the cursor moves to
the first input field.
Error Reset [BLACK]+
[SHIFT]
[BLACK]+
[SHIFT]
Restores the original data
on the error line of the dis-
play and resets the state.
Hex [BLACK]+[Z] [GOLD]+[ . ] Enters hexadecimal codes
from the keyboard to gen-
erate any EBCDIC charac-
ters needed for input or
display.
Home [BLACK]+[SP] [GOLD]+[SP] Moves the cursor to the
position specified by the
insert cursor (IC) address.
Insert [BLACK]+[5] [GOLD]+[5] Sets or turns off the insert
mode for the input field
the operator has the cur-
sor in. The operator must
reset the insert state
before exiting it, by either
pressing [RESET] or
[Insert] again.
Shift Lock [BLACK]+
[GOLD]
[BLACK]+
[GOLD]
Puts the keyboard into
shift lock mode.
4-18 5250 Terminal Emulation Programmer’s Reference Guide
Page 87
SECTION 4 " RT1700 Radio Terminal
Table 4-5 (Continued)
RT1700 Special Control Keys
5291 Special
Control Key Description
Alternate cursor (None) (None) You must change the cur-
Display cursor
location
57-Key
Keyboard
(None) (None) The radio terminal does
37-Key
Keyboard
sor type through the firm-
ware menus.
not support this feature.
On the 5291 keyboard, it
displays the cursor loca-
tion.
Special Host Keys
Special host keys are Sys Req and Test Request. Table 4-6
shows key combinations.
Table 4-6
RT1700 Special Host Keys
5291 Special
Host Key
Sys Req [BLACK]+[7] [GOLD]+[7] Data on the error line is saved, the
Test Request (None) (None) The radio terminal does not support
57-Key
Keyboard
37-Key
Keyboard Description
error line is cleared, a column separator and underscore field attribute
are supplied to column 1 of the error
line, and the cursor is located under
column 2 to begin polling keystrokes.
Test Request.
5250 Terminal Emulation Programmer’s Reference Guide 4 -19
Page 88
SECTION 4 " RT1700 Radio Terminal
Other Keys
Table 4-7 lists other radio terminal keys and their operations.
Other RT1700 Keys and Operations
Table 4-7
57-Key
Operation
Backspace
Menu [GOLD]+
Dup (duplicate
enabled fields
only)
(New Line)
Field-- [BLACK]+
Field+ [GOLD]+
Backlight [GOLD]+[0] [GOLD]+[0] Toggles the display’s backlight
Keyboard
[¬] [¬]
[BLACK]
[BLACK]+[0] [GOLD]+ [ ] Controller repeats hex 1C from
[BLACK]+[Y]
[BROWN]
[BROWN]
37-Key
Keyboard Description
Moves cursor one space to the
left.
[GOLD]+
[BLACK]
[ ]
[BLACK]+
[BROWN]
[GOLD]+
[BROWN]
Brings up the radio terminal’s
main menu and firmware
parameters.
the cursor position to the end of
the field. This shows in the display as an overstruck asterisk.
Moves cursor to beginning of
next field.
For numeric fields, makes the
input a negative number.
Advances cursor to the next
input field. For numeric fields,
makes the input a positive number.
on and off.
4-20 5250 Terminal Emulation Programmer’s Reference Guide
Page 89
SECTION 4 " RT1700 Radio Terminal
You can also use the keyboard to do key ahead, scan ahead,
and repeat key operations.
Key Ahead
Key ahead stores keystrokes after the Input Inhibited annunciator appears, and saves them for the next input field.
The Input Inhibited annunciator appears on the status line
while the radio terminal is waiting for the host to respond.
Key ahead is enabled as a default but can be disabled
through the radio terminal’s firmware.
Scan Ahead
Scan ahead stores one bar code after the Input Inhibited
annunciator appears, and saves it for the next input field.
The Input Inhibited annunciator appears on the status line
while waiting for the host to respond.
Key Repeat
Key repeat on the radio terminal’s keyboard is similar to
the key repeat on a 5291 Display Station. For example, to
fill an input field with the letter “a,” do one of the following:
" Press the “A” key repeatedly until the field is full.
" Press and hold the “A” key until the field is full.
Key repeat does not work with all keys. Table 4-8 shows
which keys do and do not repeat.
5250 Terminal Emulation Programmer’s Reference Guide 4 -21
Page 90
SECTION 4 " RT1700 Radio Terminal
Cursorcontrolkeysusedwith[BLACK]and[GOLD]
Repeating Nonrepeating
Del Attn
EBCDIC characters Backlight
Forward Tab Black Shift
New Line Clear
Reverse Tab Dup
Cursor control keys used with
Table 4-8
RT1700 Key Repeat
Enter/Rec Adv
Erase Input
Error Reset
F1--F24
Field Exit
Field-Field+
Gold Shift
Help
Hex
Home
Insert
Menu
Print
Roll - (Roll up/Page down)
Roll ¯ (Roll down/Page up)
Shift
Shift Lock
Sys Req
4-22 5250 Terminal Emulation Programmer’s Reference Guide
Page 91
System Messages
The radio terminal’s display reserves a line for status information. The status line can display system (nonlocal)
information such as a message waiting from the host computer , help messages in response to the [HELP] key, or the
system request state of the radio terminal.
System codes can also appear on the status line. System
messages and codes are described in Section 8, “Display
Data Stream.”
SECTION 4 " RT1700 Radio Terminal
5250 Terminal Emulation Programmer’s Reference Guide 4 -23
Page 92
SECTION 4 " RT1700 Radio Terminal
4-24 5250 Terminal Emulation Programmer’s Reference Guide
Page 93
Section 5
RT5900 Radio Terminal
" " " " " " " " " " " " " " " " " " " " " " " " " " " "
Overview
The RT5900 Mobile Mount Radio Terminal is designed to
appear to the host computer as an IBM 5291 Display Station. To help the system programmer design interfaces to
the radio terminal, this section describes the screen size,
screen modes, annunciators, keyboard, and IBM display
emulation for the radio terminal as part of the 5250 data
stream.
"
NOTE: Radio terminals in the RT5900 Series have UHF, 900 MHz, or WLIF
radios.
RT5900 Radio Terminals are compatible with RT3210 (UHF
radio only), RT1100, and RT1700 Radio Terminals; and
PEN*KEYR6400 Computers (900 MHz and WLIF only).
This lets the RT5900 Radio Terminal work interchangeably
with other wireless stations on a network.
You can set up the radio terminal through its firmware
menus or from the host through the Set Parameters extended command. Extended commands are described in
Section 9. For information about firmware menus, refer to
the radio terminal’s user guide.
5250 Terminal Emulation Programmer’s Reference Guide 5 -1
Page 94
SECTION 5 " RT5900 Radio Terminal
Screen Size
The RT5900 Radio Terminal has a 2.5 by 9 inch, supertwist,
liquid crystal display with 480 by 128 pixels. It can display
8, 10, 12, 16, or 25 lines and 40, 60, or 80 characters per line. You can set the screen size through the radio terminal’s
firmware menus.
The display shows radio terminal and host computer
prompts, as well as data entered by the operator. Because a
5291 Display Station has a screen size of 80 characters by
24 lines, the radio terminal presents a part of the information on the larger display station.
The RT5900 Radio Terminal is compatible with RT3210
Radio Terminals (UHF radio only), RT1100 Radio Terminals, and RT1700 Radio Terminals. This lets the RT5900
Radio Terminal work interchangeably with other radio terminals on a network. You do not need to modify your
application program. The RT5900 Radio Terminal changes
only its display for larger characters.
Screen Modes
The radio terminal has these screen modes: center cursor ,
corner , page, lazy, and locked. The modes present a window
onto a standard IBM 5291 Display Station’s 80-character by
24-line display buffer . You can set the type of screen mode
through the radio terminal’s firmware menus.
The screen modes govern which portion of the larger 5291
Display Station’s screen the radio terminal first presents
and how the window moves as the cursor moves.
5-2 5250 Terminal Emulation Programmer’s Reference Guide
Page 95
SECTION 5 " RT5900 Radio Terminal
Center Cursor Mode
Center cursor mode works best for applications that use the
entire 5250 data stream’s 80-character by 24-line logical
display. In this mode, the cursor remains in the center of
the radio terminal’s window.
As the cursor moves within the window, the radio terminal’s
display window moves to keep it centered. When the cursor
moves off the right, left, top, or bottom edge of the 5291 Display Station, the window remains fixed despite the cursor’ s
movement.
Corner Mode
Corner mode begins with the window in the upper left corner of the larger IBM 5291 Display Station. It keeps the
cursor in the lower right corner of the display. Corner mode
works best for applications that use the upper left corner of
the logical screen.
As the cursor moves off the right or bottom edge of the radio
terminal’s display, the window moves to show the cursor.
When you use corner mode with the brown-colored key, you
can move the cursor a predetermined number of key presses
in all four directions.
Page Mode
Page mode provides predefined pages within the larger IBM
5291 Display Station. The size of these pages depends on
the number of rows and columns selected for display. The
radio terminal moves the window by a multiple of the page
size. As the cursor moves off the edge of the radio terminal’s display, the window changes to the next page.
5250 Terminal Emulation Programmer’s Reference Guide 5 -3
Page 96
SECTION 5 " RT5900 Radio Terminal
Lazy Mode
Lazy mode starts the cursor in the upper left corner of the
display. The cursor moves across the display in the scrolled
direction. When the cursor goes beyond the edge of the display, the data begins to move in the scrolled direction and
the cursor remains at the edge of the display. When you try
to go beyond an outside boundary, an error tone sounds.
Locked Mode
If locked mode is selected through the firmware menus, the
view window is locked to the upper left-hand corner of the
display. The screen does not window around, and only the
area that has been selected to be the screen size is visible.
Locked mode disables the windowing keys, or only allows
you to window around the physical display size selected
through the firmware menus. Locked mode also moves the
error line to the last position in the display.
Annunciators
The RT5900 Radio Terminal’ s display reserves a location for
icons or small pictures, called “annunciators,” which show
the radio terminal’s current status or operation in progress.
You can change an annunciator’s location in the display
through the radio terminal’s firmware menus, or set the
firmware so that the annunciators do not appear . Refer to
the radio terminal’s user guide for more information.
The following annunciators can appear in the radio terminal’s display.
5-4 5250 Terminal Emulation Programmer’s Reference Guide
Page 97
SECTION 5 " RT5900 Radio Terminal
The radio terminal is transmitting information to
the base radio.
The radio terminal is receiving information from
the base radio.
Communication loss. The radio terminal cannot
communicate with the host computer. The radio terminal may be out of radio range, the base radio may
not have power, or communication from the host to
the base radio may not be properly set up.
Y
A
"
X
The radio terminal’s keyboard is in shift mode. The
letter key you press while the keyboard is in this
mode types the letter in uppercase.
The radio terminal’s keyboard is in brown shift
mode. The key you press while the keyboard is in
this mode does the operation printed in brown on the
overlay and to the upper left of the key.
The radio terminal’s keyboard is in gold shift
mode. The key you press while the keyboard is in
this mode types the special character or does the
operation printed in gold on the overlay and to the
upper right of the key.
Input inhibited. The keyboard has accepted
enough information for the defined input field. The
“key ahead” feature stores keystrokes after this
annunciator appears. These are saved for the next
field.
Insert mode. The keyboard inserts characters
instead of overwriting them.
Message waiting. The host has a message waiting for the radio terminal operator.
5250 Terminal Emulation Programmer’s Reference Guide 5 -5
Page 98
SECTION 5 " RT5900 Radio Terminal
Keyboard
The radio terminal’s 47-key keyboard (Figure 5-1) has shift
keys, alphabetic keys, numeric keys, special characters,
special function keys, and keys that do other operations.
5-6 5250 Terminal Emulation Programmer’s Reference Guide
Page 99
SECTION 5 " RT5900 Radio Terminal
‘
3
|
2
PRINT FIELD-
!
1
SYS REQ
6
FIELD+
8 9
54
HELP ATTN
ER INPUT INSERT
CLEAR
ENTER
7
0
DUP
SPACE
EXI
T
F
IEL
D
RESET
S
HIF
T
HOME
#
,
)
; :
$
(
D G
/ &
+
--
@
F1 F2 F3 F4 F5 F6 F7 F8
F9 F17 F10 F18 F11 F12F19 F20 F13 F21 F14 F22 F15 F23 F16 F24
RT5900 Keyboard
%
*
A B EC F
Figure 5-1
J
I K
H L NM
DEL
\
--
”
’
}
{
_
?
SR
O P Q T U
.
|
ZWV YX
HEX MENU
~
>
= <
Brown
Gold
Unlabeled key colors:
5250 Terminal Emulation Programmer’s Reference Guide 5 -7
Page 100
SECTION 5 " RT5900 Radio Terminal
Shift Keys
Use the shift keys to type uppercase letters and special
characters, and to do special functions. Shift keys are described in the following chart.
Shift Key Description
[SHIFT] Press [SHIFT] plus a letter to type the letter in
[BROWN] The brown-colored key puts the keyboard into
[GOLD] The gold-colored key puts the keyboard into gold
uppercase.
brown shift mode. Press the [BROWN] key plus
a keyboard key to do an operation printed in
brown on the overlay.
shift mode. Press the [GOLD] key plus a keyboard key to type a special character or do an
operation printed in gold on the overlay.
The special characters and functions printed on the overlay
are color-coded to correspond with the shift keys. For example:
" To type the special character “@” (printed in brown on
the overlay), press [BROWN]+[A].
" Press [BROWN]+[F1] to do the [F9] function (printed
in brown on the overlay).
" Press [GOLD]+[F1] to do the [F17] function (printed in
gold on the overlay).
When you press [SHIFT], [BROWN], or [GOLD], an annunciator in the display indicates the current shift mode.
Three of the keys on the keyboard — [FIELD EXIT], [RESET], and [SHIFT] — have their operations printed to the
right of them. The operations printed to the right are the
unshifted values. The operations printed above [RESET]
and [SHIFT] are the shifted values. [FIELD EXIT] does not
have a shifted value.
5-8 5250 Terminal Emulation Programmer’s Reference Guide
Loading...