Intermec Norand 6920 Reference Manual

NorandR 6920 Communications Server
REFERENCE MANUAL
""""""""""""""""""""""""""""
P/N: 977-021-001
Revision B
" NOTICE The information contained herein is proprietary and is provided solely for the
purpose of allowing customers to operate and service Intermec manufactured equipment and is not to be released, reproduced, or used for any other purpose without written permission of Intermec.
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
ANTARES, INTERMEC, NORAND, NOR*WARE, PEN*KEY, ROUTEPOWER, TRAKKER, and TRAKKER ANTARES are registered trademarks and ENTERPRISE WIRELESS LAN, INCA, TE 2000, UAP, and UNIVERSAL ACCESS POINT are trademarks of Intermec Technologies Corporation.
1998 Intermec Technologies Corporation. All rights reserved.
This publication printed on recycled paper.
Acknowledgments
AS/400, IBM, IBM PC, Micro Channel, PS/2, and OS/2 are registered trademarks and AIX and Presentation Manager are trademarks of International Business Machines Corporation.
DigiBoard is a registered trademark of Digi International Inc.
FTP Software is a registered trademark of FTP Software, Inc.
Hayes is a registered trademark of Hayes Microcomputer Products Inc.
Microsoft, MS, and MSĆDOS, and Windows, are registered trademarks and Visual Basic for Windows, and Windows for Pen are trademarks of Microsoft Corporation.
NorandR 6920 Communications Server Reference Manual i
CONTENTS
""""""""""""""""""""""""""""
SECTION 1
Introduction
Overview 1Ć1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Improvements 1Ć3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
About this Manual 1Ć4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Other Helpful Manuals and Guides 1Ć6. . . . . . . . . . . . . . . . . . .
Customer Support 1Ć6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Customer Response Center 1Ć6. . . . . . . . . . . . . . . . . . . . . . .
Web Site 1Ć7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Bulletin Board Service 1Ć7. . . . . . . . . . . . . . . . . . . . . . . . . . . .
SECTION 2
Communication with Client Computers
Booting HandĆHeld Computers 2Ć2. . . . . . . . . . . . . . . . . . . . . . .
Cold Boot Capabilities 2Ć3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4000 Series Computers 2Ć3. . . . . . . . . . . . . . . . . . . . . . . . . . .
6000 Series Computers 2Ć3. . . . . . . . . . . . . . . . . . . . . . . . . . .
Initial Download Capability 2Ć4. . . . . . . . . . . . . . . . . . . . . . . . . .
Data Flow 2Ć5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Event Log 2Ć7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SECTION 3
Tutorial
Sample Set Up 3Ć1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary 3Ć2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tutorial Files 3Ć2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CONTENTS
ii NorandR 6920 Communications Server Reference Manual
Configuration 3Ć3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Communications Properties 3Ć3. . . . . . . . . . . . . . . . . . . . . . .
System Properties 3Ć4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Application Programs 3Ć7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Data Files 3Ć8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Reset Communication Settings 3Ć10. . . . . . . . . . . . . . . . . . . . . . . .
Load Application to Computer 3Ć14. . . . . . . . . . . . . . . . . . . . . . . .
Test the Communications 3Ć15. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Verify the Transactions 3Ć17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sample TEST.DAT File 3Ć17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sample PLN.DAT File 3Ć18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SECTION 4
Import Processing
Import Process 4Ć1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Concurrent Import Process 4Ć2. . . . . . . . . . . . . . . . . . . . . . . . . . .
Import Process User Directory 4Ć3. . . . . . . . . . . . . . . . . . . . . . . .
HOST.LST 4Ć4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SESSION.CTL 4Ć5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Record Format 4Ć7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Types 4Ć8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Descriptions 4Ć9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Comment (#) Command 4Ć9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Mode (M) Command 4Ć10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Request Types 4Ć10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Regular Download (Type 0) 4Ć10. . . . . . . . . . . . . . . . . . . .
Initial Download (Type 1) 4Ć10. . . . . . . . . . . . . . . . . . . . .
Clock (Type 2) 4Ć10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Program (Type 3) 4Ć10. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Host Download Status (Type 4) 4Ć11. . . . . . . . . . . . . . . .
Special Download (Type 5) 4Ć12. . . . . . . . . . . . . . . . . . . . .
Flash (Type 6) 4Ć12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Parameters 4Ć13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FLAsh 4Ć13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
VERsion 4Ć14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ZONe 4Ć14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CONTENTS
NorandR 6920 Communications Server Reference Manual iii
Terminal Identifier (T) Request Command 4Ć15. . . . . . . . . . . . .
Parameters 4Ć15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FLAsh 4Ć15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PASsword 4Ć16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
STAtus 4Ć16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
VERsion 4Ć16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ZONe 4Ć17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
/D 4Ć17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
File Identifier (F) Command 4Ć18. . . . . . . . . . . . . . . . . . . . . . . . . .
Parameters 4Ć18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TYPe 4Ć18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CREate 4Ć19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
STAtus 4Ć19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
/D 4Ć19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
/E 4Ć19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Broadcast File Identifier (B) Command 4Ć20. . . . . . . . . . . . . . . .
Parameters 4Ć20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TYPe 4Ć20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CREate 4Ć21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
STAtus 4Ć21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
/C 4Ć21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
/D 4Ć21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
/E 4Ć21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Data (D) Command 4Ć22. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Network Device Identifier (N) Command 4Ć23. . . . . . . . . . . . . .
Parameters 4Ć23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
STAtus 4Ć23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
INIt 4Ć24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ZONe 4Ć24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DIR 4Ć25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TYPe 4Ć25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
/D 4Ć25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sample SESSION.CTL File 4Ć26. . . . . . . . . . . . . . . . . . . . . . . . . . .
SECTION 5
Export Processing
Programming Notes 5Ć3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
UPLOAD.DAT 5Ć4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Export Processing the Upload File 5Ć5. . . . . . . . . . . . . . . . . . . .
Formatting Upload Data by Computer 5Ć6. . . . . . . . . . . . . . . . .
CONTENTS
iv NorandR 6920 Communications Server Reference Manual
Defining UPLXXXXX.DAT 5Ć8. . . . . . . . . . . . . . . . . . . . . . . . . . .
B" (Begin) Record 5Ć8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
D" (Data) Record 5Ć8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
E" (End) Record 5Ć8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Upload Format Control File 5Ć10. . . . . . . . . . . . . . . . . . . . . . . . . .
PL/N Upload File 5Ć10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Rectype 5Ć11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Format 5Ć11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sample Upload Format Control File 5Ć11. . . . . . . . . . . . . . .
DOS Files 5Ć13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DEX Files 5Ć13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SECTION 6
Error Messages
Error Message Format 6Ć2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System Errors 6Ć3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Windows NT Errors 6Ć40. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SECTION 7
Using Norand 6920 Controls
Related Documents 7Ć1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Automation Components 7Ć2. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation and Registration of Automation Controls 7Ć3
Exported Methods 7Ć3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ActiveX Control 7Ć5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation and Registration of 6920API.DLL 7Ć6. . . . . .
Methods, Properties, Events 7Ć7. . . . . . . . . . . . . . . . . . . . . .
Methods 7Ć7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Properties 7Ć8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Events 7Ć9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Process Values and Messages 7Ć10. . . . . . . . . . . . . . . . . . . . . . . . .
Status Values 7Ć10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Messages 7Ć11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Message Type Codes 7Ć11. . . . . . . . . . . . . . . . . . . . . . . . . .
Message Details 7Ć12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Message Sender 7Ć19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CONTENTS
NorandR 6920 Communications Server Reference Manual v
Sample Applications (Microsoft Visual C++) 7Ć20. . . . . . . . . . . .
Automation Component 7Ć20. . . . . . . . . . . . . . . . . . . . . . . . . . .
ActiveX Control 7Ć21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Adding Control to Project 7Ć21. . . . . . . . . . . . . . . . . . . . . . . . .
Using Control in Dialog 7Ć21. . . . . . . . . . . . . . . . . . . . . . . . . . .
Known Issues and Limitations 7Ć23. . . . . . . . . . . . . . . . . . . .
SECTION 8
Protocol Servers
TCP/IP 8Ć1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Components 8Ć2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TCP/IP Server Settings 8Ć2. . . . . . . . . . . . . . . . . . . . . . . . . . .
IP Address 8Ć2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Domain Name 8Ć2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Windows Client Requirements 8Ć3. . . . . . . . . . . . . . . . . . . .
DOS Client Requirements 8Ć3. . . . . . . . . . . . . . . . . . . . . . . .
Minimum System Requirements 8Ć3. . . . . . . . . . . . . . .
Computer Software 8Ć4. . . . . . . . . . . . . . . . . . . . . . . . . . .
NRInet Error Codes 8Ć6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TTY Server 8Ć13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Components 8Ć13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Settings 8Ć14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Client Specifics 8Ć20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TTY Communication Errors 8Ć20. . . . . . . . . . . . . . . . . . . . . . .
Session Status 8Ć23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TTY Communication Error Example 8Ć24. . . . . . . . . . . . . . .
NPCP Server 8Ć25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Components 8Ć25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Settings 8Ć25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Client Requirements 8Ć25. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
NPCP Communication Errors 8Ć26. . . . . . . . . . . . . . . . . . . . .
FIGURES
Figure 2Ć1 Data Flow 2Ć6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 4Ć1 Sample Import Directory Structure 4Ć3. . . . . . . . .
Figure 5Ć1 Block Diagram of Export Process 5Ć2. . . . . . . . . . .
Figure 5Ć2 B" Record Form in UPLXXXXX.DAT 5Ć9. . . . . . .
CONTENTS
vi NorandR 6920 Communications Server Reference Manual
TABLES
Table 4Ć1 Import Processing Command Types 4Ć8. . . . . . . . . .
Table 6Ć1 Standard Errors 6Ć3. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 6Ć2 Request Database Errors 6Ć3. . . . . . . . . . . . . . . . . . . .
Table 6Ć3 Activate Database Errors 6Ć6. . . . . . . . . . . . . . . . . . . .
Table 6Ć4 Download Formatting Errors 6Ć10. . . . . . . . . . . . . . . .
Table 6Ć5 Database Errors 6Ć12. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 6Ć6 NCP6920 Errors 6Ć12. . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 6Ć7 Download Request Errors 6Ć13. . . . . . . . . . . . . . . . . . .
Table 6Ć8 ISTAT Errors 6Ć14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 6Ć9 C_PLN_DATA Errors 6Ć15. . . . . . . . . . . . . . . . . . . . . . .
Table 6Ć10 C_DATA_FILE Errors 6Ć20. . . . . . . . . . . . . . . . . . . . . .
Table 6Ć11 General Purpose Program Errors 6Ć22. . . . . . . . . . .
Table 6Ć12 Bus Communications Errors 6Ć23. . . . . . . . . . . . . . . .
Table 6Ć13 4980 Async Communications Errors 6Ć26. . . . . . . . .
Table 6Ć14 Upload File Errors 6Ć28. . . . . . . . . . . . . . . . . . . . . . . . .
Table 6Ć15 Device Database Errors 6Ć29. . . . . . . . . . . . . . . . . . . .
Table 6Ć16 Modem Errors 6Ć33. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 6Ć17 Semaphore Errors 6Ć33. . . . . . . . . . . . . . . . . . . . . . . . .
Table 6Ć18 MessageAPI Queue Errors 6Ć34. . . . . . . . . . . . . . . . .
Table 6Ć19 TCP/IP Communications Errors 6Ć34. . . . . . . . . . . .
Table 6Ć20 NPCP Communications Errors 6Ć35. . . . . . . . . . . . . .
Table 6Ć21 TTY Communications Errors 6Ć36. . . . . . . . . . . . . . .
Table 6Ć22 Registry Errors 6Ć37. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 6Ć23 Class Errors 6Ć37. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 6Ć24 EM311Mgr Errors 6Ć38. . . . . . . . . . . . . . . . . . . . . . . . .
Table 6Ć25 Subsystem Errors 6Ć39. . . . . . . . . . . . . . . . . . . . . . . . .
Table 6Ć26 Request Database Errors 6Ć39. . . . . . . . . . . . . . . . . . .
Table 6Ć27 Windows NT System Errors 6Ć40. . . . . . . . . . . . . . . .
Table 7Ć1 Terminal Details 7Ć12. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 7Ć2 Terminal BOS (Beginning of Session) Details 7Ć13. .
Table 7Ć3 Terminal EOS (End of Session) Details 7Ć14. . . . . . .
Table 7Ć4 STAT Ċ Status Details 7Ć16. . . . . . . . . . . . . . . . . . . . . .
Table 7Ć5 Port Details 7Ć17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 7Ć6 Import Details 7Ć18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 7Ć7 Export Details 7Ć19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 8Ć1 NRInet Error Codes (Client Protocol) 8Ć6. . . . . . . . .
Table 8Ć2 TTY Error Type and Code 8Ć21. . . . . . . . . . . . . . . . . . .
Table 8Ć3 TTY Protocol Phase and Type Errors 8Ć22. . . . . . . . .
INDEX
NorandR 6920 Communications Server Reference Manual 1-1
Section 1
Introduction
""""""""""""""""""""""""""""
The NorandR 6920 Communications Server" by Intermec Technologies Corporation provides a flexible link between either a host computer in the central office or a depot's data processing system and the handĆheld computers used by route salespeople.
Overview
The 6920 Communications Server" is the latest new offering in the line of open systems communications and connectivity software based on Microsoft Windows NT and 95 (98). It is an evolution of the NORAND 4000 Series Communications products. The Norand 6920 Communications Server" is a storeĆandĆforward communications software server based on traditional NORAND protocols and data exchange methodologies. It is a replacement for 4920 installations, and can serve as a direct replacement for certain implementations of the 492X Telecommunications Package," 4980 and 4985 Network Controllers, and 6980/6985 Network Managers. Upgrading and migration should be relatively painless as original functionality and connectivity has been a focus of the migration.
The Norand 6920 Communications Server" is a commuĆ nications server software application. It runs on IntelĆ
Introduction SECTION 1
1-2 Norand
R
6920 Communications Server Reference Manual
based hardware platforms, Windows 95 (98) and NT operatĆ ing systems. The server provides a gateway between mobile users and the enterprise. It is a replacement for the 492X Telecommunications Packages." New technologies can have a migration path for the old systems without throwing away old applications or host system front ends.
For those migrating from the 4920 Telecommunications Packages," the list of functionality provided by the 6920 Communications Server" is essentially 4920 Telecommunications Packages" with new features of Transmission Control Protocol over Internet Protocol (TCP/IP) support, a new Graphical User Interface (GUI), and multiĆtasking to support processing of data while continuing to carry on sessions. Like the 4920 Telecommunications Packages," the 6920 Communications Server" has the ability to communicate with remote and docked devices. It is the migration path for all utilizing hardware and communications protocols.
You now have the flexibility to choose your hardware and version of operating system to meet your organizational needs. The system is decoupled and layered into modules, and has broken the monolithic mold of its predecessors. There are no longer requirements for a fixed package of DOS, proprietary communications cards with limited configurations, and proprietary networks.
EXAMPLE: A mix of several protocols can be used on the same server at the
same time without the restrictions of the “4920 Telecommunications Packages.” There are no longer limitations on the number of specific types of ports available, such as in previous releases, multiple RS-485 lines may be configured on a single “6920 Communications Server.” The system may be configured with two ports to communi­cate on a 10 Mbps Ethernet line using TCP/IP, another two on 115.2 Kbps RS-485 lines using NPCP (release 2), and another six on mo­dem lines, three at 28.8 Kbps and three more at 9600 bps both using TTY. A combination of several different models of hand-held com­puters could communicate with the “6920 Communications Server” simultaneously.
SECTION 1 Introduction
Norand
R
6920 Communications Server Reference Manual 1-3
Improvements
Several upgrades have been made to the product to improve upon the 4920 Telecommunications Package." Most visible is the user interface. Other improvements to the internal process handling and communications infrastructure have been made under the covers. You will find that the 6920 Communications Server" handles communications processes more efficiently, potentially improving throughput using the same protocols and speeds as its predecessors. Additional new processes and ways to use formatting files are available. Subsequent releases with even more features and functionally are already in the works.
System administrators and server users now have a GUI to monitor system status and user progress. Standard window views show the daily data collection activities, all system communication ports, and any associated programs that may be running, such as data formatters. Using the graphic environment of Windows NT and 95 (98), you may now spot system problems and anomalies by glancing at the operators console. The display may be customized to show the element that someone performing a specific job would want to see. All of the GUI improvements have been made using standard 32Ćbit Windows tools, so the views are flexible and configurable.
There are three major portions of the screen that may be sized for optimal viewing.
" The first addition is the window that shows active and
inactive users.
" The next window lets you view or monitor processes
and their current status to determine which of the sysĆ tem processes are set up.
Introduction SECTION 1
1-4 Norand
R
6920 Communications Server Reference Manual
" The last addition on the display is a port (channel)
monitor. It shows each of the configured ports and their current status. For instance, the system adminĆ istrator may want to watch modem ports. A view may be built that constantly monitors all of the ports with large colored icons that indicate the status of each port including information about when it was last used, the size of the transaction, and current status of that port.
The NT platform is a big plus for the 6920 CommunicaĆ tions Server." When the NORAND server software is coupled with the powerful NT Server operating system, you have the ability to use other network functions like DHCP service, file and print services, and Internet server functionĆ ally included with the operating system. The addition of Ethernet to the product line of handĆheld computers is a perfect marriage of these technologies. Existing applicaĆ tions can be converted to use the Ethernet TCP/IP functionĆ ality of the 6210, 6300 Series, and 6600 Series HandĆHeld Computers with small application changes for developers who have used the NORAND programming libraries.
About this Manual
The Norand 6920 Communications Server Reference ManuĆ al:
" Provides a tutorial that walks a user through a set up,
a Norand computer boot, a data import session, and a data export session.
" Contains detailed information on processing import
files (formatting download data) into the Norand 6920 Communications Server" system in the correct format.
" Contains detailed information on processing export
data (formatting upload data), and data placement and structure.
SECTION 1 Introduction
Norand
R
6920 Communications Server Reference Manual 1-5
Read the Norand 6920 Communications Server Installation Guide (P/N: 962Ć055Ć005), the Norand 6920 CommunicaĆ tions Server User's Guide (P/N: 961Ć021Ć014), and this referĆ
ence manual before installing software or connecting hardĆ ware components for the first time. These are also available in PDF format on the 6920 Installation CDĆROM and on the official Intermec Technologies website:
http://www.intermec.com/manuals/english.htm
This publication includes the following:
" Section 2 Ċ Communication With Client ComĆ
puters
Covers details of clientĆserver communications. It deĆ scribes the Norand 6920 Event Log."
" Section 3 Ċ Tutorial
Walks a user through the Norand 6920 CommunicaĆ tions Server" application. A sample set up is included, which demonstrates booting computers, and importing and exporting data.
" Section 4 Ċ Import Processing
Covers details of building a session control file.
" Section 5 Ċ Export Processing
Covers details of processing upload data and how to process upload data into one file per computer exĆ change. The Upload Control Format file (UPLFMT.CTL) is described for the application proĆ gram running on handĆheld computers.
" Section 6 Ċ Error Messages
Lists error messages with descriptive information to help solve problems.
" Section 7 Ċ Using Norand 6920 Controls
Defines two installation mechanisms that control the 6920 Communications engine.
" Section 8 Ċ Protocol Servers
Defines the NRInet, TTY, and NPCP communications servers.
Introduction SECTION 1
1-6 Norand
R
6920 Communications Server Reference Manual
Other Helpful Manuals and Guides
" Norand 6920 Communications Server Installation
Guide (P/N: 962Ć055Ć005) Describes the initial set up, hardware requirements and setup, and installation of the application.
" Norand 6920 Communications Server User's Guide
(P/N: 961Ć021Ć014) Describes the operation of the 6920 Communications Server" software. Other parts of the system are not described. Contact an Account Executive for details.
" Computer Program Specifications
A computer specification describes the computer apĆ plication program. It explains the PL/N file structure, needed to setup for logical record formatting (UPLFMT.CTL file). If developing a custom specificaĆ tion, this information may not be defined yet. Contact an Account Executive for details.
" Instructions for Other Modems
A modem from another company may be used. Follow its instructions when configuring the modem with the 6920 Communications Server."
Customer Support
Customer Support's onĆgoing objective is to provide quality support to all of our customers worldwide.
Customer Response Center
The Customer Response Center (technical support) telephone number is 800Ć755Ć5505 (U.S.A. or Canada) or 425Ć356Ć1799. The facsimile number is 425Ć356Ć1688. Email is support@intermec.com.
SECTION 1 Introduction
Norand
R
6920 Communications Server Reference Manual 1-7
If you email or fax a problem or question include the following information in your message: your name, your company name and address, phone number and email to respond to, and problem description or question (the more specific, the better). If the equipment was purchased through a ValueĆAdded Reseller please include that information.
Web Site
The Customer Support File Libraries, including Hot Tips and Product Awareness Bulletins, are available on the Internet. New users start at the Intemec web site: http://www.intermec.com. Choose Support," then ProdĆ uct Support," then Conference Area." Look on the main page for a link to register new customers.
A PDF version of this manual will be available at this address http://www.intermec.com/manuals/english.htm or choose Products" then Manuals" and English" from the opening page.
Bulletin Board Service
The Customer Support Bulletin Board (BBS), maintained by Intermec Technologies Corporation, provides software and documentation:
" Phone number: 319Ć369Ć3515 (14.4 Kbps modem)
319Ć369Ć3516 (28.8 Kbps modem)
" Protocol: Full duplex, ANSI or ANSIĆBBS; 300 to
28,800 bps; v.32bis; 8 bits, no parity, 1 stop bit. For
highĆspeed modems, disable XON/XOFF and enable RTS/CTS.
This is the same location available via the web site. If your web access uses highĆspeed phone lines, the web interface provides a faster response.
Introduction SECTION 1
1-8 Norand
R
6920 Communications Server Reference Manual
NorandR 6920 Communications Server Reference Manual 2-1
Section 2
Communication with Client
Computers
""""""""""""""""""""""""""""
During each communication session with the handĆheld computers, an Event Log" window in the Norand
R
6920 Communications Server" stores records containing detailed statistics about the session.
The communication session can be started or restarted and the Communication status" screen can be retrieved by seĆ lecting Communications" or Restart communications" on the System Monitor." If you are an experienced user or programmer, use the 6920 API to build your own process control application.
The 6920 Communications Server" screens show computer status messages, diagnostic information, computer exĆ change results, and physical connectors and protocols in use.
Systems Properties" controls the method for ending communication, determines whether or not to include initial download (IDL) and unscheduled terminals in the end count, and sets the diagnostic level. Default values are inserted for this window's parameters. Changes made to the default values apply to the current communication session only.
Communication with Client Computers SECTION 2
2-2 Norand
R
6920 Communications Server Reference Manual
Booting Hand-Held Computers
The 4000 and 6000 Series must have the operating system, programs, and (sometimes) data sent to them when bringĆ ing them into service for the first time. Cold boot" is the industry jargon for bringing a computer to normal operatĆ ing conditions when it has been without power. This term is adopted to describe the same process for starting our 4000 and 6000 Series Computers.
This explanation makes clear the need for a convenient method for cold booting 4000 and 6000 Series Computers. The 6920 Communications Server" meets that need. By placing the required files in the appropriate 6920 directory, computers can be booted almost as easily as dayĆtoĆday communication with them.
If 4000 Series Computers run one application program, copy the application software into the boot directory defined in System Properties." At communication time, the 6920 Communications Server" sends the only application available.
The 6000 Series applications are loaded into the download directory defined in System Properties." 6000 Series apĆ plications are commonly named according to the computer model they were created for, such as the following:
" 6100 Computers 6100IPL.INC " 6210 Computers 6200IPL.INC " 6300 Computers 6300IPL.INC
SECTION 2 Communication with Client Computers
Norand
R
6920 Communications Server Reference Manual 2-3
Cold Boot Capabilities
The 6920 Communications Server" provides protocols speĆ cifically to handle cold boot of the following:
4000 Series Computers
4000 Series coldĆbooting is provided using NPCP local comĆ puters and Ymodem protocol for remote single routes. The 4000 Series application should reside in the 6920 CommuĆ nications Server" Boot Directory defined in System ProperĆ ties."
6000 Series Computers
6000 Series coldĆbooting is provided using NPCP, NRInet, and TTY protocols. The 6000 Series application file should be placed in the Download Directory defined in System Properties."
Communication with Client Computers SECTION 2
2-4 Norand
R
6920 Communications Server Reference Manual
Initial Download Capability
The 6920 Communications Server" supports initial downĆ load (IDL) only if the computer application program is set up to handle it and data files are defined in the 6920 CommuĆ nications Server" as IDL files. A byte located in the upload session control file (SCNTRL) is normally set to a 1" during the boot process.
Data flow from the 6920 Communications Server" to the computer begins when the computer requests a download. This first download after a computer is booted is called IniĆ tial DownLoad or IDL. Assuming the 6920 CommunicaĆ tions Server" is prepared for IDL and the computer applicaĆ tion allows it, the 6920 Communications Server" downloads to the computer.
People familiar with the computer application planned for use with the 6920 Communications Server" are the best sources for IDL information. Procedures for IDL vary wideĆ ly from one application to another.
SECTION 2 Communication with Client Computers
Norand
R
6920 Communications Server Reference Manual 2-5
Data Flow
Data flow from the 6920 Communications Server" begins with the computer uploading the stored data, then receivĆ ing a download. Download is done by scheduled data, using the Import Data method or by using a download request. The communication program uses the request and activaĆ tion databases to determine what files or data the computer should receive. Then it sends the appropriate file or files to the computer. Specific files can also be requested" by the computer using a special download request (DWNLRQ) forĆ mat.
The computer upload is stored in an upload data file. The communication program also generates a log of its transacĆ tions with the computer and places the contents in an Event Log" file (available through EVENTLOG.EXE).
The first block of upload data sent from the computer conĆ tains information used by the 6920 Communications ServĆ er:"
" Route ID " Application version " Flash version " IDL flag
"
NOTE: The “Event Log” is discussed on page 2-7.
Communication with Client Computers SECTION 2
2-6 Norand
R
6920 Communications Server Reference Manual
Figure 2Ć1 represents this interaction:
Figure 2Ć1
Data Flow
SECTION 2 Communication with Client Computers
Norand
R
6920 Communications Server Reference Manual 2-7
Event Log
The 6920 Communications Server" generates an Event Log" file in each communication session. The file consists of various records with detailed statistics about all applicaĆ tions.
Event Log" information is stored in an ODBC compliant database which can be viewed using the 6920 Event Log" application. Each record recorded in the Event Log" has a unique key. Each entry contains five fields:
" Type Information, warning, critical " Date Date (DD/MM/YY) " Time Time (HH:MM) " Module Application which reported message
" Message Message text
The Event Log" is contained in a Microsoft Access dataĆ base located in the C:\6920\DB" subdirectory. The
6920.MDB file should be periodically archived and deleted as a maintenance practice.
Communication with Client Computers SECTION 2
2-8 Norand
R
6920 Communications Server Reference Manual
NorandR 6920 Communications Server Reference Manual 3-1
Section 3
Tutorial
""""""""""""""""""""""""""""
"
NOTE: Certain assumptions were made about the hardware being used and
the basic configuration of the “NorandR 6920 Communications Serv­er. Your actual system may vary from this example. Appropriate changes should be made to the tutorial instructions to reflect your hardware and system differences.
Sample Set Up
This tutorial assumes that you are using a standard PenĆ tium PC with at least one 9Ćpin RSĆ232 port, and that you are using the following:
" HandĆHeld Computers 61XX, 62XX, or 63XX Series
" 9ĆPin Serial Port Cable to:
61XX Single Docks P/N: 216Ć974Ć001 62XX and 63XX Single Docks P/N: 321Ć355Ć001
" Docking Method:
61XX Single Docks P/N: 225Ć556Ć001 62XX Single Docks P/N: 225Ć381Ć001 63XX Single Docks P/N: 225Ć586Ć001
" Protocol NPCP
Tutorial SECTION 3
3-2 Norand
R
6920 Communications Server Reference Manual
Summary
This section gives you a general overview of how the 6920 Communications Server" works. We will start with an introduction and walk you through the following:
" Set up the NPCP communication protocols via ComĆ
munications Properties"
" Set up System Properties" " Load a handĆheld computer with an application " Schedule users and files to be sent to these users " Process PL/N and DOS data files to be sent to users " Process PL/N and DOS upload data from a handĆheld
computer
"
NOTE: If the 6920 Communications Server is not yet installed, see the
Norand 6920 Communications Server Installation Guide (P/N: 962-055-005).
Tutorial Files
This tutorial uses the following sample files contained in the Samples" folder in the 6920 directory:
" 6X00IPL.INC
Set of data and batch files used as our sample applicaĆ tion. Two batch files use the ROM Utilities to upload and download files:
" 111111.BAT DOS files " 222222.BAT PL/N data files
" TEST.DAT
Sample DOS file to be sent to route 111111."
" PLN.DAT
Sample PL/N file to be sent to route 222222."
" SESSTEST.CTL
Sample session control file to schedule routes 111111" and 222222" to communicate with each other.
SECTION 3 Tutorial
Norand
R
6920 Communications Server Reference Manual 3-3
Configuration
For information about Communications Properties,", see the Norand 6920 Communications Server User's Guide.
"
NOTE: Tool icons are shown to the left of related menu options.
Communications Properties
To set up NPCP:
1. On the System Monitor" tool bar, click the red Communications Properties toolbar button, click the NPCP tab, then add the COM1 serial port.
2. Click Settings to change the settings of COM1 to five concurrent sessions in the Virtual Channels field.
3. Click Apply to save this addition, then click OK to quit Communications Properties."
Tutorial SECTION 3
3-4 Norand
R
6920 Communications Server Reference Manual
"
NOTE: For information about System Properties, see the Norand 6920
User’s Guide.
System Properties
From the System Monitor" tool bar, click the yellow System Properties toolbar button for the System Properties" window.
1. Click the User Setup tab; clear all check marks.
2. Set Terminal ID Position to 33" to match the route ID uploaded by the test application. This helps to disĆ tinguish each terminal coming in.
3. Set Terminal ID Length to 6" to match the user or terminal ID set up in the SESSION.CTL file. This schedules and sends files to users.
4. Click the Apply button to save.
SECTION 3 Tutorial
Norand
R
6920 Communications Server Reference Manual 3-5
5. Click the Import Data tab, and add a check mark to the Pack PL/N Data box.
Leave Import Data Filename empty to ensures that the 6920 Communications Server" processes all the data in the predefined Import Directory.
Click Apply to save this change.
Tutorial SECTION 3
3-6 Norand
R
6920 Communications Server Reference Manual
6. Click the Export Data tab and add a check mark to:
" the Export Data Concurrently box " the Include Duplicate Records box
Click Apply to save these changes, then click OK to quit System Properties."
Loading...
+ 202 hidden pages