DataLoader/MX Reference Manual (G06.24+)

Running DataLoader/MX
DataLoader/MX Reference Manual—525872-002
3-3
Syntax of DataLoader/MX
must follow the parameter name immediately, separated by an equal sign (=). If
additional information is 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, except
for any OSS file names specified. If interpretations or modifiers are present,
then the value has to be enclosed within double quotes. “$” or “\” characters
have to be escaped by adding “\”.
-C=num-recs
specifies the number of records to process. DataLoader/MX terminates normally
when num-recs input records have been processed or when it reaches end of file.
If this parameter is not specified, all 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 is created as an OSS text
file when the first error occurs (the TEXT interpretation is implicitly added). If err-
file is a Guardian file name, it is created as an EDIT file when the first error
occurs. To determine if errors occurred, check for the existence of this file.
If the file already exists before running DataLoader/MX, error information is
appended to the file. A line indicating the date and time of the append is written
first.
If this parameter is not specified, the error information is written to the
DataLoader/MX process stderr.
-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/MX to call GETNEXTRECORD (a user exit) to fetch the data.
The record returned from GETNEXTRECORD is passed to DataLoader/MX 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). Therefore, when
you specify the -G parameter, DataLoader/MX does not fetch data directly from the
input file.
The -I and -G parameters interact as follows: