PalmReg

v.1.2.1

©2005 Edward Hoad

Overview

PalmReg is a PalmOS™ shareware application to assist PDA Toolbox developers in generating, recording and emailing registration codes for their applications. The program records the following data: Customer Name, Email, HotSyncID, Reg. Code, and Device Type. Although PalmReg itself does not generate reg. codes, all tasks are completed without exiting the program. Three registration models are supported: ShellReg, DeskReg, and Dyn16reg.

Email messages for each application and purchase site can be generated and sent directly from the developer’s PalmOS™ device.

PalmReg also acts as a reference database for applications you have written.

Program Requirements

· You must be a registered user of the Private Eye Library

· You must have PDAT/Adv installed on your handheld or emulator

· RsrcEdit or other PalmOS™ resource editor

How PalmReg Works

The “Get Code” button in PalmReg calls a unique app for each developer application requiring a reg. code. The called app utilizes the PESDKlib to generate the registration code and copies it back to PalmReg. It is the developer’s responsibility to write a code generating app for each application, using PDAT/Adv. These are small apps with 1 action containing 2 lines of script. (A sample app is included.)

Installation

All files are bundled in a NutShell installer, excluding RsrcEdit and PDAT/Adv.

After installing the program, you must "plug" the PESDKlib into PDAT/Adv.  Once plugged in and registered, you will be able to use this library..

1. At PDAT/Advanced's Open Screen, tap the menu and choose from the Advanced menu "Manage Libraries".
2. Next, if the "Private Eye SDK Library" is not shown in the list, tap the "Add" button.
3. In the "Add Library" dialog, enter in the Library ID of "peye" (without the quotes).
4. Next, enter the license information you received when you registered the Private Eye Library.
5. Lastly, tap the "Done" button.

Creating the Code Generating App

When you open PDAT/Adv you will see PRmy-app. Tap “Open” and select “Actions” from the popup. Open Actn100 (the only action). This is an example of the deskreg registration model. Tap “Libs”/Private Eye SDK Library to see the other registration models.

Create Your App – this must be done for each app to be registered

1. Run RsrcEdit and scroll to find PRmy-app and PRmy-app_PFA.
2. Change PRmy-app to PRyourappname, change the CRID to your choice, and tap “Apply”.
3. Change PRmy-app_PFA to PRyourappname _PFA, change the CRID to match the above, and tap “Apply”.
4. Exit RsrcEdit, run PDAT/Adv, find and open PRyourappname.
5. Select “Actions” from the popup and open Actn100 (Alternatively, tap the menubar and select “Startup Script”).
6. Replace the existing $PES action with the appropriate model for your application.
7. Tap “OK” and “Compile”. Your reg code generating app is complete.
8. You must name your code generating app precisely the same as the app it registers, and add “PR” (minus quotes) as a prefix. This is the filename PalmReg will look for when “Get Code” is tapped.
9. When editing the script in your code generating app, you must replace both nameID and codeID with “clip” (minus quotes).

Using PalmReg

PalmReg was originally “Reggie” and was available for download at www.pdatnutsandbolts.com. Users of Reggie can update their data in PalmReg by tapping the menubar/Update data…

Three steps are necessary before using the program:

1. Enter your app names, either via the menubar on the main form or by tapping the App popup and Edit Categories. PalmReg v.1.2.1 provides room to record general information about your apps – CreatorID, Min. OS requirement, update info, etc. Your applications are filtered based on whether or not an app is checked “Released”. Unreleased apps and those designated as “Installers” or “Other” are not displayed in popups in PalmReg. The Store popup is pre-populated with a list of resellers.
2. Create email messages: Each app requires an email message for each reseller site. View/edit/create messages via the menubar/Email messages. A “Duplicate” button is available to speed up the process. Unique email messages mean you can include site specific links, encouraging customers to post product reviews. This makes it extremely easy for your customers to offer positive feedback, and in turn makes your app more attractive to potential buyers. On the Compose Emails form there are 3 buttons: app, regname, and regcode. Tapping these buttons appends, -NOT- inserts, @app@, @regname@, and @regcode@ in your message. As with DeskReg, these are replaced with the app name, hotsyncID and reg. code when an email is generated.
3. Write reg code generator apps. (explained above)

Main Form (Table)

The “find” field filters (partial match) 3 ways: Customer first name, last name, and reg. code. To clear the find filter, clear the field and tap “Find” again.

Code “Generating” Form

• Add to email button copies the “@xxxxx.xxx” portion of the customer’s email address and copies it to a db of email extensions.
• Email button activates a popup of the above extensions and pastes the selected record in the customer’s email field.
• Email Suffix buttons (11) append data to the customer’s email field.
• A button is provided to copy the customer’s name to the HotSyncID field.
• Preview and Send buttons – for the email message.

Note: Both the main form and code generating form filter the store popup based on your app selection, to display only stores with a dedicated email message.

Exporting Data

Data is exported based on the filter criteria set to view the table. Data can be exported in doc format or to memo as a csv. Fields are similar to data in DeskReg, so you can paste accordingly. “Device type” is used in place of the first custom DeskReg field.

Purchasing Information

This is a Shareware program.  This means that you can, and should, try the demo before buying.  Shortly after you register via PayPal you will receive an unlock key that will enable unlimited use of PalmReg.

The cost of this package is US$8.00. To purchase, enter your username in the space below, and click the PayPal “Buy Now” button.

Enter Username Here

For support questions or general comments/suggestions, email hoads@cogeco.ca or post on the forum at www.pdatnutsandbolts.com.

Warranty and User License Agreement

"The Software" is "PalmReg" by Edward Hoad.

DISCLAIMER #1 - MUST READ

This product is subject to obsolescence by changes in PDA Toolbox or the Palm OS(tm) itself.  This cannot be prevented.  I may choose to stop or limit development and support of this product if such situation occurs. 

USER LICENSE AGREEMENT

This Agreement sets forth your licensed rights to use "The Software" and is granted to you upon condition that you accept the terms of this license. Your electronic indication of agreement, or your use of the program constitute acceptance of all of the terms of this license.

The program copy and documentation are furnished to make "The Software" available for your use and remain the property of Edward Hoad.
IF YOU DO NOT AGREE WITH ANY PART OF THIS LICENSE, DO NOT USE THIS SOFTWARE. Delete "The Software" and all associated files from all media on which it has been copied. 

LICENSE TERMS AND CONDITIONS

THE LICENSED PRODUCT
The Licensed Product in its entirety is protected by US, Canadian and foreign copyright.  YOU MAY NOT DISTRIBUTE THE LICENSE CODE provided to you.

YOUR USE OF THE LICENSED PRODUCT
General Use. You have the right to install the "The Software" and any associated files on one (1) PalmOS™ device. Use of "The Software" on a network or any other arrangement by which its functions are accessible to more than one user at a time is not permitted. 

LIMITATIONS ON USE
General Use Limitations. You have no right to reproduce, transfer, publish or otherwise distribute either the "The Software" software, or any components or documentation provided.

ALL RIGHTS NOT SPECIFICALLY GRANTED BY THIS LICENSE ARE RESERVED BY EDWARD HOAD. 

WARRANTIES, WARNING, DISCLAIMER

Warning and Disclaimer of All Warranties. THE PROGRAM IS FURNISHED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, IN ALL JURISDICTIONS WHERE ALL WARRANTIES MAY BE DISCLAIMED IN THE LICENSING OF INTELLECTUAL PROPERTY.

---

PalmReg is Copyrighed by Edward Hoad

PDAT/Advanced is Copyrighed by Richard R. Sands dba Sands USA

Private Eye Library is Copyrighed by Richard R. Sands dba Sands USA

Private Eye SDK Library is Copyrighed by Richard R. Sands dba Sands USA

PDAT Toolbox is Copyrighted by Paul Prejean

Nutshell executable and documentation are Copyright ©2002-2004 by Ecamm Network. All rights reserved.

RsrcEdit is apparently not copyrighted by Quartus, but they are the caretakers of RsrcEdit.

Database Extreme Documentation Copyright (C) 2002-2004 Richard R. Sands dba Sands USA
All Rights Reserved

And Finally, ...

palmOne, Zire, Tungsten, Treo, Blazer, VersaMail, Addit, Handspring, stylizations and design marks associated with all the preceding, and trade dressassociated with palmOne, Inc.’s products, are among the trademarks or registered trademarks owned by or exclusively licensed to palmOne, Inc. All other brand and product names are or may be trademarks of, and are used to identify products or services of, their respective owners.