7526 DCT Reference
Document Number: SC28-9629-03
04G5605
Table of Contents
Chapter
1. Notices
Chapter
2. Introduction
Features
Functional
Modes
7525
Compatibility Mode
Enhanced
Mode
Chapter
3. ROM Microcode Functions
Power-On
Self Test (POST)
Setup
Mode
Setup
Detail
Diagnostics
Diagnostic
Interface
Field
Replaceable Units
Features
Contrast
and Beeper Adjustment
Keylock
Key
Alt
Key&mdash.Model 100
User
Defined Keypad Layout&mdash.Model 200
Chapter
4. Transaction Queue Operation
Interactive
Mode
Interactive/Buffered
Mode
Buffered
Mode
Chapter
5. Communications Control Protocol 1283
ASCII
Characters
Control
Characters
Receiving
Transactions from the 7526 DCT
Polled
RS-422/485
Non-Polled
Ethernet
Command
Structure
Broadcast
Command
Checksum
Characters
Ethernet
TCP/IP Extensions
Initial
File Loading
Logical
Channels
Terminal
Addressing
Modified
Packet Formats
Unsolicited
Message Flow Control
Sequencing
of Messages
Handling
Duplicates Messages
Example
of Controller/Server Setting of Message Sequence Number
Structure
of the UDP Datagram
Chapter
6. Communications Control Commands
Control
Command Details
CMD
0&mdash.Reset Terminal
CMD
1&mdash.Transmit Terminal Status to Terminal Controller
CMD
2&mdash.Write to Terminal Display
CMD
3&mdash.Transmit ROM Microcode Version and Revision to Terminal Controller
Enhanced
Mode
7525
Compatibility Mode
CMD
4&mdash.Set Terminal Time and Date
CMD
5&mdash.Activate Terminal Audible Tone
CMD
6&mdash.Transmit Terminal Features to Terminal Controller
Enhanced
Mode
7525
Compatibility Mode
CMD
7&mdash.Transmit Terminal TOD to Terminal Controller
CMD
8&mdash.Specify Current Polled Buffer or File
CMD
9x&mdash.Terminal Text or Data File Management
CMD
9A&mdash.Send File Status to Terminal Controller
Enhanced
Mode
7525
Compatibility Mode
CMD
9B&mdash.Initialize Specified Text File
Enhanced
Mode
7525
Compatibility Mode
CMD
9C&mdash.Load Text File
CMD
9D&mdash.Delete Text Records
CMD
9E&mdash.Erase Validation File
CMD
9F&mdash.Transmit Data File Contents to Terminal Controller
Enhanced
Mode
7525
Compatibility Mode
CMD
A&mdash.Set Terminal State
CMD
B&mdash.Positive Response from Terminal Controller
Enhanced
Mode
7525
Compatibility Mode
CMD
C&mdash.Negative Response from Terminal Controller
Enhanced
Mode
7525
Compatibility Mode
CMD
D&mdash.Initiate Data Collection from Terminal Controller
CMD
E&mdash. Write DO Point
CMD
F&mdash.Storage Query
CMD
G&mdash.Execute Transaction Program in Simulated Mode
CMD
H&mdash.Vary Communications Turn-Around Time
CMD
I&mdash.Set User Variable
CMD
IM&mdash.Set Multiple User Variables
CMD
J9&mdash.Configuration Query
CMD
K&mdash.Transaction Release
CMD
L&mdash.Communications Loop-Back
CMD
Mx&mdash.Custom Function Routine Control
CMD
MA&mdash.Request CFR Status
CMD
MB&mdash.Allocate Space for CFR
CMD
MC&mdash.Load CFR Image
CMD
MD&mdash.Start CFR
CMD
P&mdash.Set Terminal Mode
CMD
Q&mdash.Read User Variable
CMD
R&mdash.Read Terminal Memory
CMD
V&mdash.Positive or Negative Response to Remote Validation
Chapter
7. Power-Up and Download Specifications
Power-Up
Requirements
Parameter
File Initialization Sequence
Parameter
File Download Sequence
Chapter
8. RAM Files
General
File Rules
File
Descriptions
File
0&mdash.Terminal Operating Parameters
Transaction
Programming
User
Variables
File
0&mdash.Record 00 (Configuration Record)
File
0&mdash.Records 01-64 (Transaction Program Commands)
Transaction
Program Commands (Alphanumeric Order)
Transaction
Program Commands (Functional Order)
Transaction
Program Command Descriptions
Clock
Control Key Command
:5&mdash.Set
Time-of-Day Clock
Command
Format
Parameter
Description
Custom
Function Routine Key Command
;M&mdash.Call
CFR 0-9
Command
Format
Parameter
Description
Data
Control Key Commands
:A&mdash.Automatic
Transaction Build
Command
Format
Parameter
Description
:W&mdash
Write Data from Source to Target
Command
Format
Parameter
Description
;7&mdash.Append
Data to User Variable Data Strings
Command
Format
Parameter
Description
Bar
Code/Magnetic Data Input Key Commands
:1&mdash.Fixed
Length Badge Read with Validation
Command
Format
Parameter
Description
:4&mdash.Alphanumeric
Keys or Badge Input Expected with Validation
Command
Format
Parameter
Description
:R&mdash.Read
Data with Validation
Command
Format
Parameter
Description
;1&mdash.Read
Variable Length Badge.
Command
Format
Parameter
Description
DI/DO
Key Commands
:7&mdash.Toggle
DO Point 0
Command
Format
Parameter
Description
:M&mdash.Read
Value of DI/DO Point
Command
Format
Parameter
Description
:N&mdash.Wait
DI Point
Command
Format
Parameter
Description
:P&mdash.Write
DO Point
Command
Format
Parameter
Description
Display
Key Commands
:0&mdash.Display
Message from Message File
Command
Format
Parameter
Description
:6&mdash.Display
Message
Command
Format
Parameter
Description
:E&mdash.Show
Message
Command
Format
Parameter
Description
:T&mdash.Clear
Display
Command
Format
Parameter
Description
:U&mdash.Set
Cursor Position
Command
Format
Parameter
Description
;5&mdash.
Read Display Buffer
Command
Format
Parameter
Description
Keypad
Input Key Commands
:2&mdash.Numeric
Keypad Input (Models 150, 155, and 200 only)
Command
Format
Parameter
Description
:3&mdash.Alphanumeric
Keypad Input.
Command
Format
Parameter
Description
:R&mdash.Read
Data With Verification
Operator
Indicator Key Command
;C&mdash.Activate
Selected Operator Indicator
Command
Format
Parameter
Description
Transaction
Control Key Commands
:8&mdash.Link
Function
Command
Format
Parameter
Description
:9&mdash.NO-OP
Command
Format
Parameter
Description
:D&mdash.Delay
1-99 Seconds
Command
Format
Parameter
Description
:G&mdash.Goto
Command
Format
Parameter
Description
:GS&mdash.Gosub
Command
Format
Parameter
Description
:L&mdash.Program
Label
Command
Format
Parameter
Description
:Z&mdash.Onkey&mdash.Goto
Command
Format
Parameter
Description
:ZS&mdash.Onkey&mdash.Gosub
Command
Format
Parameter
Description
;0&mdash.Hot
Key
Command
Format
Parameter
Description
;2&mdash.Latching
Function
Command
Format
Parameter
Description
;6&mdash.Do
Not Transmit
Command
Format
Parameter
Description
;A&mdash.Alias
Transaction ID
Command
Format
Parameter
Description
;N&mdash.Conditional
Test
Command
Format
Parameter
Description
;R&mdash.Return
Command
Format
Parameter
Description
User
Variable Key Commands
:F&mdash.Append
Data
Command
Format
Parameter
Description
:H&mdash.Clear
Selected User Variable or Transaction Record
Command
Format
Parameter
Description
:J&mdash.Format
User Variable
Command
Format
Parameter
Description
:K&mdash.Verify
Selected User Variable
Command
Format
Parameter
Description
Examples
of Function Key Record Formats for File 0
Keypad
Operation
Operational
Chart
Advanced
Features
Writing
Prompts or Messages Using Cursor Control
Writing
Prompts or Messages to the Display Buffer
Using
Autofill with Key Entry Fields
Using
Cursor Controls with Key Entry Fields
Writing
Key Entry Fields to the Display Buffer
CAUTION:
File
1&mdash.Fast Clocking Times
Fast
Clocking Time Periods
Files
2-7&mdash.User Validation Files
File
8&mdash.Message File
File
9&mdash.Transaction Queue File
Validation
Transaction Format
File
a&mdash.User Defined Keypad Layout
Structure
of File a
Keypad
Key Mapping Locations
File
c&mdash.Custom Function Routine Support
File
e Extended Validation Support
Chapter
9. Writing Custom Function Routines
General
Requirements
Programming
Support Diskette
Non-Volatile
Storage
Memory
Models
Function
Prototypes
Stack
Considerations
Library
Function Usage
Program
Development
Examples
of CFR Usage
Examples
of CFR Tasks
Operating
with a CFR
Calling
the CFR
Multitasking
Considerations
Watchdog
Timer Considerations
Creating
and Sending Transactions
Returning
to the Transaction Program
Compiling
and Linking a CFR
General
Required
Compiler and Linker
Compile
Command
Link
Command
CFR
File Download Sequence
Overview
Procedure
ROM
Microcode Functions
Summary
List of the 7526 DCT Microcode APIs
Serial
Ports
DI/DO
Port
Keypad
Printer
Port
Date/Time
Sensor
Input Ports
Speaker
Timers
LCD
Display
General
Support
Reference&mdash.Communications
Ports (Serial)
ComInit
ComQuery
ComRead
ComWrite
Reference&mdash.DI/DO
Port
DiCtrRead
DiCtrWrite
DidoRead
DidoWrite
DoWritePoint
Reference&mdash.Keypad
KbdReadAscii
KbdSetMode
Reference&mdash.Printer
Port
PrtChar
PrtInit
PrtQuery
PrtQueryData
PrtSetBuffer
PrtSetStatus
PrtStr
Reference&mdash.Date/Time
RtcGetAsciiDate
RtcGetAsciiTime
Reference&mdash.Sensor
Input Ports
SenActLed
SenQueryPort
SenQueryPort2
SenRead
SenSetDiscrimGrp
Reference&mdash.Speaker
SpkBeep
Reference&mdash.Timer
functions
TimerSetAlarm
TimerClearAlarm
TimerSetInterval
TimerClearInterval
TimerSetAlarmAsynch
TimerClearAlarmAsynch
Reference&mdash.LCD
Displays
VioClear
VioGetCurPos
VioQuery
VioReadCharStr
VioSetCurPos
VioSetCurType
VioWrtCharStr
Reference&mdash.General
Support
AliasTransID
ClearUserVariable
ClearUserVariable2
DataFile
GetTerminalAddress
HitWatchdog
IdleManager
PntrFile0
ReadUserVariable
ReadUserVariable2
SendTransaction
Validation
WriteToTrans
WriteUserVariable
WriteUserVariable2
Appendix
A. Terminal Detected Errors
Appendix
B. Command and Special Key Relationships
Appendix
C. Terminal States and Terminal Controller Command Processing
Appendix
D. File 0 Record 00 Defaults
Appendix
E. Comparisons Between IBM 7525 and 7526 DCT Operations
Number
Descriptions
Appendix
F. New Features and Enhancements
Appendix
G. Terms and Abbreviations
+---Note!--------------------------------------------------------------------+
Before using this information and the product it supports, read the general
information under Chapter 1. "Notices".
+----------------------------------------------------------------------------+
Third Edition (July 1994)
Use this publication only for the purpose stated in the preface.
The following paragraph does not apply to the United Kingdom or any
country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION
"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING,
BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE.
Some states do not allow disclaimer of express or implied warranties
in certain transactions, therefore, this statement may not apply to you.
This publication could include technical inaccuracies or typographical
errors. Changes are periodically made to the information herein; these
changes will be incorporated in new editions of the publication. IBM may
make improvements and/or changes in the product(s) and/or the program(s)
described in this publication at any time.
It is possible that this publication may contain reference to, or information
about, IBM products (machines and programs), programming, or services that
are not announced in your country. Such references or information must
not be construed to mean that IBM intends to announce such IBM products,
programming, or services in your country.
THE PUBLICATION OF THE INFORMATION CONTAINED HEREIN IS NOT INTENDED
TO AND DOES NOT CONVEY ANY RIGHTS OR LICENSES, EXPRESS OR IMPLIED, UNDER
ANY IBM PATENTS, COPYRIGHTS, TRADEMARKS, MASK WORKS OR ANY OTHER INTELLECTUAL
PROPERTY RIGHTS.
Requests for copies of this publication and for technical information
about IBM products should be made to your IBM Authorized Dealer or your
IBM Marketing Representative.
The following paragraph applies only to the United States and Puerto
Rico:
A Reader's Comments form was printed at the back of this manual.
If it is missing, you may address comments to: IBM Corporation Manufacturing
Systems Products Department 27X, IZIP 2102 P.O. Box 1328 Boca Raton, Florida
33429-1328
IBM may use or distribute any of the information you supply in any way
it believes appropriate without incurring any obligations whatever.
References in this publication to IBM products, programs, or services do
not imply that IBM intends to make these available in all countries in
which IBM operates. Any reference to an IBM product, program, or service
is not intended to state or imply that only IBM's product, program, or
service may be used. Any functionally equivalent product, program, or service
that does not infringe any of IBM's intellectual property rights may be
used instead of the IBM product, program, or service. Evaluation and verification
of operation in conjunction with other products, except those expressly
designated by IBM, is the user's responsibility.
IBM may have patents or pending patent applications covering subject
matter in this document. The furnishing of this document does not give
you any license to these patents. You can send license inquiries, in writing,
to the IBM Director of Commercial Relations, IBM Corporation, Purchase,
NY 10577.
The following terms, which are denoted by an asterisk (*) in this
publication, are trademarks or service marks of IBM Corporation in
the United States and/or other countries: Operating System/2 OS/2
Personal System/2 PS/2
About this manual
The IBM 7526 Data Collection Terminal (DCT) Programming Technical Reference
provides a general overview of the DCT's functions and capabilities. It
gives a detailed description of the read-only memory (ROM) microcode functions
and serves as a reference for writing Custom Function Routines (CFRs).
In addition to having a general knowledge of data processing, you should
be familiar with the following:
-
IBM 7526 Data Collection Terminal
-
IBM PC DOS, version 3.3 or higher
-
IBM OS/2*, version 1.3 or higher
-
IBM Personal Computers (PCs), Personal System/2*, or industrial computers.
Review this document thoroughly before attempting to perform described
activities. When performing a sequence, do not skip steps unless they are
designated as optional; otherwise, the activity may not be successful and
errors may occur.