DataLoader/MX Reference Manual (G06.24+)

Running DataLoader/MX
DataLoader/MX Reference Manual—525872-002
3-9
Considerations—DataLoader/MX Process
records (as recorded in the restart file) are skipped. The restart file is an
Enscribe file and therefore has a Guardian name rather than an OSS name.
PURGE
directs DataLoader/MX to purge the file containing restart information on
normal termination. After abnormal termination, the file still exists.
KEEP
directs DataLoader/MX to never purge the file. You must purge it after
determining that the load application was successful.
KEEP is the default.
If the output requires a transaction ID and -T= was not specified, DataLoader/MX
terminates with an error.
-X=exitlist
specifies optional user exits to call and in what order to call them. For more
information, see User Exits on page 5-1.
Considerations—DataLoader/MX Process
In addition to the preceding DataLoader/MX parameters, user exits can have optional
or required parameters. By convention, all DataLoader/MX parameters defined by HP
begin with a dash, and parameters for user-defined exits do not begin with a dash. For
a brief list of all parameters supplied by HP, run DataLoader/MX with the -H parameter.
Enclose an argument having parenthesies or angle brackets within double quotes. Use
parentheses only to enclose modifiers after file names. Any other qualifying information
is enclosed in anglular brackets, even within file modifiers, as follows:
$ dataload -t="100<restartfile=\$vol.subvol.filename>"
$ dataload -i="file1(recform=fb<recsize=100>)"
The restart file name is enclosed in angle brackets because “restartfile=filename” is not
a file modifier. The entire recform=fb<recsize=100> clause is enclosed in parentheses
because it is a file modifier. <recsize=100> is enclosed in angle brackets because it is
qualifying information specifying the length of fixed length records.
When specifying a number, if it is used in the % file modifier, it can have a decimal
point. A number used in parameters cannot have a decimal point.
Note. In this manual, the examples for running DataLoader/MX from the OSS command
prompt use “\” as the line continuation character. All instances of “$” and “\” characters are
escaped by adding a “\” to avoid shell interpretation. Arguments having other special
characters (such as parentheses and angular brackets) are enclosed within double quotes to
avoid shell interpretation. An “&” is added at the end of the command to denote that the
command should run in the background. For more information about OSS, see the Open
System Services User’s Guide.