The onpload utility syntax


1  onpload
1 -V
1 
2.1   -j jobname?  -d source?  -p projectname
2.1   -m map  -d source?  -p projectname %Other Options
Other Options

1  %Setting the run mode %Modifying
parameter size  %Overriding database values?  -Z

For more information about the options shown in the diagram, see Set the onpload run mode with the -f option, Modify the size of onpload database parameters, and Override the onpload database values.

The following table contains an explanation of the elements in the diagram.
Element Purpose Key considerations
-V Displays the current version number and the software serial number. This option is available only from the command line.
-d source Sets the path name of the file, tape, or pipe (UNIX only) or the name of the device array to use for the load or unload session If the -f option is not set to a, d, or p, onpload assumes that the data source is a file.

To use ipload, see Interpret the onpload -d and -f options together.

-j jobname Names a load or unload job from the onpload database When using the -j option, you can override only a few values from the onpload database. See Override the onpload database values

To set by using ipload, see Components of the unload job and Components of the load job.

-m map Names a map from the onpload database To use ipload, see Using a map.
-p projectname Identifies the project where the format and map are stored To use ipload, see Project organizationIf you use this feature, you must use it for both the load and unload commands. Otherwise, the unloaded data might not match the loaded data.
-Z Enables writing to or reading from a tape until the end of the device. The onpload utility prompts you for additional tapes until the load or unload is completed If the -Z option is not set, the onpload uses the tape size provided on the command line. If the -Z option is set, it supersedes the tape size information provided.

This option is equivalent to checking the Write/read to/from tape until end of device check box on the Load Job Select or Unload-Job Select windows.

The pload command line assumes the default project unless otherwise specified with the -p option.

For example, you might use the Load Job window to prepare the following command:
onpload -j bigload -p zz
If you receive a tape that you know contains data with bugs, you might choose to modify the command to allow errors and to save the log in a special place, as follows:
onpload -j bigload -p zz -fl -e 1000 -l /mylogs/buggytape.log

For information about the -fl option, see Set the onpload run mode with the -f option.