BACKUP (Create Backups) › BACKUP CXX (Back Up Directory) › How to Use

How to Use

You can execute this command in either Single User or Multi-User mode. To back up your Directory, execute DBUTLTY using the command:

Back Up Directory

►►─ BACKUP AREA=CXX ─ ,DEVICE= ─┬─ DISK ─┬─ ,DTFNAME=ddddddd ─────────────────►
                                ├─ TAPE ─┤
                                └─ Snnn ─┘

 ►─┬──────────┬─┬───────────────────────┬─┬────────────────────────┬──────────►◄
   └─ DBID=n ─┘ └─ ,LABEL= ─┬─ YES ◄ ─┬─┘ └─ ,REWIND= ─┬─ YES ◄ ─┬─┘
                            └─ NO ────┘                └─ NO ────┘

Command

BACKUP

Invokes the BACKUP function.

Required Keywords

AREA=CXX

Identifies the area to be backed up as the Directory.

DEVICE=

Specifies the device type for the output data set.

When DEVICE=TAPE is specified, the system logical unit (SYS) number must be 5 (SYS005).

Use the Snnn entry to specify a specific SYS number (for tape only).

Valid Entries:

DISK, TAPE, Snnn (Certain values from previous versions are still accepted but are treated as DISK.)

Default Value:

(No default)

DTFNAME=

Specifies the z/VSE JCL TLBL/DLBL name for the output file. If DEVICE=TAPE, this name must match the corresponding name which you code in your z/VSE JCL TLBL statement; otherwise, this name must match the name you code in your z/VSE JCL DLBL statement.

Valid Entries:

Any name valid to z/VSE JCL specifications

Default Value:

(No default)

Optional Keywords

DBID=

Identifies the database to be backed up. If not specified, the function backs up the entire CXX, as would have occurred in the previous release, before this optional DBID= keyword was added. With DBID= specified, the only output is the designated database. Only one DBID can be specified and only once, that is, you cannot specify a range of databases.

Valid Entries:

DATACOM-ID of the database

Default Value:

(No default)

LABEL=

If DEVICE=TAPE (either TAPE or the Snnn form), LABEL= specifies whether tape labels are to be processed. We recommend that labeled tapes always be used.

Note: LABEL= has no effect when DEVICE=DISK.

Valid Entries:

NO or YES

Default Value:

YES

REWIND=

If DEVICE=TAPE (either TAPE or the Snnn form), YES indicates the tape is to be rewound before OPEN and after CLOSE. NO indicates no rewind before OPEN or after CLOSE. If omitted, the tape is rewound before the OPEN and rewound with unload after the CLOSE. NO allows the stacking of backups on one tape.

Note: REWIND= has no effect when DEVICE=DISK.

Valid Entries:

NO or YES

Default Value:

The tape is rewound before the OPEN and rewound with unload after the CLOSE.