The onpload Utility Syntax

Home | Previous Page | Next Page The onpload Utility >

The onpload Utility Syntax

>>-onpload------------------------------------------------------>
 
>--+- -V-----------------------------------------------------+-><
   '-+- -j--jobname--+-------------+--+------------------+-+-'
     |               '- -d--source-'  '- -p--projectname-' |
     '- -m--map-- -d--source--+------------------+---------'
                              '- -p--projectname-'
 
Other Options:
 
|--| Setting Run Mode |--+-------------------------------------------+--+---------------------------------+--+-----+--|
                         '-| Modifying Parameter 

 Size |-'  '-| Overriding onpload Database |-'  '- -Z-'

For more information on the options shown in the diagram, see Setting the Run Mode with the -f Option, Modifying Parameter Size, and Overriding the onpload Database Values.

The table below contains an explanation of the elements in the diagram.

Element	Purpose	Key Considerations
-V	Displays the current version number and the software serial number.	Restrictions: This option is available only from the command line.
-d source	Sets the pathname of the file, tape, or pipe (UNIX only) or the name of the device array to use for the load or unload session	Additional Information: If the -f option is not set to a, d, or p, onpload assumes that the data source is a file. Additional Information: To use ipload, see Interpreting the -d and -f Options Together.
-j jobname	Names a load or unload job from the onpload database	Additional Information: To set using ipload, see Components of the Unload Job and Components of the Load Job.
-m map	Names a map from the onpload database	Additional Information: To use ipload, see Figure 85.
-p projectname	Identifies the project where the format and map are stored	Additional Information: To use ipload, see Project Organization.
-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	Restrictions: If 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. Additional Information: 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. Additional Information: This option is equivalent to checking the Write/read to/from tape until end of device checkbox 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 -p zz -j bigload -fl

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 -p zz -j bigload -fl -e 1000 -l /mylogs/buggytape.log

For information on the -fl option, see Setting the Run Mode with the -f Option.