BACKUP

The BACKUP utility copies one or more areas in a database to a backup file. The backup file can be used later as input for a restore operation.

Note: The format of files produced by the BACKUP utilityis not compatible with the format of backup files produced by the 10.2 IDMSDUMP utility program. Files produced by BACKUP can only be used by the RESTORE utility and files produced by IDMSDUMP can only be used with IDMSRSTR.

Authorization

To	You Need This Privilege	On
Back up an area	DBAREAD	The area
Back up a file	DBAREAD	The area(s) to which the file maps

BACKUP Syntax

                           ┌─────────── , ────────────┐
►►─── BACKUP ─┬─ AREA ─────▼─ segment-name.area-name ─┴─┬─────────┬─────────┬─►◄
              │                                         └─ SHARE ─┘         │
              │            ┌─────────── , ────────────┐                     │
              ├─ FILE ─────▼─ segment-name.file-name ─┴─────────────────────┤
              │                                                             │
              │            ┌────── , ────────┐                              │
              └─ SEGMENT ──▼─ segment-name ──┴──┬─────────────┬─┬─────────┬─┘
                                                ├─ BY AREA ◄──┤ └─ SHARE ─┘
                                                └─ BY FILE ───┘

BACKUP Parameters

AREA

Directs the BACKUP utility to back up one or more areas. Multiple area names must be separated by commas.

segment-name

The name of the segment associated with an area to be backed up.

area-name

The name of an area.

SHARE

Specifies that no locks are to be placed on the named areas. When you specify SHARE, each specified area is backed up regardless of whether a lock has been placed on the area by another program. SHARE allows the named areas to be backed up while another job is updating those areas at the same time, for example, it needs to be specified when taking a "hot backup" during which the areas that are being backed up are being updated by transactions executing under the central version.

By default, if you do not specify SHARE, an external lock is placed on each specified area for the duration of the backup operation. If an external lock cannot be placed on an area, that area will not be backed up, and the backup operation will terminate with an error. Therefore, no more areas will be backed up. An external lock means that it is placed physically using the normal SMP lock.

Note: When you specify SHARE and do not vary the affected areas for retrieval only, the copy of the database created by the BACKUP utility may not be usable for restore operations.

FILE

Directs the BACKUP utility to back up one or more files.

Multiple file names must be separated by commas.

segment-name

The name of a segment associated with a file to be backed up.

file-name

The name of a file.

SEGMENT segment-name

The name of the segment to be backed up.

BY AREA

Specifies that each area defined within the segment is to be backed up. AREA is the default.

BY FILE

Specifies that each file within the segment is to be backed up.

Note: The SHARE option is only valid for area processing. When you specify the BACKUP SEGMENT command with the BY FILE option, the SHARE option is ignored. If you specify the BY FILE option with the BACKUP SEGMENT command and the SHARE option is omitted, area locks are not set.