Entering content frame

Procedure documentation medium_label Locate the document in the library structure

Use

You display the information stored on a data carrier about the backup.

See also:

Glossary, Structure linkBackup IDs

Prerequisites

      You have the server authorization Backup.

      You have opened a database session (see db_connect).

      The database instance is in the ONLINE or ADMIN operational state.

Syntax

medium_label <medium_name>

<medium_name>

Name of backup template from which information is to be read
In the case of backup templates for a group of parallel data carriers, you need to specify the name of the group.

Reply

OK

Returncode              <value>

Date                    [<value>]

Time                    [<value>]

Server                  [<value>]

Database                [<value>]

Kernel Version          [<value>]

Pages Transferred       [<value>]

Pages Left              [<value>]

Volumes                 [<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>]

Note You should in particular analyze the Returncode reply field, which contains a numeric value supplied by the kernel.

See also: Structure linkMessages

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: Structure linkMessages

Date

Date

Time

Time

Server

Name of the database computer

Database

Name of the database instance

Kernel Version

Version of the database kernel

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.

 

Leaving content frame