Thoroughbred BasicTM for
Windows Pocket PC
Installation Guide
Version 8.7.0
285 Davidson Avenue, Ste. 302 • Somerset, NJ 08873-4153
Telephone: 732-560-1377 • Outside NJ 800-524-0430
Fax: 732-560-1594
Internet address: http://www.tbred.com
Published by:
Thoroughbred Software International, Inc.
285 Davidson Ave., Suite 302
Somerset, New Jersey 08873-4153
Copyright ©2009 by Thoroughbred Software International, Inc.
All rights reserved. No part of the contents of this document
may be reproduced or transmitted in any form or by any means
without the written permission of the publisher.
Document Number: B8.7.0IPPC01
The Thoroughbred logo, Swash logo, and Solution-IV Accounting logo, OPENWORKSHOP, THOROUGHBRED, VIP FOR
DICTIONARY-IV, VIP, VIPImage, DICTIONARY-IV, and SOLUTION-IV are registered trademarks of Thoroughbred
Software International, Inc.
Thoroughbred Basic, TS Environment, T-WEB, Script-IV, Report-IV, Query-IV, Source-IV, TS Network DataServer, TS
ODBC DataServer, TS ODBC R/W DataServer, TS ORACLE DataServer, TS DataServer, TS XML DataServer, GWW,
Gateway for Windows™, TS ChartServer, TS ReportServer, TS WebServer, TbredComm, WorkStation Manager,
Solution-IV Reprographics, Solution-IV ezRepro, TS/Xpress, and DataSafeGuard are trademarks of Thoroughbred
Software International, Inc.
Other names, products and services mentioned are the trademarks or registered trademarks of their respective vendors or
organizations.
INTRODUCTION
The Thoroughbred Installation requires your Pocket PC device to be connected to a Windows
Workstation.
Using Windows Explorer from the Windows Workstation, first copy the Setup folder from your
Installation CD-ROM to your workstation. Then, copy the files listed below from your workstation to
your Pocket PC. You will need to create an IDL4 directory on your Pocket PC.
File to be copied:
IPLINPUT.TXT
GETSSN.EXE
Directory:
\
\
TCONFIGW
\IDL4
TSI.INI
TSICONST.INI
IBMPCDOS.TTF
\windows
\windows
\windows
B.EXE
\windows\start menu
Note: The IBMPCDOS.TTF may already exist.
Which Basic is Right for Your Pocket PC
Thoroughbred has two Basic executables that have been tested with the HP Jornada, Dell Axim, and the
Compaq iPaq. Both the Dell and Compaq devices use the same Basic. The HP requires a separate
compile. You can check the version of your Windows Pocket PC from your handheld device by doing the
following:
Compaq/Dell
From the Start Menu, click on Settings; System and then click on About. The version should read
similar to:
Microsoft Pocket PC
Version 3.0.11171 (Build 11178)
HP
From the Control Panel, click on System; click on the System Tab. The version should read similar to:
Microsoft Windows for Handheld PC 2000
Core System Version 3.0
Build 9546-126
Select the correct Basic for your Pocket PC device from the Setup\Basic folder.
1
Copyright © 2009 Thoroughbred Software International, Inc.
Supported with Version 8.7.0
The following Thoroughbred interfaces ARE supported with version 8.7.0:
•
INF(3,2) – returns the Owner from GETSSN
•
OPT=SOCKET
•
TS Network DataServer
2
Copyright © 2009 Thoroughbred Software International, Inc.
INSTALLATION
Install Basic
Using the Pocket PC device, run File Explorer and double-click GETSSN.EXE. You will be prompted
to enter your Serial Number, Owner and Company name. Select OK to serialize your Basic.
Before Running Basic
Copy your application from a Windows Workstation to a directory on your Pocket PC. Make sure to add
this directory to IPLINPUT.TXT. If your application is Dictionary-IV based, be sure to copy a premerged IDDBD to your Pocket PC.
Running Basic For The First Time
From the Start Menu, select B (you can rename the executable for a more descriptive Start name). You
will be prompted to complete the Thoroughbred Activation.
NOTE: Pocket PC Basics can be activated using Thoroughbred's Web-based Activation system
(www.tbred.com/b_activate.html).
3
Copyright © 2009 Thoroughbred Software International, Inc.
USING THE POCKET PC
Keyboard for the Pocket PC
The Basic menu bar includes the Pocket PC keyboard icon. Click on the keyboard icon to open the
keyboard. Click on it again to close the keyboard. The Pocket PC keyboard does not include some keys
often used with Thoroughbred Applications. You can access the following from the Thoroughbred menu
bar:
FKeys
displays all function keys
Keys
display editing keys
(CIns, CDel, LIns, LDel, LErase, Home, PgUp, PgDn, CtlB, Hot Key, Escape)
Menu
displays Copy, Paste, About, and Exit
Terminating the Basic Task
Your application should terminate Basic by doing a RELEASE. Clicking on the X in the top right-hand
corner will minimize your Basic session. To view running Pocket PC programs (including Basic), go to
Settings; System Tab; Memory; and then select the Running Programs Tab.
Using the Pen Stylus
The TSI.INI parameter file is pre-configured for mouse-aware. If you are running an OPENworkshop
8.5.0 or higher application, you can start using the Pen Stylus immediately. Otherwise, you will need to
incorporate mouse-aware into your application's INPUT routines. See the 8.6.0 Thoroughbred Basic
Release Notes for more information.
4
Copyright © 2009 Thoroughbred Software International, Inc.
EXCEPTIONS USING POCKET PC BASIC
The following functionality is NOT available with the Pocket PC Basic:
•
INF(3,x); API; OPT=DDE; SYSTEM; Large file support; File locks
The following File/Database access is NOT supported:
•
Btrieve, MicroFocus C-ISAM, ODBC
The following Thoroughbred interfaces are NOT supported:
•
VIP, TS Oracle DataServer, TS DataServer for SQL Server
•
Only Type 4 printers are supported with the initial release.
5
Copyright © 2009 Thoroughbred Software International, Inc.
CHANGES TO DEFAULT SETTINGS
The typical Pocket PC has fewer resources than a Windows Workstation. Therefore a number of internal
default settings were reduced. Depending on your application, you may want to increase some of these
values. For example, OPENworkshop does not run well without increasing the number of Public
Programs.
Description
Standard
Pocket PC
Number of loaded programs
use PRM PUBLICS= to change
Expands dynamically
100
20
Number of open object libraries
48
8
Number of open LINKS
Expands dynamically
100
20
Number of included formats
Expands dynamically
100
20
Initial I/O Buffer (bytes)
40000
16352
6
Copyright © 2009 Thoroughbred Software International, Inc.
ADDRESSING SCREEN POSITIONING
The Pocket PC screen does not display an 80x24. Some devices may only display 32 characters wide and
18 lines. Your application will need to take this into consideration. The Thoroughbred main window is
still 80x24. Vertical and horizontal scroll bars are available to pan the visible portion of the screen. Your
application can also pan the screen to a defined position using a new terminal mnemonic.
PRINT ‘PANTO’,@(15,5)
This moves the 15,5 to the top left corner of the Pocket PC screen.
Examples:
WINDOW CREATE(20,10,15,5) “BORDER=LG”; PRINT ‘PANTO’,@(15,5),
This example creates a new 20x10 Basic window at column 15 row 5 with a line-graphic border. The
PANTO mnemonic scrolls the main Basic window so that new 20x10 window is in the top left corner of
the visible screen.
PRINT ‘PANTO’,@(40,10),; INPUT @(40,10),A$
This example uses the PANTO mnemonic to scroll the screen so that column 40 row 10 is in the top left
corner of the visible screen. The input directive that follows will occur in the top left corner of the visible
screen.
7
Copyright © 2009 Thoroughbred Software International, Inc.
">
