Skip Headers
Oracle® Secure Backup Reference
Release 10.1

Part Number B14236-03
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

obtar -z

Purpose

Use obtar -z to display the volume label of a backup image. You can also use the -z option with obtar -t and obtar -g to display a volume label, or with obtar -c to create a volume label.

Syntax

obtar -z::=

obtar -z [ -f device ] [ -F file-number ]

Semantics

You can specify a number of options with obtar -z; this section describes those options that you are most likely to use. Refer to "obtar Options" to learn about additional obtar -z options.

-f device

Specifies the name of a backup image file or device. If you omit the -f option, then obtar reads from the device specified by the TAPE environment variable, if it is defined.

-F file-number

Specifies the backup image file number. If you omit the backup image number, then obtar reads the backup image at the volume's current position.

Examples

Example 4-29 causes obtar to display the volume label for the fourth backup image on a volume loaded on device tape1.

Example 4-29 Displaying the Volume Label

# obtar -z -f tape1 -F 4

Volume label:
   Volume ID:          VOL000105
   Volume sequence:    1
   Volume set owner:   jane
   Volume set created: Tue Mar 2 10:13:14 2002
Backup image label:
   File number:        4
   File section:       1
   Owner:              jane
   Client host:        chicago
   Backup level:       0
   S/w compression:    no
   Archive created:    Tue Mar 2 10:13:14 2002

When you use obtar -z, obtar reads the backup image. Whenever obtar reads a backup image, it positions the volume after the backup image just read, and before the label of the next backup image. For example, if you entered another obtar -z command after the one shown in Example 4-29, then obtar would display the label of backup image 5, if it exists, as shown in Example 4-30.

Example 4-30 Displaying the Volume Label

# obtar -zf tape0

Volume label:
   Volume ID:          VOL000003
   Volume sequence:    1
   Volume set owner:   gms
   Volume set created: Wed May 01 14:08:23 2000
Backup image label:
   File number:        5
   File section:       1
   Owner:              gms
   Client host:        campy
   Backup level:       0
   S/w compression:    no
   Archive created:    Wed May 01 14:08:23 2000