Symbol Technologies PDT 1100 User Manual
PDT 1100 Terminal
DLL Guide
PDT 1100 Terminal DLL Guide
70-36556-01
Revision B — May 2001
2
Symbol Technologies, Inc. One Symbol Plaza, Holtsville N.Y. 11742
PDT 1100 Terminal
DLL Guide
70-36556-01
Revision B
May 2001
1998 - 2001 by Symbol Technologies, Inc. All rights reserved.
No part of this publication may be reproduced or used in any form, or by any electrical or
mechanical means, without permission in writing from Symbol. This includes electronic or
mechanical means, such as photocopying, recording, or information storage and retrieval
systems. The material in this manual is subject to change without notice.
The software is provided strictly on an “as is” basis. All software, including firmware,
furnished to the user is on a licensed basis. Symbol grants to the user a non-transferable and
non-exclusive license to use each software or firmware program delivered hereunder (licensed
program). Except as noted below, such license may not be assigned, sublicensed, or otherwise
transferred by the user without prior written consent of Symbol. No right to copy a licensed
program in whole or in part is granted, except as permitted under copyright law. The user
shall not modify, merge, or incorporate any form or portion of a licensed program with other
program material, create a derivative work from a licensed program, or use a licensed
program in a network without written permission from Symbol. The user agrees to maintain
Symbol’s copyright notice on the licensed programs delivered hereunder, and to include the
same on any authorized copies it makes, in whole or in part. The user agrees not to
decompile, disassemble, decode, or reverse engineer any licensed program delivered to the
user or any portion thereof.
Symbol reserves the right to make changes to any software or product to improve reliability,
function, or design.
Symbol does not assume any product liability arising out of, or in connection with, the
application or use of any product, circuit, or application described herein.
No license is granted, either expressly or by implication, estoppel, or otherwise under any
Symbol Technologies, Inc., intellectual property rights. An implied license only exists for
equipment, circuits, and subsystems contained in Symbol products.
Microsoft, Windows, Windows 95, Windows NT and MS-DOS are registered trademarks of
Microsoft Corporation.
Symbol, Spectrum One, and Spectrum24 are registered trademarks of Symbol Technologies,
Inc. Other product names mentioned in this manual may be trademarks or registered
trademarks of their respective companies and are hereby acknowledged.
Symbol Technologies, Inc.
One Symbol Plaza
Holtsville, New York 11742-1300
http://www.symbol.com
ii
Contents
About This Guide
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Related Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Chapter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Notational Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Service Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Symbol Support Centers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Warranty Coverage and Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Chapter 1. Introduction
DLL Disks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
The DLL for IR-Transfer Utility C Disk Contains: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
The DLL for IR-Transfer Utility E Disk Contains:. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
What is IR-Transfer Utility C DLL? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Computers Available for IR-Transfer Utility C DLL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
Installing IR-Transfer Utility C and E DLL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
Preparations for Using IR-Transfer Utility C DLL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
IR Devices Available for IR-Transfer Utility E DLL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
External IR Transceivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
IR Port-Integrated Computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Chapter 2. DLL File Formats
File Formats Supported by DLL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
User Program Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Function Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Data Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Directory Path Names and File Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
iii
PDT 1100 Terminal DLL Guide
Directory Path Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
File Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
Start of File Transmission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-11
Chapter 3. Setting up the PDT 1100 in System Mode
File Transfer in System Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Setting up the PDT 1100 in System Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Setting Communications Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Downloading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Uploading. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Programming in PDT 1100-BASIC 3.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Setting Communications Parameters using the OUT Statement . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Setting Communications Parameters using the OPEN “COM:” Statement . . . . . . . . . . . . . . . . . 3-3
Chapter 4. DLL Functions
GetIt3cDllVersion() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Returned value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
ExecIt3c() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Returned value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
AbortIt3c() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Returned value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Appendix A. Error Codes
Index
Feedback
iv
About This Guide
Introduction
This document describes the use of the Dynamic Link Library (DLL) of IR-Transfer Utilities.
It is intended for programmers who already have some experience in programming.
Related Publications
PDT 1100 Terminal Product Reference Guide, p/n 70-35864-XX
!
PDT 1100 Terminal Quick Reference Guide, p/n 70-35861-XX
!
CRD 1100 Cradle Quick Reference Guide, p/n 70-35862-XX
!
CRG 1100 4-Slot Battery Charger Quick Reference Guide, p/n 70-35863-XX
!
PDT 1100 Terminal Transfer Utility Guide, p/n 70-36368-XX
!
PDT 1100 Terminal Extension Library Programmer’s Guide, p/n 70-36100-XX
!
PDT 1100 Terminal Programmer's Guide, p/n 70-36099-XX
!
v
PDT 1100 Terminal DLL Guide
Chapter Descriptions
Chapter 1, Introduction describes the Ir-Transfer Utility C and E DLL.
!
Chapter 2, DLL File Formats describes the file formats used in the Ir-Transfer Utility
!
C and E DLL.
Chapter 3, Setting up the PDT 1100 in System Mode describes how to set up the PDT
!
1100 to accept downloading and uploading from the host.
Notational Conventions
The following conventions are used in this document:
Italics are used to highlight specific items in the general text, and to identify chapters
!
and sections in this and related documents.
Bullets (•) indicate:
!
" action items
" lists of alternatives
" lists of required steps that are not necessarily sequential
Sequential lists (e.g., those that describe step-by-step procedures) appear as
!
numbered lists.
!
Courie r
is used to indicate syntax.
Service Information
If you have a problem with your equipment, contact the nearest Symbol Support Centers.
Before calling, have the model number, serial number, and several of your bar code symbols
at hand.
Call the Support Center from a phone near the scanning equipment so that the service person
can try to talk you through your problem. If the equipment is found to be working properly
and the problem is symbol readability, the Support Center will request samples of your bar
codes for analysis at our plant.
If your problem cannot be solved over the phone, you may need to return your equipment
for servicing. If that is necessary, you will be given specific directions.
vi
About This Guide
Note: Symbol Technologies is not responsible for any damages incurred
during shipment if the approved shipping container is not used.
Shipping the units improperly can possibly void the warranty. If the
original shipping container was not kept, contact Symbol to have
another sent to you.
Symbol Support Centers
For service information, warranty information or technical assistance contact or call the
Symbol Support Center in:
United States
Symbol Technologies, Inc.
One Symbol Plaza
Holtsville, New York 11742-1300
1-800-653-5350
United Kingdom
Symbol Technologies
Symbol Place
Winnersh Triangle, Berkshire RG41 5TP
United Kingdom
0800 3282424(Inside UK)
+44 208 945 7529 (Outside UK)
Symbol Technologies Canada, Inc.
2540 Matheson Boulevard East
Mississauga, Ontario, Canada L4W 4Z2
(905) 629-7226
Symbol Technologies Asia, Inc.
230 Victoria Street #04-05
Bugis Junction Office Tower
Singapore 188024
337-6588 (Inside Singapore)
+65-337-6588 (Outside Singapore)
Canada
Asia/Pacific
If you purchased your Symbol product from a Symbol Business Partner, contact that Business
Partner for service.
Warranty
Symbol Technologies, Inc (“Symbol”) manufactures its hardware products in accordance with industrystandard practices. Symbol warrants that for a period of twelve (12) months from date of shipment,
products will be free from defects in materials and workmanship.
This warranty is provided to the original owner only and is not transferable to any third party. It shall
not apply to any product (i) which has been repaired or altered unless done or approved by Symbol, (ii)
which has not been maintained in accordance with any operating or handling instructions supplied by
Symbol, (iii) which has been subjected to unusual physical or electrical stress, misuse, abuse, power
shortage, negligence or accident or (iv) which has been used other than in accordance with the product
operating and handling instructions. Preventive maintenance is the responsibility of customer and is not
covered under this warranty.
vii
PDT 1100 Terminal DLL Guide
Wear items and accessories having s Symbol serial number, will carry a 90-day limited warranty. Nonserialized items will carry a 30-day limited warranty.
Warranty Coverage and Procedure
During the warranty period, Symbol will repair or replace defective products returned to Symbol’s
manufacturing plant in the US. For warranty service in North America, call the Symbol Support Center
at 1-800-653-5350. International customers should contact the local Symbol office or support center.
If warranty service is required, Symbol will issue a Return Material Authorization Number. Products
must be shipped in the original or comparable packaging, shipping and insurance charges prepaid.
Symbol will ship the repaired or replacement product freight and insurance prepaid in North America.
Shipments from the US or other locations will be made F.O.B. Symbol’s manufacturing plant.
Symbol will use new or refurbished parts at its discretion and will own all parts removed from repaired
products. Customer will pay for the replacement product in case it does not return the replaced product
to Symbol within 3 days of receipt of the replacement product. The process for return and customer’s
charges will be in accordance with Symbol’s Exchange Policy in effect at the time of the exchange.
Customer accepts full responsibility for its software and data including the appropriate backup thereof.
Repair or replacement of a product during warranty will not extend the original warranty term.
Symbol’s Customer Service organization offers an array of service plans, such as on-site, depot, or
phone support, that can be implemented to meet customer’s special operational requirements and are
available at a substantial discount during warranty period.
General
Except for the warranties stated above, Symbol disclaims all warranties, express or implied, on products
furnished hereunder, including without limitation implied warranties of merchantability and fitness for
a particular purpose. The stated express warranties are in lieu of all obligations or liabilities on part of
Symbol for damages, including without limitation, special, indirect, or consequential damages arising
out of or in connection with the use or performance of the product.
Seller’s liability for damages to buyer or others resulting from the use of any product, shall in no way
exceed the purchase price of said product, except in instances of injury to persons or property.
Some states (or jurisdictions) do not allow the exclusion or limitation of incidental or consequential
damages, so the proceeding exclusion or limitation may not apply to you.
viii
Chapter 1
Introduction
The Dynamic Link Library for IR-Transfer Utility C V1.04 and IR-Transfer Utility E V1.02
transmits program files and data files between the PDT 1100 Terminal and the host computer.
The DLL runs on Microsoft
DLL Disks
The DLL for IR-Transfer Utility C Disk Contains:
Under the Root Directory
Readme.txt This document
!
It3cw32d.dll DLL files
!
Under the VC40 directory
It3cw32d.lib Import library name file for VC++4.0
!
It3cApi.h Header name file for VC++4.0
!
®
Windows 95® and Windows NT® 3.51/4.0.
Under the VB40 directory
It3cw32.bas Module file for VB4.0
!
Formmain.frm FRM file for VB4.0 demonstration program
!
Formmain.frx FRX file for VB4.0 demonstration program
!
It3cdemo.vbp Project file for VB4.0 demonstration program
!
1-1
PDT 1100 Terminal DLL Guide
The DLL for IR-Transfer Utility E Disk Contains:
Under the Root Directory
Readme.txt This document
!
It3ew32d.dll DLL files
!
It3e*.dll DLL file for initializing IR devices
!
Under the VC40 directory
It3ew32d.lib Import library name file for VC++4.0
!
It3eApi.h Header name file for VC++4.0
!
Under the VB40 directory
It3ew32.bas Module file for VB4.0
!
Formmain.frm FRM file for VB4.0 demonstration program
!
Formmain.frx FRX file for VB4.0 demonstration program
!
It3edemo.vbp Project file for VB4.0 demonstration program
!
Note: Always make and use copies of the master disk (IR-Transfer Utility C
DLL floppy disk) and store the master copy from the package in a safe
place, misoperation may damage the master disk.
What is IR-Transfer Utility C DLL?
IR-Transfer Utility C DLL is a set of DLL programs which uploads and downloads program
files, data files, or function files between the PDT 1100 and the host computer. This transfer
is done according to the PDT 1100-IR protocol in the Windows 95 or Windows NT 3.51/4.0
environment.
Note: Uploading refers to the host's receiving files from the PDT 1100;
downloading refers to transferring files from the host computer to the
PDT 1100.)
1-2
Introduction
The PDT 1100-IR protocol is a PDT 1100 terminal’s format for transmitting data between
the PDT 1100 and the host computer. For details, refer to the PDT 1100 Product Reference
Guide.
Computers Available for IR-Transfer Utility C DLL
IR-Transfer Utility C DLL can run on personal computers equipped with the Intel 80386 CPU
or higher capability that can operate Microsoft Windows 95 or Microsoft Windows NT3.51/
4.0.
The DLL needs more memory than required by the OS and at least 200 kilobytes of unused
disk space.
Note: IR-Transfer Utility C DLL cannot run with Windows 3.1.
When using PC’s that use commands or menus to control the power
source for the integrated RS-232C interface to save power, create a
setting for applying power to that interface.
Installing IR-Transfer Utility C and E DLL
Preparations for Using IR-Transfer Utility C DLL
Copy the DLL file(s) to use into the folder where application program(s) are stored or into
the folder with the path to the application folder.
IR Devices Available for IR-Transfer Utility E DLL
Listed below are IR devices (e.g., external IR transceivers and IR port-integrated computers)
that IR-Transfer Utility E DLL supports.
1-3
Loading...