PDT 1100 Terminal
DLL Guide
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
About This Guide
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Related Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
v
Chapter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Notational Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Service Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Symbol Support Centers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
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
Directory Path Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
File Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
Start of File Transmission. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11
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 OUTStatement . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Setting Communications Parameters using the OPEN “COM:” Statement . . . . . . . . . . . . . . . . . 3-3
Chapter 4. DLL Functions
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.
! Courieris 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
Canada
Symbol Technologies Canada, Inc.
2540 Matheson Boulevard East
Mississauga, Ontario, Canada L4W 4Z2
(905) 629-7226
United Kingdom
Asia/Pacific
Symbol Technologies
Symbol Place
Winnersh Triangle, Berkshire RG41 5TP
United Kingdom
Symbol Technologies Asia, Inc.
230 Victoria Street #04-05
Bugis Junction OfficeTower
Singapore 188024
0800 3282424(Inside UK)
+44 208 945 7529 (Outside UK)
337-6588 (Inside Singapore)
+65-337-6588 (Outside Singapore)
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 industry-
standard 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. Non-
serialized 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 Windows 95 and Windows NT 3.51/4.0.
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
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
It3ew32d.dll
It3e*.dll
This document
DLL files
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
PDT 1100 Terminal DLL Guide
External IR Transceivers
The table below lists supported external IR transceivers and their corresponding DLL files for
initializing them. To use any of these external IR transceivers, specify the corresponding DLL
file using the +I option (refer to Options on page 2-7).
Table 1-1. Available External IRTransceivers
Manufacturers
ALPS ELECTRIC
FUJITSU
Models
IR MultiStation
DLL filenames
IT3EAIRM.DLL
FMIR-102
IT3EFMIR.DLL
IT3EKKCI.DLL
IT3EEESI.DLL
KANSAI ELECTRIC
Extended Systems
KC-IR1
ESI-9680A JetEye PC
IR Port-Integrated Computers
The table below lists IR port-integrated computers where IR-Transfer Utility E DLL is known
to run normally. These computers require no DLL file for initialization.
Table 1-2. Available IRPort-Integrated Computers
Manufacturers
TOSHIBA
Models
DynaBook TECRA 510CT/2.1
FMV-5150 NA5/W
VN513ET
FUJITSU
EPSON
IBM
ThinkPad 560
SHARP
MN-6350D
1-4
Chapter 2
DLL File Formats
File Formats Supported by DLL
The DLL supports user program files, function files, and date files.
User Program Files
Ir-Transfer Utility C DLL regards MS-DOS files with the extension .PD3 as user program files
(object program files). Files are developed using the PDT 1100-BASIC 3.0 Compiler.
As shown, each record in a user program file is fixed to 128 bytes in length (except the last
record) and suffixed by a set of CR and LF codes (CR-LF codes), 0Dh and 0Ah.
Record length (128 bytes)
CR
CR
CR
CR
CR
LF
LF
LF
LF
LF
Record
Program data
2-1
PDT 1100 Terminal DLL Guide
When downloading a program file, if the length of the last record is less than 128 bytes, the
blank bytes (128 bytes minus last record length) are zero-filled so that every record is 128
bytes long.
Record length (128 bytes)
CR
CR
CR
LF
LF
LF
When downloading:
Record length (128 bytes)
Zero Codes
Note: In the PDT 1100-Ir protocol, CR-LF codes that are used as record
separators in data are removed before file transmission.
When receiving downloaded user programs, the PDT 1100 packs
two-byte ASCII characters into two 4-bit hexadecimal codes in a
single byte, to improve the PDT 1100’s performance and memory
availability.
Function Files
Ir-Transfer Utility C DLL regards files with the extension .FN3 or .EX3 as function files.
These function files are contained in the PDT 1100-BASIC 3.0 Extension Library.
2-2
DLL File Formats
Each record in a function file is fixed to 130 bytes in length (except the last record) and
suffixed by a set of CR-LF codes, as follows.
Record length (130 bytes)
CR
CR
CR
CR
CR
LF
LF
LF
LF
LF
Record
CR
LF
When downloading a function file, if the length of the last record is less than 130 bytes, the
blank bytes (130 bytes minus last record length) are zero-filled, so that every record is 130
bytes long.
Record length (130 bytes)
CR
CR
CR
LF
LF
LF
When downloading:
Record length (130 bytes)
Zero Codes
2-3
PDT 1100 Terminal DLL Guide
Note: In the PDT 1100-Ir protocol, CR-LF codes that are used as record
separators in data are removed before file transmission.
When receiving downloaded function files, the PDT 1100 packs two-
byte ASCII characters into two 4-bit hexadecimal codes in a single
byte, to improve the PDT 1100’s performance and memory
availability.
Data Files
Ir-Transfer Utility C DLL regards MS-DOS files with an extension other than .PD3, .FN3,
and .EX3 as data files. Each record in a data file consists of one or more fields and suffixed
by a set of CR and LF codes (CR-LF codes), 0Dh and 0Ah. An EOF (1Ah) code can be
omitted.
Data files can consist of ASCII text characters as well as arbitrary characters (00h to FFh).
Record Length
Record
Field 1
Field 2
Field N
CR
CR
CR
CR
CR
CR
LF
LF
LF
LF
LF
LF
EOF
To download data files, type the folder, file names, and the field lengths. Each field should be
1 to 254 digits in length and the number of fields should be 1 to 16. The total field length
(record length) plus the number of fields should be 255 or less.
Designate field lengths in a file with the same file name but an .FLD extension as the file to
download, in the directory where that file resides. When the data file is uploaded, Ir-Transfer
Utility C DLL automatically creates the field definition file in the folder where the uploaded
file is stored. For the .FLD file format, refer to Start of File Transmission on page 2-11.
2-4
DLL File Formats
In downloading a data file, if the actual record length is less than the specified record length,
the blank bytes are filled with space codes (20h); if it exceeds the specified record length, the
excess is discarded.
Specified Record Length
Record 1
Record 2
Record 3
CR LF
= Equal to the specified record length
= Less than the specified record length
CR LF
CR LF = Exceeds the specified record length
When downloaded:
Specified Record Length
Record 1
= As it was
Record 2
Record 3
Space Codes
= Blank Codes are filled with space codes
= Excess data is discarded
Interpreting CR-LF Codes in records
Ir-Transfer Utility C DLL interprets all characters 00h to FFh as data, but it usually interprets
CR-LF codes in records as a record separator. If a record in a data file to be transmitted
contains CR-LF codes, the Ir-Transfer Utility C DLL divides the record according to the
record separator as follows.
Specified Record Length
Record n1
CR LF
Record n2
CR LF
When downloaded:
Specified Record Length
Record n1
Record n2
Space Codes
Space Codes
= Divided into two blocks
during transmission
2-5
PDT 1100 Terminal DLL Guide
To handle CR-LF codes as data, specify the +C option. CR-LF codes in records are
transmitted as data:
Specified Record Length
Record n1
CR LF
Record n2
CR LF
When downloaded:
Specified Record Length
CR LF Record n2
Record n1
= Transmitted in a single block
Even if you specify the +C option, use CR-LF codes as a record separator. If a record’s length
is more or less than the specified record length in a file, an error (error code 76) occurs and
the transmission is aborted. For the +C option, refer toOptions on page 2-7.
To download data files containing CR-LF codes in records to the PDT 1100:
1. At the host computer, specify the +C option in Ir-Transfer Utility C DLL
2. At the PDT 1100, set the [Data] on the space code handling screen in System Mode
(or in PDT 1100-BASIC 3.0, specify the T option to “protocolspec” in the XFILE
statement) to regard space codes in the tail of a data field as data.
If [Ignore] is selected (or no T option is specified), the PDT 1100 ignores space codes in the
tail of a data field and data is not transferred correctly.
For [Data] setting, refer to the PDT 1100 Product Reference Guide. For T option setting in
the XFILEstatement, refer to the PDT 1100 Programmer’s Guide.
2-6
DLL File Formats
Directory Path Names and File Names
Directory Path Names
Specify the directory path of a file to be sent or received. You may specify either an absolute
or relative path. If no path name is specified, the current working directory becomes active
by default. Specification of a path name only is not allowed.
Generally, no space code is allowed to be used in path names or file names; however, you can
use space codes in path names by enclosing path names with double quotes as follows:
“c:\Program filesest.pd3”
File Names
Specify the name of a file to be sent or received. If you set the +R option for file reception and
specified “(file)” as a file name, the host computer creates a receive file with the original file
name used in the PDT 1100.
Note: You cannot specify more than one file name in one function. To send
or receive more than one file, add more than one line of the file
transfer functions.
Table 2-1. Options
Options
Functions
Defaults
+B
Sets the transmission speed.
+B9600
transmissionspeed
+Bn
n = 9600,19200,38400,57600, or 115200
+P portnumber
Sets the communications port.
+P1
+P1
+P2
+P3
+P4
COM1
COM2
COM3
COM4
2-7
PDT 1100 Terminal DLL Guide
Table 2-1. Options (Continued)
Options
Functions
Defaults
+Fn
Sets the number of digits for fields for a data file to be sent.
+F<Item1.fieldlength>[,<Item2.fieldlength>,
......<Itemn,fieldlength>]
----
(n=1 to 16<Cfieldlength=1 to 254>
<Example> If a file consists of three fields whose lengths are as follows:
<Item1.field>=13,<Item2.field>=20,<Item3.field>=6
+F13,20,6
+I,-I
Determines whether to initialize the IR device.
-I
+I“<DLLfil Initializes the IR device specified by <DLLfilename> at the
ename>”
start of file transmission. The <DLLfilename> should be
It3exxxx.dll (except It3ew32d.dll) enclosed by double
quotes. Specify the DLL file name of the IR device to be
used following the +I.
-I
Does not initialize the IR device.
+R, -R
+N, -N
+A, -A
Sets the transmission direction.
-R
+R
-R
Creates a receive file with the specified file name in the
specified directory, and receives a file. If you specify more
than one file, an error occurs.
Transmits the specified file. If you specify more than one
file, an error occurs.
Determines whether to check the name of a received file. When the +R -N
is specified, the DLL compares the file name used in the PDT 1100 with
the received file name. If any discrepancy is found, an error occurs. This
command switch is ignored when the -R is specified.
+N
-N
Checks the file name.
Does not check the file name.
Determines whether to add a received file data to the existing data file. -A
+A
-A
Adds a received file data to the tail of the existing data file.
Overwrites the existing data file with a received data file.
2-8
DLL File Formats
Table 2-1. Options (Continued)
Options
+T, -T
Functions
Defaults
Determines whether to insert field separators. Inserts field separators
(specified by <DelimiterChar> or <HexCode>) between fields when
writing a received data file. This option should be specified in either of
the following two formats. For characters (see Note 2) which cannot be
specified in Format 1, use Format 2. If this option is specified in other
incorrect formats, no operation is assured.
-T
Format 1
The <DelimiterChar> should be in a single byte and
+T'<Delimi enclosed by single quotes.
terChar>'
(Example) To insert a comma as a field separator +T','
(Note 1) Data written outside a pair of single quotes is
ignored.
(Note 2) Listed below are characters which cannot be
specified by <DelimiterChar> in Format 1. To write any of
them, use Format 2.
Format 2
The <HexCode> should be a two-byte hexadecimal
+T\x<HexCo character string.
de>
(Example) To insert a space code as a field separator
+T\x20
-T
Does not insert field separators.
+V, -V
+C,-C
Determines whether to display the communications status dialog box. +V
+V
-V
Displays the status dialog box.
Does not display the status dialog box.
Specifies how to handle CR-LF codes in records in file transmission.
-C
+C
-C
Interprets CR-LF codes as data.
Interprets CR-LF code as a record separator.
2-9
PDT 1100 Terminal DLL Guide
Table 2-1. Options (Continued)
Functions
+L timeoutlength Sets the timeout length in seconds.
Options
Defaults
+L30
+Ln
n=0 to 65535
Specification of +L0 produces no timeouts.
Specification of only +L makes the default (30 seconds)
active.
+X x-coordinate Specifies the x-coordinate of the PDT 1100 Sending or PDT 1100
Receiving dialog box.
+Xn
n=-65535 to 65535
This specifies the location of the left side of the dialog box.
The display position is a relative value from the upper left
corner of the screen.
+Y y-coordinate Specifies the y-coordinate of the PDT 1100 Sending or PDT 1100
Receiving dialog box.
+Yn
n=-65535 to 65535
This specifies the location of the upper side of the dialog
box. The display position is a relative value from the upper
left corner of the screen.
<Example> +X100 +Y400
The dialog box appears with its upper left corner located
at (100, 400).
Note: If the same option is set more than once with different specifications,
the most recent one has the highest priority.
2-10
DLL File Formats
Start of File Transmission
If It3cw32dis initiated, the Ir Sending dialog box (when downloading) or PDT 1100-Ir
Receiving dialog box (when uploading) is displayed, and file transmission starts.
The PDT 1100-Ir Receiving appears in
PDT 1100-Ir Sending
uploading.
Number of transmitted records (serial
number)/Total number of records to be
transmitted.
00000/00300
Abort
Click this Abort button to abort the
transmission.
When uploading a data file, Ir-Transfer Utility C DLL automatically creates a field definition
file with the extension .FLD using the same file name as the data file, as follows. If this file is
already present, Ir-Transfer Utility C DLL updates its contents.
The following dialog box does not appear if the -V option is set:
* created by Ir-Transfer Utility 3C for Windows95/NT DLLVersion X.XX
* Copyright (C) DENSO CORPORATION 1997 all rights reserved
file PACK1.DAT
date 1997-09-25 18:56:30
size 570
records 10
fields 40 5 10
file
: Parent file name
date
size
: Date and time when the file is uploaded
: File size
records
fields
: Number of records
: Field length
2-11
PDT 1100 Terminal DLL Guide
2-12
Chapter 3
Setting up the PDT 1100 in System Mode
This chapter describes the PDT 1100 preparation required for using Ir-Transfer Utility C and
E DLL.
File Transfer in System Mode
For file transfer in System Mode, use the following procedure:
1. Starts
System
Mode
2. Sets the
Communications
Parameters
4. Uploads
Files
3. Downloads
Files
3-1
PDT 1100 Terminal DLL Guide
Setting up the PDT 1100 in System Mode
Hold down the SF and 1 keys to power on the PDT 1100.
Setting Communications Parameters
The table below lists the default communications parameter values:
Table 3-1. Communications Parameter s
Communications parameters
Transmission speed
Defaults
9600 bps
1.63 us
ON
Output pulse width of IR beam
Serial number
Horizontal parity
ON
Timeout for link establishment
30 seconds
Space codes in the tail of a data field Ignore
Communications protocol
Interface
PDT 1100-protocol
Optical
To modify the above settings, set the desired values on the System Environment Setting screen
in System Mode. For details, refer to the PDT 1100 Product Reference Guide.
Select the PDT 1100-Ir protocol in the PDT 1100 when using Ir-Transfer Utility C and E DLL.
The PDT 1100-Ir protocol automatically adds the serial number and horizontal parity, so
other settings made in the PDT 1100 are ignored.
To download data files to the PDT 1100 using +C option specified in the DLL, select [Data]
on the Communications Protocol Option screen in System Mode to treat space codes in the
tail of a data field as data. If you have selected the +C option, every record in a data file should
be fixed in length (refer to Data Files on page 2-4) so that space codes used to fill blanks in
the tail of a data field are data, not characters.
Downloading
Use the download menu in System Mode to download files. For details, refer to the PDT
1100 Product Reference Guide.
3-2
Setting up the PDT 1100 in System Mode
Uploading
Use the upload menu in System Mode to upload files. For details, refer to the PDT 1100
Product Reference Guide.
Programming in PDT 1100-BASIC 3.0
Setting Communications Parameters using the OUTStatement
You may set the communications protocol type using the OUTstatement. The following sample
sets the PDT 1100-Ir protocol.
OUT &h6060,2
The PDT 1100 System version 1.01 or earlier does not support setting the communications
protocol type with the OUTstatement. Select the PDT 1100-Ir protocol in System Mode.
Setting Communications Parameters using the OPEN “COM:”
Statement
You may set the communications parameters using the OPEN “COM:”statement. The following
sample sets the optical interface and 115200 bps.
OPEN“COM1:115200”AS#1
Creating a Source Program Using the XFILE Statement
to the PDT 1100-Ir protocol using the XFILEstatement. Compile the source program into the
user program and download it to the PDT 1100. For details, refer to theXFILEstatement in
the PDT 1100 Programmer’s Guide.
To download data files to the PDT 1100 using +C option specified in the DLL, specify the T
option to the “protocolspec” of the XFILEstatement to treat space codes in the tail of a data
field as data. If you have selected the +C option, every record in a data file must be fixed in
length (refer to Data Files on page 2-4) so that space codes in the tail of a data field are data,
not fill characters used to fill blanks in record when its actual length is shorter than the
specified length.
3-3
PDT 1100 Terminal DLL Guide
3-4
Chapter 4
DLL Functions
Ir-Transfer Utility C DLL supports the following three functions:
! GetIt3cDllVersion() Gets the version of the current DLL.
! ExecIt3c() Transfers files.
! AbortIt3c() Aborts the current file transfer.
You can call these functions from VC++4.0 or VB4.0. For VC++4.0, include “It3capi.h.”
For VB4.0, use the function “It3cw32d.dll” by writing the declare statement into “(General)
(Declarations)” of the module file. For the instructions on how to use them, refer to the
“It3cw32.bas” and sample programs.
4-1
PDT 1100 Terminal DLL Guide
GetIt3cDllVersion()
Description
Gets the version of the current DLL.
Syntax
For VC++4.0
char
*GetIt3cDllVersion(char *Param);
For VB4.0
Declare Function GetIt3eDclVersion Lib “It3cw32c.dll”
(ByVal Param As String) As String
where:
Param = Character string where the version character string of the DLL is
to be stored. Sufficient length is required.
If you are using VB4.0, use the String variable such as
String(100.“ ”) to reserve the memory area.
Returned value
Parameter itself.
4-2
DLL Functions
ExecIt3c()
Description
Uploads (receives) or downloads (sends) the designated file.
Syntax
For VC++4.0
typedef enum errorcode {
Er_NOERROR
Er_NOFILE
= 0, /* Communication ended normally.
= 1, /* Designated file not found.
*/
*/
:
:
} Er;
Er ExecIt3c(HWND hWnd, char *Param, char *TransferFileName);
For VB4.0
Declare Function ExecIt3c Lib “It3cw32d.dll” (ByVal hWnd As Long,
ByVal Param As String, ByVal TransferFileName As String) As Long
where:
hWnd = Sets the window handle that calls the DLL. If you are using
“Me.hWnd” to display the dialogs and get the timer value.
Param= Sets the character string of the command switch for
customizing the file transfer. This character string contains
one file name and command switches separated by space
codes.
(Example) c:\tmp\check.pd3 +P1 +B19200
For details about file names, refer to Directory Path Names
and File Names on page 2-7. For command switches, refer
to Options on page 2-7.
TransferFileName= Character string specifying the directory path name and file
name of the transferred file in sending or receiving.
Sufficient length is required.
If you are using VB4.0, use the String variable such as
String(255.“ ”) to reserve the memory area.
4-3
DLL Functions
AbortIt3c()
Description
Aborts the current file transmission.
Syntax
For VC++4.0
int AbortIt3c(void);
For VB4.0
Declare Function AbortIt3c Lib “It3cw32d.dll” () As Long
Returned value
This function returns the same value as an error code, showing the current file transfer status
when it is called.
0 Was not transferring.
60 Was sending.
61 Was receiving.
4-5
PDT 1100 Terminal DLL Guide
4-6
Appendix A
Error Codes
If an error occurs during execution of Ir-Transfer Utility C or E DLL, one of the error codes
from Table 1-1 is returned.
Table 1-1. Error Codes
Code
Description
0
1
2
3
4
5
6
7
Normal end.
Ir-Transfer Utility C DLL could not find the designated file.
Filename entered in the wrong format.
The total number of the records specified in a file exceeds 32767.
The data field is out of range from 1 to 254 digits in length.
The number of fields is out of the range from 1 to 16.
The total number of designated fields and length of all data fields exceeds 255 bytes.
You entered no field option (undefined option) which is not to be specified for
downloading a program file.
8
No field option was entered when downloading a data file.
An undefined option was entered.
9
51
Communications error.
The sending timer has timed out.
52
Communications error.
The receiving timer has timed out.
A-1
PDT 1100 Terminal DLL Guide
Table 1-1. Error Codes (Continued)
Description
Code
53
Communications error.
The NAK sending counter has counted up to 10.
54
55
Communications error.
The NAK receiving counter has counted up to 10.
Communications error.
The sending station receives as EOT in response to the sent text.
60
61
70
The DLL has been running in sending operation.
The DLL has been running in receiving operation.
The receiving heading text contains any of the following:
(1) File name in wrong format
(2) More than 32767 records
(3) Number of fields out of range from 1 to 16 in the data file
(4) Data field length out of range from 1 to 254 digits in the data file
(5) Total length of all data fields plus the number of the fields exceeding 255 bytes
71
72
74
75
The designated directory path has not been found.
The disk memory is full.
The designated timers have been occupied by other applications.
The designated RS-232C communications port (COMx:) has been occupied by other
applications.
76
In a file there is a record whose length is less than or more than the specified record
length.
77
80
81
82
90
The Utility has received a file not designated, instead of the designated file.
Ir-Transfer Utility C DLL has failed to initialize the IR device.
The correct DLL is not found.
The IR device does not support the designated transmission speed.
Ir-Transfer Utility C DLL was aborted by clicking the Abort button in the PDT 1100-Ir
Sending (or Receiving) dialog box.
99
Any other error has occurred.
A-2
B
It3ew32d.lib . . . . . . . . . . . . . . . . . . . . . . . . 1-2
It3e*.dll . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
bullets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
C
conventions
D
disk contents - C . . . . . . . . . . . . . . . . . . . . . 1-1
disk contents - E . . . . . . . . . . . . . . . . . . . . . 1-2
downloading . . . . . . . . . . . . . . . . . . . . . . . . 3-2
M
N
notational conventions . . . . . . . . . . . . . . . . . . vi
E
F
I
IR port-integrated computers . . . . . . . . . . . . 1-4
It3cApi.h . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
It3capi.h . . . . . . . . . . . . . . . . . . . . . . . 4-1, 4-4
It3cdemo.vbp . . . . . . . . . . . . . . . . . . . . . . . . 1-1
It3cw32d . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11
It3cw32d.dll . . . . . . . . . . . . . . . . . 1-1, 4-3, 4-5
It3cw32d.lib . . . . . . . . . . . . . . . . . . . . . . . . 1-1
It3cw32.bas . . . . . . . . . . . . . . . . . . 1-1, 4-1, 4-4
R
receive files . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
record length . . . . . . . . . . . . . . . . . . . . 2-1, 2-5
record separator . . . . . . . . . . . . . . . . . . . . . 2-6
Index-1
S
service information . . . . . . . . . . . . . . . . . . . . . vi
statement
X
OPEN
OUT . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
XFILE . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
symbol support center . . . . . . . . . . . . . . . . . . vii
Z
+L timeoutlength . . . . . . . . . . . . . . . . . . . . 2-10
+P portnumber . . . . . . . . . . . . . . . . . . . . . . . 2-7
+R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
+T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
+V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
+X x-coordinate . . . . . . . . . . . . . . . . . . . . . 2-10
+Y y-coordinate . . . . . . . . . . . . . . . . . . . . . 2-10
U
upload . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
V
VB4.0 . . . . . . . . . . . 1-1, 1-2, 4-1, 4-2, 4-3, 4-5
VC++4.0 . . . . . . . . . 1-1, 1-2, 4-1, 4-2, 4-3, 4-5
W
Windows 3.1 . . . . . . . . . . . . . . . . . . . . . . . 1-3
Index-2
Tell Us Wh a t You Th in k ...
We’d like to know what you think about this Manual. Please take a moment
to fill out this questionaire and fax this form to: (631) 738-3318, or mail to:
Symbol Technologies, Inc.
One Symbol Plaza M/S B-4
Holtsville, NY 11742-1300
Attn: Technical Publications Manager
IMPORTANT: If you need product support, please call the appropriate cus-
tomer support number provided. Unfortunately, we cannot provide customer
support at the fax number above.
User’s Manual Title: _______________________________________________
(please include revision level)
How familiar were you with this product before using this manual?
Very familiar
Slightly familiar
Not at all familiar
Did this manual meet your needs? If not, please explain. ________________
________________________________________________________________
What topics need to be added to the index, if applicable? _______________
________________________________________________________________
What topics do you feel need to be better discussed? Please be specific.
_________________________________________________________________
What can we do to further improve our manuals?_______________________
_________________________________________________________________
_________________________________________________________________
Thank you for your input—We value your comments.
|