959 Terry Street
Eugene, Oregon 97402
Telephone: (541) 683-5700
Fax: (541) 345-7140
An Unpublished Work - All rights reserved. No part of the contents of this documentation or the procedures
described therein may be reproduced or transmitted in any form or by any means without prior written permission of
PSC Inc. or its wholly owned subsidiaries ("PSC"). Owners of PSC products are hereby granted a non-exclusive,
revocable license to reproduce and transmit this documentation for the purchaser's own internal business pur
poses. Purchaser shall not remove or alter any proprietary notices, including copyright notices, contained in this
documentation and shall ensure that all notices appear on any reproductions of the documentation.
Should future revisions of this manual be published, you can acquire printed versions by contacting PSC Customer
Administration. Electronic versions may either be downloadable from the PSC web site (www.pscnet.com) or pro
vided on appropriate media. If you visit our web site and would like to make comments or suggestions about this or
other PSC publications, please let us know via the “Contact PSC” page.
Disclaimer
Reasonable measures have been taken to ensure that the information included in this manual is complete and
accurate. However, PSC reserves the right to change any specification at any time without prior notice.
PSC is a registered trademark of PSC Inc. The PSC logo is a trademark of PSC. All other trademarks and trade
names referred to herein are property of their respective owners.
Falcon® is a registered trademark of PSC.
-
Microsoft Windows®, Windows® NT, Windows® ME, Windows® 95, Windows® 98, and Windows® 2000 are registered
trademarks of Microsoft Corporation.
Index .................................................................................................. 183
viPT Program Generator (PPG) v5.0
PSC Inc.
PT Program Generator
(PPG) Software End User
License Agreement
NOTICE TO END USER:
conditions of this Agreement. If you use the Software, you will be deemed to have accepted the terms and conditions of this
Agreement. If you do not intend to be bound by the terms of this Agreement, PSC is not willing to license the Software to you, you
may not use or copy the Software, and you must contact the party from whom you acquired the Software promptly for instructions.
This End User License Agreement (“Agreement”) is a legally binding agreement governing the licensing of the Software by PSC Inc. and its
wholly owned subsidiaries and affiliates (“PSC”) to the entity or person who has acquired the Software (“End User”). For purposes of this
Agreement, “Software” means the PT Program Generator, whether obtained directly or indirectly from PSC, including any related update or
upgrade such as enhancements or modifications, and including all accompanying documentation. Any software that is associated with a
separate end-user license agreement is licensed to you under the terms of that license agreement. PSC and End User hereby agree as follows:
1. Scope of License Granted.
1.1 PSC grants to End User a non-exclusive, non-transferable, perpetual license to use the Software, in machine-readable form only, solely for
End User's internal business purposes. This Agreement does not convey ownership of the Software to End User. Title to the Software shall be
and remain at all times with PSC or any third party from whom PSC has obtained a licensed right.
1.2 Each Software license permits End User to install the Software on a single computer only. A separate Software license must be acquired for
each computer on which the Software operates.
1.3 End User may make one copy of the Software for backup purposes, provided that End User reproduces all proprietary notices on the copy,
including patent, copyright, trademark, and other similar notices of PSC's proprietary interest in the Software.
1.4 End User shall not sell, assign, sublicense, distribute, lend, rent, give, or otherwise transfer the Software to any third party unless such third
party agrees with PSC in writing to be bound by the terms and conditions of this Agreement. Any such transfer of the Software absent such
agreement shall be null and void.
1.5 Other than as provided in this Agreement, End User shall not copy or modify the Software. Under no circumstances shall End User
decompile, disassemble, reverse engineer, or otherwise reproduce or remanufacture the Software, whether modified or unmodified, without
PSC's prior written consent.
1.6 Any copying, installing, reproduction, reverse-engineering, electronic transfer, or other use of the Software 1) on other than the number of
computers for which End User has paid for a Software license, or 2) on any non-PSC equipment, will be a material breach of this Agreement.
However, PSC may elect not to terminate this Agreement or the granted license, but instead may elect to notify End User that End User is
deemed to have ordered and accepted a license for each breaching use. End User shall pay PSC the applicable list price fees for each such
license as of the date of breach as determined by PSC.
PSC is providing you with a license for the Software you have acquired, subject to the terms and
User’s Guide vii
(PPG) Software End User License Agreement
2. Intellectual Property.
End User acknowledges that the Software constitutes valuable trade secrets of PSC and that the Software is protected by intellectual property
laws and treaties. The license set forth in this Agreement does not transfer to End User any ownership of PSC's copyrights, patents, trademarks,
service marks, trade secrets, or other intellectual property rights and End User shall have no right to commence any legal action to obtain such
rights. End User shall not remove, modify, or take any other action that would obscure any copyright, trademark, or other intellectual property
notices contained in the Software.
3. Proprietary Information.
3.1 “Proprietary Information” means all (a) source code, object code, software, documentation, and any related internal design, system design,
data base design, algorithms, technology, technical data or information, implementation techniques, and trade secrets related to the Software,
(b) any other trade secrets marked appropriately or identified as proprietary or confidential, and (c) any information that End User, under the
circumstances, should recognize as confidential. Proprietary Information does not include any information that the receiving party can establish
was (1) in the public domain, (2) already in the receiving party's possession or rightfully known prior to receipt, (3) rightfully learned from a third
party not in violation of any other's proprietary rights, or (4) independently developed.
3.2 End User acknowledges that Proprietary Information is the confidential, proprietary, and trade secret property of PSC and End User
acquires no right or interest in any Proprietary Information.
3.3 End User shall not disclose, provide, or otherwise make available PSC's Proprietary Information to any person other than End User's
authorized employees or agents, all of whom must be under confidentiality agreement at least as restrictive as the terms of this Section 3, and
End User shall not use the Proprietary Information other than in conjunction with use of the Software exclusively for End User's internal business
purposes. End User shall take steps to protect the Proprietary Information no less securely than if it were End User's own intellectual property.
3.4 The provisions of this Section shall survive and continue for five (5) years after the termination of this Agreement.
4. Limited Warranty.
4.1 PSC warrants that, under normal use and operation, the Software will conform substantially to the applicable documentation for a period of
thirty (30) days from delivery to End User. During this period, for all reproducible nonconformities for which PSC has been given written notice,
PSC will use commercially reasonable efforts to remedy nonconformities determined by PSC. End User agrees to supply PSC with all
reasonably requested information and assistance necessary to help PSC in remedying such nonconformities. For all defects reported to PSC
within the warranty period, PSC's liability is limited to providing End User with one copy of corrections or refunding the amount End User paid for
the Software license, at PSC's discretion, and responding to End User's software problem reports according to PSC's standard assistance
practices. PSC does not warrant that the Software will meet End User's requirements or that use of the products will be uninterrupted or error
free, or that PSC's remedial efforts will correct any nonconformance. This limited warranty does not cover any software that has been
customized, subjected to damage or abuse, whether intentionally, accidentally, or by neglect, or to unauthorized repair, unauthorized alteration,
or unauthorized installation, and shall be void if End User modifies the Software, uses the Software in a manner other than as established in the
applicable documentation, or if End User breaches any of the provisions of this Agreement.
4.2 THE SOFTWARE IS PROVIDED “AS IS” AND, EXCEPT AS PROVIDED IN THIS SECTION, PSC MAKES NO WARRANTIES OF ANY
KIND, EXPRESS OR IMPLIED, WRITTEN OR ORAL, WITH RESPECT TO THE SOFTWARE, AND SPECIFICALLY DISCLAIMS THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
5. Infringement.
5.1 PSC will defend End User against any claim in a lawsuit that the Software furnished hereunder infringes a United States patent or copyright
of a third party and PSC will pay any damages finally awarded against End User by a court of competent jurisdiction that are attributable to such
claim or will pay End User's part of any settlement that is attributable to such claim, provided, that 1) End User notifies PSC promptly in writing
of the claim, 2) PSC controls the defense or settlement of the claim, and 3) End User cooperates fully with PSC in such defense or settlement.
All notices of a claim should be sent to PSC Inc., Legal Department, 111 SW Fifth Ave. Suite 4100, Portland, OR 97204-3644.
5.2 In the defense or settlement of any such claim, PSC may, at its option, 1) procure for End User the right to continue using the Software, 2)
modify the Software so that it becomes non-infringing, 3) replace the Software with an equivalent product not subject to such claim, or 4) provide
End User an opportunity to return the Software and receive a refund of the amount End User paid for the Software license, less a reasonable
allowance for use.
viiiPT Program Generator (PPG) v5.0
PT Program Generator
5.3 PSC shall have no liability to End User for claims of infringement based upon 1) the use of the Software in combination with any product
which PSC has not either furnished or authorized for use with such Software, 2) the use of any Software designed, manufactured, or modified to
the specifications of End User, or 3) End User's customization or modification of the Software.
5.4 THE FOREGOING STATES PSC'S COMPLETE AND ENTIRE OBLIGATION TO END USER CONCERNING CLAIMS OF INTELLECTUAL
PROPERTY INFRINGEMENT, CANCELS AND SUPERCEDES ANY PRIOR AGREEMENTS, WHETHER ORAL OR WRITTEN, BETWEEN
PSC AND END USER CONCERNING SUCH CLAIMS, AND WILL NOT BE MODIFIED OR AMENDED BY ANY PAST,
CONTEMPORANEOUS, OR FUTURE AGREEMENTS OR DEALINGS BETWEEN PSC AND END USER, WHETHER ORAL OR WRITTEN,
EXCEPT AS SET FORTH IN A FUTURE WRITING SIGNED BY AN AUTHORIZED REPRESENTATIVE OF EACH PARTY.
6. Limitation of Liability.
PSC'S LIABILITY FOR DAMAGES, IF ANY, WHETHER BASED UPON CONTRACT, TORT (INCLUDING NEGLIGENCE), PRODUCT
LIABILITY, STRICT LIABILITY, WARRANTY, OR ANY OTHER BASIS, SHALL NOT EXCEED THE AMOUNT END USER PAID FOR THE
SOFTWARE LICENSE. UNDER NO CIRCUMSTANCES SHALL PSC BE LIABLE FOR LOST PROFITS, LOST DATA, INTERRUPTION OF
SERVICE, OR FOR ANY SPECIAL, CONSEQUENTIAL, CONTINGENT, INDIRECT, INCIDENTAL, PUNITIVE, EXEMPLARY, OR OTHER
SIMILAR DAMAGES, EVEN IF PSC HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
7. Technical Support.
End User is entitled to one (1) free technical support call in connection with End User's use of the Software. Technical support does not include
assisting End User in developing applications. End User may obtain additional support for the Software from PSC at PSC's standard support
fees and under PSC's standard support terms and conditions in effect at the time End User acquires the Software.
8. Government Restricted Rights; International Use.
The Software is provided with Restricted Rights. Use, duplication, or disclosure by the U.S. Government is subject to the restrictions for
computer software developed at private expense as set forth in the U.S. Federal Acquisition Regulations at FAR 52.227-14(g), or 52.227-19 or in
the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013(c)(1)(ii), whichever is applicable. If End User uses the
Software outside the United States, End User must comply with the local laws of the country in which the Software is used, with U.S. exp or t
control laws, and with the English language version of this Agreement. The provisions of the “United Nations Convention on International Sale of
Goods” shall not apply to this Agreement.
9. Termination.
9.1 Either party may terminate this Agreement or any license granted under this Agreement at any time upon written notice if the other party
breaches any provision of this Agreement.
9.2 Upon termination of this Agreement, End User immediately shall cease using the Software and shall return to PSC or destroy all Software
covered by this Agreement, and shall furnish PSC with a certificate of compliance with this provision signed by an officer or authorized
representative of End User.
10. General Provisions.
10.1 Entire Agreement; Amendment. This Agreement contains the entire agreement between the parties relating to the Software and
supersedes all prior or contemporaneous agreements, written or oral, between the parties concerning the Software. This Agreement may not be
changed, amended, or modified except by written document signed by an authorized representative of each party.
10.2 Notice. All notices required or authorized under this Agreement shall be given in writing, and shall be effective when received, with
evidence of receipt. Notices shall be sent to End User at such address as End User shall provide to PSC in writing, and shall be sent to PSC
Attn: Contract Administration, PSC Inc., 959 Terry Street, Eugene, OR 97402.
10.3 Waiver. A party's failure to enforce any of the terms and conditions of this Agreement shall not prevent the party's later enforcement of such
terms and conditions.
10.4 Governing Law. This Agreement shall be governed by the laws of the State of Oregon, United States of America, excluding choice of law
provisions.
10.5 Attorneys Fees. In the event an action is brought to enforce the terms and conditions of this Agreement, the prevailing party shall be
entitled to reasonable attorneys' fees, both at trial and on appeal.
-END-
User’s Guide ix
(PPG) Software End User License Agreement
NOTES
xPT Program Generator (PPG) v5.0
This document assumes that you are familiar with Microsoft Windows®. If you do not
know how to launch applications, select menu options, or use dialog boxes, please
refer to your Microsoft Windows documentation before proceeding with PPG.
Document Overview
This document is divided into seven chapters and eight appendices:
Introduction on page 1, provides an overview of PPG, describes the con-
•
ventions used in this manual, and tells how to access PSC Technical
Support.
Getting Started on page 5, tells you how to install and run PPG. It also
•
gives you an overview of PPG concepts and usage.
•
PPG Application Design on page 15, provides information on program-
ming concepts including how to design your program, define program modules and specify program flow.
Chapter 1
Introduction
The PPG Menubar on page 23 describes the PPG menubar and how to
•
access all PPG’s features using the menubar, including creating, saving
and editing applications.
Creating & Using Nodes on page 49, gives you detailed information on
•
Frames, Subroutines, Nodes, and Links.
•
Managing Data on page 77, describes the use of Registers, Fields, Files,
and Templates.
•
PT40 Communication on page 89, show you how to download applica-
tions to the PDT and how to transfer data to and from the portable
device.
PPG Tutorial on page 99, is a step-by-step tutorial to use in learning PPG.
•
User’s Guide 1
Introduction
•Example Frames on page 135, contains sample code for commonly used
functions.
•
The PPG Library on page 159, describes the applications that come with
PPG.
•
PPG System Commands on page 163, identifies the system commands
that can be used with PPG.
•
ASCII/Hex Conversion Table on page 167, contains a table of ASCII charac-
ters for your reference.
•
Useful Bar Codes on page 169, contains bar codes that can be used to
program your portable data collection unit.
•
Troubleshooting on page 171, provides troubleshooting information and
table of possible error messages.
•
Glossary on page 179, is a glossary of the specific PPG programming
terms used in this manual.
Style Conventions
Formatting conventions are used throughout this document to provide a consistent method for representing various screen shots, buttons, controls, keyboard characters, notes, and cautions while you are working with PPG.
Manual Formatting Conventions
Keyboard Keys
Keyboard keys, such as ENTER, are in Bold. When keyboard keys are Linked
with a plus sign (for example,
key while pressing the second key once.
Keystrokes
Input characters, filenames, file paths, field selections from a pull-down list,
and data or keystrokes entered by the user are shown in courier bold.
Input characters are usually given in lowercase (no capital letters); you may
enter them in lowercase, uppercase, or a combination. When input characters
are given in uppercase or a combination of lowercase and uppercase, type the
characters exactly as shown.
2PT Program Generator (PPG) v5.0
SHIFT+ENTER, or Ctrl+C), hold down the first
Style Conventions
Windows Controls
Words in Bold are selections that appear in the PPG program, such as frame
names, subroutine names, node names, file, field, template, and register
names, menu options, buttons, dialog boxes, field names, and radio-buttons.
Words in
order provided. For example,
select
Cautions indicate an action where there is a possibility of damage to data integrity or
data failure. Cautions always have the Caution icon to the left.
CAUTION
Notes provide additional information on a topic, including technical details, exceptions to instructions and other pertinent information. Notes always have the notepad
icon to the left.
Mouse Actions
Click or SelectPress and immediately release the left mouse button without moving
Double ClickClick the left mouse button twice in rapid succession. Used to initiate an
Right ClickPress and hold the right mouse button without moving the mouse.
Bold separated by an arrow (>) are menu actions you make in the
File > Run means select the File menu and then
Run from that menu.
the mouse. Clicking is used to select specific buttons on various forms
and tables.
application.
Portable Keys
Keys on the portable data terminal (PDT) unit are bracketed with < >, to identify that they refer to the portable data collection unit, rather than the PC.
<F1> — <F8> KeysThe
<ENTER> KeyTo differentiate the
User’s Guide 3
Function keys, <F1> – <F8>, are used specifically on the
PT40 portable data collection units.
<ENTER> key on the portable from the Enter
key on the PC’s keyboard, portable keys are formatted as “press
<ENTER>”.
Introduction
NOTES
4PT Program Generator (PPG) v5.0
Overview
Chapter 2
Getting Started
Refer to this section as you prepare to install and use the PT Program Generator (PPG). The following general topics are covered:
Before You Start on page 6
•
•What’s New in PPG v5.0? on page 6.
•
PPG License Agreement on page 6.
•
Registering Your Copy of PPG on page 6.
PPG Installation on page 6
•
•PPG System Requirements on page 6.
•
Required Hardware on page 6.
•
Operating Systems on page 7.
•
Supported Portables on page 7.
•
Installing PPG on page 7.
Upgrading to PPG v5.0 on page 8.
•
Launching and Exiting PPG on page 8
•
•Overview of PPG on page 9
•PPG Tutorial on page 10.
•
User Interface on page 11.
•
Menus and Toolbars on page 11.
•
PPG Toolbar Buttons on page 11.
•
Program Nodes Toolbar on page 12.
•
Working with PPG Windows on page 13.
•
Navigation on page 13.
Generating the Program on page 14.
•
•
Downloading the Program on page 14.
•
Transferring Data on page 14.
User’s Guide 5
Getting Started
Before You Start
What’s New in PPG v5.0?
The following features are new to this version of PPG:
•PPG v5.0 works with PSC’s Falcon PT40.
•Improved user interface provides buttons to access program nodes and
controls.
•Double-byte language support for Chinese Simplified and Chinese
Traditional characters.
PPG License Agreement
Review the license agreement; it gives you permission to copy the program
files for backup purposes only. You may not make a copy for another person to
use. When you open the envelope that contains the software, this means that
you agree to the terms of the license agreement.
Registering Your Copy of PPG
PSC values your feedback. Please take a few moments and complete the Product Registration form located on PSC's website or on the PSC Manuals CD.
Registering your products ensures that you will be informed of the latest product news, software updates and other future developments from PSC.
PPG Installation
PPG System Requirements
PPG runs with the minimum hardware and operating system requirements
listed below. For maximum performance, install PPG onto a computer with a
higher speed processor and more memory than the minimum requirements.
Required Hardware
The following equipment is required to run PPG:
•Processor - 450MHz
•Memory - 12MB
•Hard Disk - 10MB
6PT Program Generator (PPG) v5.0
•Video - VGA
•A CD-ROM drive
•A serial port (for loading your program into a portable)
Operating Systems
PPG works with the following Microsoft® Windows® operating systems:
•Windows
•Windows
•Windows
•Windows
•Windows
Supported Portables
PPG v 5.0 only supports the PSC Falcon PT40. A compatible docking station
or communications cable is required for the PDT to work with PPG. Contact
a portable data collection supplier to purchase the required equipment and
accessories.
®
98 (SP5)
®
2000 (full double-byte functionality)
®
Me (SP5)
®
NT (SP6)
®
XP (full double-byte functionality)
PPG Installation
Installing PPG
Complete the following steps in the installation utility to install PPG:
1. Insert the PPG Installation disk into your PC’s CD drive. A
screen opens.
2. Press
3. Press
Next on the Welcome screen to continue the installation.
Yes, I A c c e p t at the License Agreement screen to continue the
PPG installation process and accept the PPG license agreement.
4. At the
Destination Location screen, select the PPG destination direc-
tory:
•PPG installs to C:\Program Files\PSC\PPG50 by
default.
•Press the
Browse button to select or create another directory in
which to install PPG.
5. Press
6. Press
Next to select the installation of the PT40 software and PPG.
Next to begin the installation of PPG. A series of Installing....
screens appear.
User’s Guide 7
Welcome
Getting Started
7. Finally, a message that PPG has been successfully installed is displayed.
8. Press
Finish to exit the installation.
Upgrading to PPG v5.0
If you want to upgrade to PPG v5.0, complete the instructions in Installing PPG
on page 7. By default, PPG v5.0 is installed in a different default location on
your PC’s hard drive than PPG v4.5, so it is possible to have both versions
installed at the same time.
Prior PPG version source files (*.scr) are converted when you open and save
them in PPG v5.0. To maintain PPG v4.5 compatible applications, open them
in PPG v5.0 and save them with a new name or new location.
There is no keyboard wedge support in PPG v5.0. Applications created in previous
versions of PPG that use the keyboard wedge option can be saved in PPG v5.0, but
they must be updated with a new input method after you save them.
Uninstalling PPG
To uninstall PPG, use the standard method of removing programs installed on
Microsoft Windows:
1. From the Windows
Remove Programs
2. At the
Add/Remove Programs window, select Change or Remove Pro-
grams
along the left side of the window.
Start menu, select Settings > Control Panel > Add/
.
3. Scroll down the screen until you locate
PT Program Generator and
select it by clicking on it with your mouse.
4. Press
Change/Remove to initiate the program removal process.
Launching and Exiting PPG
Launching PPG
To launch PPG, complete the following steps:
1. Select PPG from your Windows
> PT Program Generator.
8PT Program Generator (PPG) v5.0
Start Menu > PT Program Generator
Figure 1. The PPG Window
Overview of PPG
2. The PPG window opens as illustrated in Figure 1 with a new, blank
PPG application.
Exiting PPG
To exit PPG, select File > Exit from the menubar or double-click on the Con-
trol-menu
current file. Select
box. A dialog appears, asking if you want to save any changes to the
Yes to save changes or No to discard them.
Overview of PPG
Use PPG to construct and design an application for your PSC portable. You
can create custom applications to collect, verify, and store data. Designing and
creating the program is the first part of the process; there are several steps
involved. Refer to
PPG to construct an application for your PSC portable.
User’s Guide 9
PPG Application Design on page 15 for an overview of using
Getting Started
PPG Tutorial
To become familiar with PPG, complete the PPG Tutorial on page 99, or access
the PPG Tutorial via the on-line help.
Program Files
Executable Programs
Following is a list of executable programs that are installed on your PC during
the installation of PPG:
PPGPPG is the PT Program Generator application. This is the application you
PPGXFERPPGXFER is used to transfer the program you created in PPG to the porta-
PPGCompPPGComp (PPG Compiler) is used to compile the program you created into
XFER32XFER32 is used to transfer data between a PC and the portable. After you
use to create programs for a PSC portable.
ble. This utility is called automatically by PPG when you download a program
to the portable. Refer to Downloading the Application to the PDT on page 89
and Specialized Download Situations on page 92
the format which is downloaded to the PDT. This utility is called automatically
by PPG when you download a program to the portable. Refer to Download-
ing the Application to the PDT on page 89.
input data or scan bar codes with the portable, you can use this utility to
upload the data into a file on your PC. You can also use it to download information stored in a PC file into the portable. Refer to Using XFER32 on
page 92.
.
Sample Program Files
PPG comes with four sample files. Some of these files are just portions of programs demonstrating use of a specific node. However, you can use any of these
samples as a foundation for building a full-size program:
sample.scr
sample2.scr
sample.scr allows you to collect information with your portable,
upload collected data to a PC, and erase collected data. You will be using
this file as you work through PPG Application Design on page 15
PPG Tutorial on page 99
.
and the
sample2.scr is a simple but complete data-collection program that
allows the user to enter data as either item-and-quantity values or just item
values. The program also stores data, uploads data, and erases data.
10PT Program Generator (PPG) v5.0
Overview of PPG
sample3.scr
sample4.scr
sample3.scr is an expanded version of sample2.scr that
includes review and edit capabilities. (This is the program that was loaded
with your portable when you first got it.)
sample4.scr is an application which illustrates multiple frame levels.
This example is useful as a model for designing complex applications.
PPG also comes with some example frames and files, discussed in Example
Frames on page 135. You can download additional PPG library files, discussed in
The PPG Library on page 159, from PSC’s website.
User Interface
Menus and Toolbars
The PPG menubar is discussed in detail in The PPG Menubar on page 23. In
Figure 2, the top toolbar is the PPG toolbar. The second toolbar is the Program
Nodes
toolbar. Refer to View Menu on page 38 for information on toggling the
PPG toolbar and the Program Nodes toolbar on and off.
Figure 2. PPG Menubar, PPG Toolbar, and Program Nodes Toolbar
PPG Menubar
PPG Toolbar
Program Nodes Toolbar
Refer to the following tables for descriptions of PPG toolbar and Program
Nodes
toolbar buttons, their basic functions, and a Link to the section that
discusses the function in detail.
PPG Toolbar Buttons
Click this Button To
New
Open
Save
Cut
User’s Guide 11
Create a new PPG flow chart file.
Refer to Creating a New File (Ctrl+N) on page 24
Open an existing PPG flow chart file.
Refer to Opening an Existing File (Ctrl+O) on page 25
Save an existing PPG flow chart file.
Refer to Saving a File (Ctrl+S) on page 25
Cut the selected node to the clipboard.
Refer to Cut (Ctrl+X) on page 35
.
.
.
.
Getting Started
Click this Button To
Copy
Paste
Print
Help
Copy the selected node to the clipboard.
Refer to Copy (Ctrl+C) on page 35.
Paste the cut or copied node to the flow chart.
Refer to Paste (Ctrl + V) on page 35
.
Open the Print dialog box.
Refer to Printing a File (Ctrl+P) on page 26.)
Open the PPG online Help file.
Refer to PPG Help (F1) on page 47
.
Program Nodes Toolbar
To create new PPG Program Nodes, click on the node’s Create button:
Click this ButtonTo
FrameCreate a new
SubroutineCreate a new
Menu
Create a new
DisplayCreate a new
InputCreate a new
Output
Verify
Copy
Modify
Math
Create a new
Create a new
Create a new
Create a new Modify node. (Refer to Modify Nodes on page 67.)
Create a new
CallCreate a new
LinkCreate a new
Frame. (Refer to Frames on page 50.)
Subroutine. (Refer to Subroutines on page 51.)
Menu node. (Refer to Menu Nodes on page 55.)
Display node. (Refer to Display Nodes on page 56.)
Input node. (Refer to Input Nodes on page 57.)
Output node. (Refer to Output Nodes on page 60)
Verif y node. (Refer to Verify Nodes on page 63.)
Copy node. (Refer to Copy Nodes on page 66.)
Math node. (Refer to Math Nodes on page 69.)
Call node. (Refer to Call Nodes on page 72.)
Link. (Refer to Links on page 73.)
For a complete description of each node type, refer to
Creating & Using Nodes on
page 49.
12PT Program Generator (PPG) v5.0
Navigation
If your flow chart is larger than the PPG window, use the scroll bars and cursor
keys to scroll different areas into view. (refer to
mouse to expand the window size by clicking and dragging on the beveled
lower right corner of the PPG window.
Working with PPG Windows
To expand the PPG window to fill the screen, or the PPG Application to fill
the PPG window, select the
window.
To temporarily remove the PPG window from your screen without exiting the
application, select the
icon in the Windows taskbar. Click on the taskbar icon to bring the window
back exactly as you left it.
Figure 3. Scroll bars on a Flow Chart
Overview of PPG
Figure 3 on page 13). Or use your
Maximize button in the upper right corner of the
Minimize button. The window becomes an application
User’s Guide 13
Getting Started
For information on working in application windows, including using scroll bars and
selecting menu commands, refer to your Microsoft Windows documentation.
Generating the Program
Refer to PPG Application Design on page 15 for an overview of using PPG to create
a PDT application, starting with a flow chart of your data-collection process.
Creating & Using Nodes on page 49 provides details on each program node type.
Downloading the Program
Once you have created a PDT application using PPG, connect your portable
to a PC and use the
the portable unit.
it into code that is understood by the portable, and then sends the program via
the cable to your portable. After the application has been downloaded to the
portable, you are now ready to collect data with the portable.
Download Program command to load the program into
PPGComp compiles the program automatically, translating
Transferring Data
After you have input data or scanned a series of bar codes with the programmed portable data collection unit, you can use
lected data to a file on your PC. The data is uploaded via the serial cable to a
specified file on your computer. You can also transfer data, such as a pick list
for comparing input data, from the PC to the portable. For detailed instructions, refer to
Collected data is usually a series of numbers or alphanumeric strings stored in
a file until you transfer it into a data processing program. For example, a
scanned bar code that reads 107-028-0274, once filtered through a program set up to interpret it, is translated into more readable information, such
as DOCKERS T-LG, $25.60.
You can program the portable to translate scanned numbers into words, but
this is usually done with your data processing program. For example, you can
load the data into a spreadsheet program that performs calculations. Or use a
database program that tracks your inventory. Use PPG to format collected data
into human recognizable information.
PT40 Communication on page 89.
14PT Program Generator (PPG) v5.0
XFER32 to transfer the col-
PPG Application Design
Overview
Chapter 3
This chapter provides an overview of the process of designing and building an
application using PPG. The following topics are covered:
•Designing the Application on page 15.
•
Application Output on page 15.
Application Structure on page 16
•
•Node Types and the Parent-Child Relationship on page 17.
Creating Function Nodes on page 18
•
•Creating Operation Nodes on page 18
•Actual vs. Virtual Display on page 19.
Defining Program Flow on page 20.
•
•
Sending and Receiving Files on page 20.
•
Additional Resources on page 21.
Designing the Application
Application Output
Before you begin to design an application, you must decide how the resulting
data will be handled. You probably have a good idea of how you would like the
collected data to be output. The result of the application is usually a file of collected data, so you must determine the purpose of the file and how it is organized; this determines what data is collected and how. You may want to
examine portions of collected data or work with data files downloaded into the
PT40. After you have determined the data output format, you can begin to
define the program steps and flow.
User’s Guide 15
PPG Application Design
Application Structure
Next you must decide what you want the program to do. Draft a program flow
chart with pencil and paper, while keeping in mind the following ideas and
concepts.
Follow them as steps if you like:
1. List the major actions the user may take. These may include reading
data from the scanner, uploading data from the PDT, and storing data
in a file.
2. For each major action, define each step. In what order will the actions
be taken? Walk through each step as if you were the end user.
3. Do multiple actions contain the same step? If so, save time and program size by putting these steps into a subroutine that can be called
from different areas of the program.
4. Will each action be taken in a specific order or will the user be allowed
to choose an action? To offer a choice of actions, such as collecting
and uploading data, you can provide a menu that will allow the user
to select an action.
5. Visualize the individual steps involved in each major action.
•For example, will the user be collecting different types of data at
different times?
•For each action you would take as a portable user, imagine the
options you would expect to have and the messages you would
expect to appear on the screen.
6. In what order will the actions be taken?
•Is there an obvious direction to the program? For example, a user
would normally collect data and then upload it.
•This order should be reflected in the main menu and in the
program flow.
7. How will the user start? Do you want to identify the user first by asking for a password or ID number? What about a log-on message?
8. To make your design clearer, try breaking your design up into logical
sections. As a guideline, if a function contains more than ten steps,
you may want to break it down further. Keeping each frame small will
make your program easier to implement and maintain.
16PT Program Generator (PPG) v5.0
Node Types and the Parent-Child Relationship
•For example, an application with collect and store functions
would be broken up into a collection function and a storage
function.
•For example, a storage function may contain steps to verify the
data meets certain criteria, store the data in a file and track the
amount of data stored. This may, depending on the complexity of
each step, be broken up into functions which perform each step.
Node Types and the Parent-Child Relationship
Build your application in a modular fashion, taking advantage of the ParentChild relationship. There can be multiple levels in each program flow chart.
Any type of Operation node can exist at any level. The top level is the parent
and lower levels are children.
Table 1. Function and Operation Nodes
Function NodesOperation Nodes
Menu Nodes starting on page 5-55
Display Nodes starting on page 5-56
Input Nodes starting on page 5-57
Frames starting on page 5-50
Subroutines starting on page 5-51
Output Nodes starting on page 5-60
Verify Nodes starting on page 5-63
Copy Nodes starting on page 5-66
Modify Nodes starting on page 5-67
Math Nodes starting on page 5-69
Call Nodes starting on page 5-72
Applications constructed with PPG contain two general types of nodes, Func-
tion Nodes
Each
Connect
While it is possible to create an entire application at the main frame level, this is not
the best approach for any but the smallest applications.
Operation Nodes are described briefly in Creating Operation Nodes on page 18, and
more completely in
User’s Guide 17
, which include Frames and Subroutines, and Operation Nodes.
Frame in a program flow chart represents a major function or option.
Frames together in a logical way that indicates program flow.
Creating & Using Nodes on page 49.
PPG Application Design
Creating Function Nodes
Once you’ve designed the basic program structure, the next step in generating
a portable program is to define each
frames or subroutines and are used to organize the steps and work of
tion Nodes
Frames
Frames contain a set of program steps that are collected and ordered in a logi-
cal structure.
Nodes are Linked together within the frame using Links.
Subroutines
Subroutines contain nodes that execute program steps, much like Frames, but
they can be called from anywhere in the application. They should be self-contained and perform functions that are used in multiple places in the application. Use
Node
Using Your Flow Chart
. Most developers start by creating Function Nodes.
Frames can consist of other frames, subroutines, and nodes.
Call nodes to link Subroutines to the location within the Operation
or Frame where they will be called.
Function Node. Function Nodes are
Opera-
Using the flow chart you created in Application Structure on page 16, list the
Frames and Subroutines you will define. As a general guideline, if the func-
tion is used in multiple places, make it a
Frame. Once all Function Nodes are created, define each step by creating the
Operation Nodes.
Subroutine. Otherwise, it should be a
Creating Operation Nodes
Each Operation Node represents a program step or work performed by the
application. After you have created the frames and subroutines, fill in the program steps for each function node. Using the flow chart, create an appropriate
Operation Node for each step in the Frame or Subroutine. There are nine dif-
ferent types of
18PT Program Generator (PPG) v5.0
Operation Nodes to chose from, as shown in Table 1 on page 17.
Loading...
+ 174 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.