EXTBKUP (Extract from Backup File) › EXTBKUP › How to Use

How to Use

Multi-User mode is required to execute this command. Execute the EXTBKUP function using the following command format:

Extract from Backup File (z/VSE)

►►─ EXTBKUP DEVICE= ─┬─ DISK ─┬─ ,DTFNAME=ddddddd ────────────────────────────►
                     ├─ TAPE ─┤
                     └─ Snnn ─┘

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

 ►─┬──────────────────────────┬───────────────────────────────────────────────►◄
   └─ ,FORMAT= ─┬─ EXTRACT ─┬─┘
                └─ BACKUP ──┘

Command

EXTBKUP

Invokes the function to extract data from a backup file in expanded form.

Required Keywords

Specifies the name of the input backup file.

Valid Entries:

Any name valid to z/OS JCL specifications

Default Value:

(No default)

DEVICE=

Specifies the z/VSE device type for the input file. When you specify DEVICE=TAPE, the system logical unit (SYS) number must be 5, (SYS005). DEVICE=Snnn allows you to use the nnn to specify a different SYS number (for tape only).

Valid Entries:

DISK, TAPE, or Snnn

Default Value:

(No default)

,DTFNAME=

Specifies the name of the input backup file.

Valid Entries:

Any name valid to z/VSE JCL specifications

Default Value:

(No default)

Optional Keywords

,LABEL=

If DEVICE=TAPE (either TAPE or the Snnn form), 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=

Specifies action at OPEN and CLOSE. 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.

FORMAT=

If you do not specify FORMAT= (or if you specify FORMAT=EXTRACT), output is one or more extracted files, as was the case prior to Version 12.0. If you specify FORMAT=BACKUP, the output is a single file in backup format with all records compressed by any option to be expanded. When FORMAT=BACKUP, you are required to have a previous single FILEOUT function to define the single output file, and in that FILEOUT function the keyword TABLE= must be set to *** (three asterisks) to specify that all tables be written to the output file.

In support of FORMAT=, message DB13279E could be received if there is an edit error (for details about the message, see the CA Datacom/DB Message Reference Guide).

Note: VAR or NONE are not valid entries for FORMAT= in EXTBKUP and, if specified, are considered an error.

Valid Entries:

EXTRACT or BACKUP

Default Value:

EXTRACT