Defining or Changing Backup Media 

Use

You create a new backup medium or change the data for a backup medium that already exists. To do this, you must make the following specifications:

<name>

The medium specified in <name> is created or updated. The name of the medium may comprise a group name and a member name. These are separated by an oblique.

<name> ::= [<group_name>/]<member_name>

This type of group is used with parallel backup or restore operations.

If you want to perform a backup or a restore using an external backup tool such as ADSM/TSM, NetWorker, Backint for Oracle, or Backint for SAP DB, ensure the name of the medium starts with ADSM, NSR, BACK, or BACK. In this case, you can only enter PIPE under <type> (Backing Up with External Backup Tools).

<location>

The name of the device/file with which it can be addressed through operating system functions.

<type>

Type of medium; possible values are:
TAPE
FILE
NO-REWIND
PIPE
AUTOLOADER
UNKNOWN

<backup_type>

The type of backup for which the medium is to be used:
DATA (complete data backup), PAGES (incremental data backup), or LOG (log backup)

<size>

Maximum number of pages which can be written to the medium. This is necessary to change the tape correctly, for example. If the backup media is of sufficient size, a zero can be specified.

<block_size>

Number of pages which are transferred when accessing the medium (default: 8).

<overwrite>

This option is only relevant for the medium type FILE and describes the behavior if the file is already present. Permitted values are:
NO
YES

<autoldr>

Specifies whether the device changes the medium automatically:
YES
NO

<oscmd>

Operating system command to be executed before backing up to a succeeding medium or restoring a succeeding medium.

Prerequisites

You have the DBM operator authorization Backup.

Syntax

medium_put <name> <location> <type> <backup_type> <size> <block_size> <overwrite> <autoldr> <oscmd>

Examples: Creating Backup Media

Reply

OK<NL>
<name> <type> <location> <size> <overwrite> <block_size><NL>

In the event of errors, see Reply Format.