SECTION 5
Communications and Device Support
5-6 PEN*KEY
R
6200/6300 Hand-Held Computer Programmer’s Reference Guide
The format of the download request file is as follows:
<DDWNLRQnnnnnX016>[––filename1–––][––filename2–––] . . .
where:
< = Beginning of file header
D = File type (fixed)
DWNLRQ = File name (fixed)
nnnnn = Decimal number of records in file
X = Data type (X for character)
016 = Decimal number of bytes in record (fixed)
> = End of file header
[––filename?–––] = Name of file to download, must be
left-justified and blank-padded to
16 characters
You can include as many filename records as are specified in the number of
records field of the header. This permits requests for more than one file to be
batched together.
Upload and Download Files
The general format of a file header is as follows:
<tffffffmmmmmtnnntnnntnnn . . . >
where:
< = Beginning of file header
t = File type
‘D’ for unpacked data
‘E’ for unpacked executable
‘P’ for packed data
‘B’ for packed executable
ffffff = File name
mmmmm = Decimal number of records in file, right-justified
and zero-padded
t = Field data type (described below)
nnn = Unpacked length of field, right-justified and
zero-padded
> = End of file header
. . . = Additional HHC information
The actual file name created on the handheld has .DAT" or P.PL6" appended to
the ffffff file name. File types `D' and `P' have .DAT" extensions. File types `E'
and `B' have P.PL6" appended to the name. Valid field data types are:
Type C data type
Comments
B
unsigned char Field length in the file header can be 001 to 003. Valid field values are 0ć255.
D
signed long
Field length in the file header can be 001 to 011. Valid field values are
ć2147483647 to 2147483647. `+' is not uploaded for positive values. Leading
zeroes are uploaded if necessary to meet the specified field length.
I
signed int
Field length in the file header can be 001 to 006. Valid field values are ć32767 to
32767. `+' is not uploaded for positive values. Leading zeroes are uploaded if
necessary to meet the specified field length.
N
N/A
Field type is specific to the PL/N programming language from Norand Mobile
Systems Division. For further information, see the PL/N Reference Manuals.
Schar[ ]
Specifies a NULL terminated string. Field length does not include the NULL, as
the NULL is not included in the unpacked file. The NULL is inserted when the
field is written to the HHC file.
5. Communications
and Device Support
