Copyright: envi.con (C) 2000


Overview
Overview of PIA Creator v1.1

Pilot archiv (PIA) provides:

- the quick, complete and error free transfer of Palm Pilot applications

- simple and easy building of an install archive similar to the Installation method for Windows Desktops

- reduces the risk of unsuccessful user installation

- providing clear information to the user about a software package at the installation process

- no effort for programming an additional installer

- no costs for the user interface

- no limits for the amount of copies or versions

- one file distribution (also for colored and none colored devices)

- compressed file transfer to Palm devices provides the fastest installation even for large applications

Mainview

Taskbar

Filelist

View PIA

Optimize files for transfer

What is PIA ?

PSE-Format

Combiner

License

web site:

http://pinstall.envicon.com


Mainview
Mainview:

General:

Title: Installation name, that would displayed at installation start

author: email of creator (**)

Outfilename: Outputname of achiv

content files:

General: palm files always installed

Color: palm files only installed, if it is a color enabled device (**)

Non-Color: palm files only installed, if it is not a color enabled device (**)

minimum requirements:

OS-Version: Overall minimum OS-Version of the archiv

Color: Archiv needs color

Dragonball EZ-Cpu: Archiv needs Dragonball EZ Cpu (e.g. 4 Bit grayscale) to install

Pilot Archiv options:

unique ID: Set a unique ID (number) to the archiv (**)

version: Archiv version (**)

Filelist

View PIA

(** FEATURE only available in the professional version)


Palm files
Palm files:

PRC	Palm applications

PDB	Palm databases

PQA	Palm querys


PIA
What is PIA ?

The central object is the Pilot Install Archive (file extension .pia), which contents all necessary data,  files and information need for the installation. A software developer can create such a Pilot Install Archive using the PIA Creator. He just select the all files for his application and adds the information for it. PIA Creator will then create one pia-file, which can be distributed.

Pilot Install, the user application can handle the pia-file format and takes care, that everything will be transferred to the Palm devices. It finds out the available memory on the device and checks if the application can be installed. If there is not enough space left the user will be informed and can interact.


Taskbar
Taskbar:

new installation: Start a new installation (**)

open installation: Open an existing installation (**)

save installation: Save the current installation

cut: Cut current selection

copy: Copy the current selection

paste: Paste the current selection

create: PIA: Create PIA file from current settings. Only enabled, if contents files exist

test: PIA: Test created PIA file with Pilot Install

about: About this Program

(** FEATURE only available in the professional version)


About
About:

© Copyright 2000

http://pinstall.envicon.com

email: pinstall@envicon.de


Error
Error messages:

“Missing file x”

File x doen’t exist

“PIA doesn't allow the same name x in one archive (limitation)”

All filelists must have unique names for processing with PIA.

“Can't find Pilot Install. Run Pilot Install and close it, then try again”

Pilot Install isn’t found. Start “Pilot Install” from the Start-menu

PIA-Errors:

101	Out of memory

102	File open fails

103	General I/O error

104	This is not a valid PIA file

105	File creation error

106	CRC-failure

107	Integry error


Filelist

Add: Add file(s) to the filelist

Delete: Delete file(s) to the filelist


PIA archiv view;extract
PIA archiv view:

Size: Packed size

CRC: CRC for the unpacked file

Mode: 0=Uncompressed / 1=Compressed

Path: Shows the installation tree. Currently these trees are implemented: All/Color/NonC

Note: The “OPTIONS”-file could n’t extracted.


Optimize file
Optimize files for transfer:

We can optimize palm files for uploading on the device (**). This speeds up the installation progress, but need processing time on the device. This could be done with the Combiner.

 The selfextracting file at work

The SFX features:

-Palm OS 2.0 and abouve compatible

-Combines various files to one file

-Use only 5 KB of memory

Speedup table:

Example	complete number of records	transfer time (without)	transfer time (with)	processing time  on device (with)	complete (with)
Example app (health appl.)	500	24.3 sec.	2.6 sec.	5 sec.	7.6 sec
LinuxTag (Fair appl.)	201	14.2 sec.	3.5 sec.	8 sec.	11.5 sec.
Big (form generated appl.)	5200	704.6 sec.	38.8 sec.	n.a.	n.a.
Enviroment: Palm V, serial transfer at 115200

(**) FEATURE only available in the professional version


SFX
Creating Selfextracting files:

We can create a Selfextracting (SFX) file (**) that contains:

1) 	A valid PIA-achiv

2) 	Pilot Install for installation

This result a single executeable file (.EXE), that can distributed.

For an example see: sfx.exe (in example directory)

(**) FEATURE only available in the professional version


 PSE-Format

The PIA installation settings are written to PSE. This is a text format (INI format) that can easily created by other programs. Example:

[General]

Name0=D:\envicon\PIACreatorInstall\ColorNon\TestCardC.prc

[Option]

Title=Color Switch Example

Outfile=D:\envicon\PIACreatorInstall\ColorNon\ColorSwitch.PIA

Readme=D:\envicon\PIACreatorInstall\ColorNon\Readme

The following sections exists:

[General]	File(s) always installed, Filelist started with value “Name0”

[Color]	Color files

[NonColor]	Noncolor files

[Option]	general options, valid values are:

Title	e.g. PiaCreator

Outfile	filename

Readme	filename

License	filename

Author	max. 39 characters

OS	e.g. 2.0

GlobalColor	0,1

DragonballEZ	0,1

[PIA]	PIA specific options, valid values are:

Version	numeric value (32 bit)

UID	numeric value (32 bit)


 Combiner

This program combines various palm files to one and optimize it for the shortest transfer time for uploading. This is independed from creating PIAs.

The orginal transfer rate (TR)	shows the state before.

Optimized TR	shows the state after

Rate	shows the difference between orginal/optimized TR.

Creator	(4 characters)

Type	(4 characters)

Name	Databasename

Path	Desktop path

Transfer rate: Bytes to send to the palm devices from the desktop (seriall port/USB).

TIP: Files with a rate higher than 90% should not be optimized

TIP 2: You must add the outfile to PIA Creator (not the input files)

Command-line options for Combiner:

/OUT	name	Set outfilename

/LIST	name	Open name as filelist (text file containing only filenames)

/CREATE	Create directly (without displaying anything)

All other parameter treated as inputfilenames


License
PILOT INSTALL CREATOR LICENSE AGREEMENT

Redistribution Or Rental Is Not Permitted

The following terms apply to Pilot Install CRETOR the software.

This document is a part of it and may not be removed, if the software is offered for download, copied etc.

1. envi.con grants Licensee a non-exclusive and non-transferable license to reproduce and use for personal or internal business purposes the executable code version of the Product, provided any copy must contain all of the original proprietary notices.

This license does not entitle Licensee to receive from envi.con hard-copy documentation, technical support, telephone assistance, or enhancements or updates to the Product. Licensee may not customize the Product unless Licensee has also licensed commercial version of Pilot Install Creator.

Licensee may not redistribute the Product unless Licensee has separately entered into a distribution agreement with envi.con such as the Unlimited Distribution Program Agreement.

3. RESTRICTIONS.

Licensee may not:

(i) modify or create

any derivative works of the Product or documentation, including translation or localization;

(ii) decompile, disassemble, reverse engineer, or otherwise attempt to derive the source code for the Product (except to the extent applicable laws specifically prohibit such restriction);

(iii) redistribute, encumber, sell, rent, lease, sublicense, or otherwise transfer rights to the Product;

(iv) remove or alter any trademark, logo, copyright or other proprietary notices, legends, symbols or labels in the Product; or

(v) publish any results of benchmark tests run on the Product to a third party without envi.con prior written consent.

4. FEES.

There is no license fee for the Product. If Licensee wishes to receive the Product on media, there may be a small charge for the media and for shipping and handling. Licensee is responsible for any and all taxes.

5. TERMINATION.

Without prejudice to any other rights, envi.con may terminate this Agreement if Licensee breaches any of its terms and conditions. Upon termination, Licensee shall destroy all copies of the Product.

6. PROPRIETARY RIGHTS.

Title, ownership rights, and intellectual property rights in the Product shall remain in envi.con and/or its suppliers.

Licensee acknowledges such ownership and intellectual property rights and will not take any action to jeopardize, limit or interfere in any manner with envi.con or its suppliers' ownership of or rights with

respect to the Product.

The Product is protected by copyright and other intellectual property laws and by international treaties. Title and related rights in the content accessed through the Product is the property of the applicable

content owner and is protected by applicable law. The license granted under this Agreement gives Licensee no rights to such content.

7. DISCLAIMER OF WARRANTY. THE PRODUCT IS PROVIDED FREE OF CHARGE, AND, THEREFORE, ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION THE WARRANTIES THAT IT IS FREE OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PRODUCT IS BORNE BY LICENSEE. SHOULD THE PRODUCT PROVE DEFECTIVE IN ANY RESPECT, LICENSEE AND NOT LICENSOR OR ITS

SUPPLIERS OR RESELLERS ASSUMES THE ENTIRE COST OF ANY SERVICE AND REPAIR. IN ADDITION, THE SECURITY MECHANISMS IMPLEMENTED BY THE PRODUCT HAVE INHERENT LIMITATIONS, AND LICENSEE MUST DETERMINE THAT THE PRODUCT SUFFICIENTLY MEETS ITS REQUIREMENTS. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS AGREEMENT. NO USE OF THE PRODUCT IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER.

8. LIMITATION OF LIABILITY. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT WILL LICENSOR OR ITS SUPPLIERS OR RESELLERS BE LIABLE FOR ANY INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF OR INABILITY TO USE THE PRODUCT, INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY

AND ALL OTHER COMMERCIAL DAMAGES OR LOSSES, EVEN IF ADVISED OF THE POSSIBILITY THEREOF, AND REGARDLESS OF THE LEGAL OR EQUITABLE THEORY (CONTRACT, TORT OR OTHERWISE) UPON WHICH THE CLAIM IS BASED.

IN ANY CASE, LICENSOR'S ENTIRE LIABILITY UNDER ANY PROVISION OF THIS AGREEMENT SHALL NOT EXCEED IN THE AGGREGATE THE SUM OF THE FEES LICENSEE PAID FOR THIS LICENSE (IF ANY) AND FEES FOR SUPPORT OF THE PRODUCT RECEIVED BY ENVI.CON UNDER A SEPARATE SUPPORT AGREEMENT (IF ANY), WITH THE EXCEPTION OF DEATH OR PERSONAL INJURY CAUSED BY THE NEGLIGENCE OF LICENSOR TO THE EXTENT APPLICABLE LAW PROHIBITS THE LIMITATION OF DAMAGES IN SUCH CASES. SOME

JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THIS EXCLUSION AND LIMITATION MAY NOT BE APPLICABLE. NETSCAPE IS NOT RESPONSIBLE FOR ANY LIABILITY ARISING OUT OF CONTENT PROVIDED BY LICENSEE OR A THIRD PARTY THAT IS ACCESSED THROUGH THE PRODUCT AND/OR ANY MATERIAL LINKED THROUGH SUCH CONTENT.