medium_labeloffline 

Use

You display information you require to identify a backup that you want to use, for example, to restore the database instance.

You can specify from which backup information is to be displayed either by the name of the backup template or by entering the data carrier.

If you wish to use this command to specify the name of the backup template, a connection to the relevant database instance must exist (logged on with –d). The operational state of the database instance is irrelevant.

If you specify the data carrier, you can display the label of each backup, regardless of whether a connection to the database instance is available.

See also:

Glossary, Backup IDs

Prerequisites

You have the server authorization Backup.

Syntax

medium_labeloffline <name> | <location_spec>

<name> :: = <medium_name> [<nnn>]

<location_spec> :: = <device | file> <media_spec>

<media_spec> :: = <type_spec> [<blocksize_spec>] | <blocksize_spec>

<type_spec> :: = [DEVICETYPE] <device_type>

<device_type> : = FILE | TAPE | PIPE

<blocksize_spec> :: =  BLOCKSIZE <block_size>

 

Options

Option	Description
<medium_name>	Name of the backup template
<nnn>	Only for log backups and only for backup templates of the FILE type: version number of the log backup on the data carrier
<device | file>	Data carrier
<block_size>	Number of pages transferred when the data carrier is accessed. Specify the block size used to create the backup. If you do not enter any information, the system default (8) will be used.
<device_type>	Type of database carrier. Possible values are: FILE | TAPE | PIPE FILE: File TAPE: Tape PIPE: Pipe The system default is FILE.

 

 

Reply

OK

Returncode              <value>

Date                    [<value>]

Time                    [<value>]

Server                  [<value>]

Database                [<value>]

Kernel Version          [<value>]

Pages Transferred       [<value>]

Pages Left              [<value>]

Volume Count            [<value>]

Medianame               [<value>]

Location                [<value>]

Errortext               [<value>]

Label                   [<value>]

Is Consistent           [<value>]

First LOG Page          [<value>]

Last LOG Page           [<value>]

DB Stamp 1 Date         [<value>]

DB Stamp 1 Time         [<value>]

DB Stamp 2 Date         [<value>]

DB Stamp 2 Time         [<value>]

Page Count              [<value>]

Devices Used            [<value>]

Database ID             [<value>]

Max Used Data Page      [<value>]

Values for the Reply Fields

Field	Description
Returncode	Return code of the Database Manager If the value is 0, the DBM command has been executed successfully. For any other value see: Messages
Date	Date
Time	Time
Server	Name of the database computer
Database	Name of the database instance
Kernel Version	Version of the database software
Pages Transferred	Number of pages transferred
Pages Left	Number of pages still to be transferred
Volumes	Number of backup templates used
Medianame	Name of the backup template
Location	File or device name
Errortext	Error message text
Label	Backup ID
Is Consistent	For data backup only: backup is internally consistent
First LOG Page	For data backup: first page of log backup to be imported For log backup: first page saved in log
Last LOG Page	For log backup only: last page saved in log
DB Stamp 1 Date DB Stamp 1 Time	Time stamp for first page of log backup
DB Stamp 2 Date DB Stamp 2 Time	Time stamp for last page of log backup
Page Count	Total number of pages backed up
Devices Used	Number of backup devices used
Database ID	Database ID used to identify data and log backups that belong together
Max Used Data Page	Highest page number assigned (indication of minimum database size when backup is imported)

 

In the event of errors, see Reply Format.