Allows you to list or remove backed up Oracle Rdb databases from
a Librarian utility.
1 – Description
The RMU Librarian command allows you to list or remove backed up
Oracle Rdb databases from a Librarian utility that conforms to
the Oracle Media Manager interface.
You cannot perform both the list and remove operations within one
command.
2 – Format
(B)0[mRMU/Librarian backup-file-spec
[4mCommand[m [4mQualifiers[m x [4mDefaults[m
x
/List[=(Output=file-name),(options,...)] x See Description
/Remove[=[No]Confirm,(options,...)] x See Description
3 – Parameters
3.1 – backup-file-spec
Identifies the backed up Oracle Rdb database previously stored
in the Librarian utility. Use the same backup file name that
was used in the Oracle RMU Backup command. A default file type
of .RBF is assumed if none is specified. Any device, directory,
or version number specified with the backup file name will be
ignored.
If the Librarian utility supports wild card characters, you
can use them for the backup file name when you use the List
qualifier. Wild card characters cannot be used with the Remove
qualifier.
4 – Command Qualifiers
4.1 – List
List
List=Output=file-name
List=options
Allows you to display a backed up Oracle Rdb database stored
in a Librarian utility. If you use the List qualifier without
the Output option, the output is sent to the default output
device. If you use the Output option, the output is sent to the
specified file. All data streams existing in the Librarian that
were generated for the specified backup name will be listed. The
information listed for each data stream can include:
o The backup stream name based on the backup file.
o Any comment associated with the backup stream name.
o The creation method associated with the backup stream name.
This will always be STREAM.
o The creation data and time when the stream was backed up to
the Librarian.
o Any expiration date and time specified for deletion of the
stream by the Librarian.
o The media sharing mode that indicates if the media can be
accessed concurrently or not.
o The file ordering mode that indicates if files on the media
can be accessed in random order or sequential order.
o Any volume labels for the media that contain the backup
stream.
Not all of these items will be listed depending on the particular
Librarian utility.
The List qualifier can accept the following options:
o Trace_File=file-specification
The Librarian application writes trace data to the specified
file.
o Level_Trace=n
Use this option as a debugging tool to specify the level of
trace data written by the Librarian application. You can use a
pre-determined value of 0, 1, or 2, or a higher value defined
by the Librarian application. The pre-determined values are:
- Level 0 traces all error conditions. This is the default.
- Level 1 traces the entry and exit from each Librarian
function.
- Level 2 traces the entry and exit from each Librarian
function, the value of all function parameters, and the
first 32 bytes of each read/write buffer, in hexadecimal.
o Logical_Names=(logical-name=equivalence-value,...)
Use this option to specify a list of process logical names
that the Librarian application can use to specify catalogs
or archives for listing or removing backup files, Librarian
debug logical names, and so on. See the specific Librarian
documentation for the definition of the logical names. The
list of process logical names is defined by Oracle RMU prior
to the start of the list or remove operation.
4.2 – Remove
Remove
Remove=Confirm
Remove=Noconfirm
Remove=options
Allows you to delete all data streams existing in the Librarian
that were generated for the specified backup file. This command
should be used with caution. You should be sure that a more
recent backup for the database exists in the Librarian under
another name before you use this command. The Confirm option is
the default. It prompts you to confirm that you want to delete
the backup from the Librarian. If you do not want to be prompted,
use the Noconfirm option. The deletion will be performed with no
confirmation prompt.
The Remove qualifier can accept the following options:
o Trace_File=file-specification
The Librarian application writes trace data to the specified
file.
o Level_Trace=n
Use this option as a debugging tool to specify the level of
trace data written by the Librarian application. You can use a
pre-determined value of 0, 1, or 2, or a higher value defined
by the Librarian application. The pre-determined values are:
- Level 0, trace all error conditions, is the default.
- Level 1 traces the entry and exit from each Librarian
function.
- Level 2 traces the entry and exit from each Librarian
function, the value of all function parameters, and the
first 32 bytes of each read/write buffer, in hexadecimal.
o Logical_Names=(logical-name=equivalence-value,...)
You can use this option to specify a list of process logical
names that the Librarian application can use to specify
catalogs or archives for listing or removing backup files,
Librarian debug logical names, and so on. See the specific
Librarian documentation for the definition of logical names.
The list of process logical names is defined by Oracle RMU
prior to the start of the list or remove operation.