The onpload utility syntax
Other Options
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 zzIf 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.logFor information about the -fl option, see Set the onpload run mode with the -f option.