Dataloader/MP Reference Manual

Running DataLoader/MP
DataLoader/MP Reference Manual—424148-003
3-3
Syntax of DataLoader/MP
•
Each parameter begins with a dash (-) and is immediately followed by the
name of the parameter. If the parameter has a value, the value must follow the
parameter name immediately, separated by an equal sign (=). If there is
additional information associated with the value, it must follow the value and be
enclosed in angle brackets (<>). The parameter and its value cannot have
embedded spaces. The parameter and its value are not case-sensitive.
-C=num-recs
specifies the number of records to process. DataLoader/MP terminates normally
when num-recs input records have been processed, or when it reaches end of file.
If this parameter is not specified, all of the records in the input stream are
processed.
-E=err-file
specifies the name of the file or DEFINE to which errors—and the input records for
which they occur—are written. If the file does not exist, it will be created as an edit
file when the first error occurs. A simple way to determine if errors occurred is to
check for the existence of this file.
If the file already exists before running DataLoader/MP, any error information will
be appended to the file. A line indicating the date and time of the append will be
written first.
If this parameter is not specified, the error information will be written to
DataLoader/MP’s home terminal.
-F=first-rec
specifies the first record to process. To maintain compatibility with the File Utility
Program (FUP), the first record is record number 0. This parameter can also be
thought of as the number of records to skip.
If this parameter is not specified, processing begins with the first record (which is
the same as -F=0).
-G
causes DataLoader/MP to call GETNEXTRECORD (a user exit) to fetch the data.
The record returned from GETNEXTRECORD is passed to DataLoader/MP to be
processed; it might be passed to a user exit, included in partition determination (if
-P was specified), or written to the output file (if -O was specified). Thus, when you
specify the -G parameter, DataLoader/MP does not fetch data directly from the
input file.
The -I and -G parameters interact as follows:
•
If -G is specified and -I= is not specified, DataLoader/MP does not open an
input file. When it needs a record to process, it calls the GETNEXTRECORD
exit.