SECTION 5
Communications and Device Support
PEN*KEY
R
6200/6300 Hand-Held Computer Programmer’s Reference Guide 5-11
Upload Control File Parameters
Information about transferred files must be contained in a file named
NRUPLD.CTL. Valid parameters for this file are described in the following
paragraphs.
FILE=
This is the name of an upload file. Files are uploaded according to the preceding
header or target information. Multiple FILE parameters may follow a single
HEADER or TARGET parameter, if the header or target applies to all the
specified files.
Example:
FILE=BYPRD.DAT
FORMAT=
This parameter defines the format of variableĆlength records whose record types
match the preceding RECTYPE parameter. The format of a record consists of
the data type and length of each field within the record, as follows:
FORMAT=tnnntnnn . . .
t Data type
nnn Field length, rightĆjustified and zeroĆpadded
Although the NORAND file transfer protocol supports a number of data types,
many of these are specific to the PL/N language from Intermec Technologies
Corporation. Specify a data type of X (for character) and the record length,
which does not include the record type character. More information on PL/N file
formats is in the document
Writing TCOM Modules in PL/N for the HHC
or see
the host TCOM manual.
Example:
FORMAT=X020
FORMAT=N012X016N004
HEADER=
This file header record precedes the files subsequently specified in FILE
parameters and provides the host information on data formatting.
If the header parameter is omitted or blank, the files subsequently specified are
transferred
as is
; that is, no header precedes the file. Any header information is
assumed to be embedded in the file itself.
When you specify the binary file descripter (DOSFIL), you do not need to
completely specify the header. If the size is not specified or is zero, the entire file
is uploaded, and the actual size is inserted into the header that is uploaded to
the host. If the filename is not specified, the file name specified in the FILE
parameter is inserted into the header that is uploaded to the host.
Example:
HEADER=<DBYPRD 00000X040>
RECTYPE=
RECTYPE and FORMAT parameters upload files that contain variableĆlength
records, in which the first character of each record identifies the type of record.
RECTYPE and FORMAT parameters remain in effect only until the next
HEADER parameter is encountered.
RECTYPE is a single, printable ASCII character; it indicates the record type to
which the following FORMAT applies.
Example:
RECTYPE=A
5. Communications
and Device Support
