Intermec 6100 Reference Guide

Page of 328
SECTION 5
Communications and Device Support
5-6    PEN*KEY
R
 6100 Computer Programmer’s Reference Guide
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 Intermec
Technologies Corporation.  See the PL/N Reference Manuals for more information.
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.
W
N/A
Specific to the PL/N programming language from Intermec Technologies
Corporation.  For further information, see the PL/N Reference Manuals.  This type
is equivalent to an unsigned integer in field size, but is packed in the opposite byte
order.
X
char[ ]
Specifies a character buffer that does not have a NULL terminator.
(
N/A
Marks the beginning of a repeated field descripter sequence.  The field length is
the number of repetitions of the sequence.  For example, the sequence:
B002X004B002X004  can be written as:  (002B002X004)000
(002" marks the beginning of a pattern repeating twice.  )000" marks its end.
)
N/A
Marks the end of a repeated sequence begun with a (nnn" descripter.  Field
length is the number of repetitions of the sequence.  For example, the sequence:
B002X004B002X004  can be written as:  (002B002X004)000
(002" marks the beginning of a pattern repeating twice.  )000" marks its end.
In the NORAND Host Communication packages, a record length of one indicates
that the file contains variable length records, where the first character of each
record identifies the type of record.  These single character record types are used
by the formatting utilities of the communications packages to format the file into
logical records.
PL/N File Descriptor for Binary Files
For the support of full DOS file names and for better support of nonĆPL/N binary
files, an expanded header structure is defined:
<DDOSFIL00001Xmmm>F[––dosfilename––] S[filesize]data. . .
                < = beginning of file header
                D = file type (fixed)
           DOSFIL = file name (fixed)
            00001 = fixed
                X = data type (fixed)
              mmm = decimal number of bytes of file information between end 
                    of file header and start of file
                > = end of file header
                F = F indicates the file name parameter
[––dosfilename––] = complete DOS file name (may be of any length)
         <space> = a space must separate the parameters
               S = S indicates the file size parameter
      [filesize] = the exact number of bytes in binary file (this parameter 
                    may be up to 8 digits long)
       data. . .
 
= the binary file starts immediately after filesize parameter
           . . .
 
= additional hand-held computer information
5. Communications
and Device Support