Worth Data RF Terminal 7000 Programming Manual Download Page 5

Let's say your operator is 

SIGNED ON 

and decides it's time to take a break. Instead of pressing the F1 

key to 

SIGN OUT

, he presses the OFF key. Pressing the OFF key is OK (it will 

SIGN 

him 

OUT

) but there 

is a delay until the 

SIGN OUT 

is acknowledged. Because of the delay, the operator might think he didn't 

press the key hard enough and press it again - this time actually powering down the Terminal before the 

SIGN OUT 

was complete. If this happens, you need to plan to resend the last prompt to the Terminal 

when he 

SIGN

ON 

again.

PromptCOM: The 

WDterm

 ActiveX Control

Drop-in components are tools that are added to your programming environment "tool kit". There are a variety of 
different technologies around for implementing a drop-in component such as VBX (for Visual Basic) and VCL (for 
Delphi and C Builder) and COM (ActiveX). Only the 

ActiveX 

variety are widely compatible with almost all 

development environments.

PromptCOM/ActiveX 

is a drop in COM component that allow programmers to easily add the ability to send 

prompts to and receive data from their R/F Terminal via an RF Base Station. It is compatible with Visual Basic, 
Visual C++, Delphi, and most other 32-bit development platforms. See the help file for installation instructions.

Programming Considerations

Before making any method calls, make sure to:

Set the COM port properties (device name, baud, parity, bits, etc.) as desired. Make sure the port is 
closed (call 

CloseDevice

) before making changes to any of the port settings.

Call the 

OpenDevice 

method. This activates the COM port used by this instance of the 

WDterm 

control.

Set the 

ActiveTerminal 

property to identify the terminal on which you desire to operate. You can change 

the 

ActiveTerminal 

at any time in order to direct commands to appropriate terminals.

Test For Good Communication

Implement an 

event handler 

for 

OnTermBaseRegister 

that causes a beep or displays a message when 

called. If communication between the host PC and the base station is good, your 

event handler 

will fire 

when your program is running and you power up an attached base station.

Multiple Base Stations

For installations using multiple base stations attached to a single host PC (these were called "channels" 
in PromptCOM/DLL) simply add a Wdterm control to your application for each base station.

Terminal Tracking

Since you get one set of event handlers for each base station, you will need some scheme for keeping 
track of where each terminal (up to 64 per base station) is in its transaction sequence. One possible 
solution is to use a "state"variable for each terminal (perhaps stored in an array). Test the state variable to 
determine the next prompt for any given terminal.

It is very important to keep track of "login status" for each terminal. Every SignOut event should have an 

Summary of Contents for RF Terminal 7000

Page 1: ......

Page 2: ...Table of Contents How The System Works Before You Begin Properties Methods Events ...

Page 3: ... Base Station to handle up to 64 Terminals Dialog is established when a Terminal SIGNS ON to the RF network The host computer application waits until a Terminal SIGNS ON then begins its processing by sending the first prompt out to the Terminal via the Base Station If the Terminal does not receive a prompt from the host it goes into sleep mode waking up and checking with the Base periodically to s...

Page 4: ...e most frequent failures are at the Terminal level If a Terminal has a hardware failure it will not be able to SIGN OUT It is possible for the Terminal operator to press the ON OFF key or the F1 key by accident forcing the Terminal to SIGN OUT sometimes in the middle of a transaction This happens at battery changing time also You need to plan for partial transactions do you trash the data you do h...

Page 5: ... method calls make sure to Set the COM port properties device name baud parity bits etc as desired Make sure the port is closed call CloseDevice before making changes to any of the port settings Call the OpenDevice method This activates the COM port used by this instance of the WDterm control Set the ActiveTerminal property to identify the terminal on which you desire to operate You can change the...

Page 6: ...ly generated The code in the Event Handler is called fired by the drop in component when a specific event occurs An example of an event is when a terminal returns data and the OnTermData event is fired The details of how to access Properties Methods Events varies between development platforms Details of how it works in some of the most popular platforms is illustrated in the samples included with ...

Page 7: ...etting WDterm may allow other settings but those listed here are the only ones compatible with current version base stations ComDataBits Valid values 7 8 Definition This is a serial port setting and must match the base station setting WDterm may allow other settings but those listed here are the only ones compatible with current version base stations ComStopBits Valid values 1 2 Definition This is...

Page 8: ...enDevice before other method calls will work DefineFormat 15 Line Terminal Only Parameters font linecount Function This adds a line formatting definition This command is called multiple times to build a display formatting definition for multiple lines which is then sent to the ActiveTerminal by the SendFormat command Font is an integer code 0 small 1 medium 2 large Linecount is a number 1 15 indic...

Page 9: ...rompt shifted timestamped FG BG Function This instructs the ActiveTerminal to display the prompt at line and position and wait for data to be entered from the terminal keypad only If shifted is set to true the terminal will start in shifted mode Timestamped appends a hhmmss prefix to the returned data FG and BG are ForeGround and BackGround colors for the 7001 15 line terminal See Color Codes Inpu...

Page 10: ...and position and wait for data to be received through the terminal serial port Waiting for serial input can be bypassed by pressing the enter key on the terminal which will send an empty data string to the host fires the OnTermData event handler FG and BG are ForeGround and BackGround colors for the 7001 15 line terminal See Color Codes OutputSerial All Terminal Versions Parameters data Function T...

Page 11: ...ts the ActiveTerminal to display date and time on the specified line number Must be followed by an Input method call to take effect Beep All Terminal Versions Parameters count Function This instructs the ActiveTerminal to beep count times Count may be a value from 1 to 9 Must be followed by an Input method call to take effect PlayVoice All Terminal Versions Parameters msgnum Function This instruct...

Page 12: ...ns Parameters TermNumber Function Returns the actual terminal ID letter code for a given terminal number Use the returned character to match with the Terminal ID programmed into a RF Terminal GetErrCode All Terminal Versions Function Returns code for the most recent error Calling this method resets the Error Code to 0 Error Codes 0 No Error 1 Command Data Too Long 2 Error on Close Device 3 Serial ...

Page 13: ...before any events can be fired NOTE If you are experiencing problems with exception errors make sure you are not calling any WDterm methods from inside WDterm event handlers Instead use the event handlers to set program variables that are monitored elsewhere perhaps in a timer event handler Call WDterm methods from the monitoring function OnTermBaseRegister Event An attached base station has succe...

Page 14: ...you have already entered some data on the terminal and press an arrow key this event will not fire See the programming section in the RF Terminal manual for details OnTermLeftArrow Data passed terminal Event The left arrow button has been pressed on a terminal You must issue another Input method call before WDterm can respond to another keypress on the terminal If you have already entered some dat...

Page 15: ...inal Event The SEARCH button has been pressed on a terminal You must issue another Input method call before WDterm can respond to another keypress on the terminal If you have already entered some data on the terminal and press the Search key this event will not fire See the programming section in the RF Terminal manual for details ...

Reviews: