DUNZIP(1)

NAME

dunzip - Unterse and restore datasets from a dzip archive file or dataset.

SYNOPSIS

dunzip [-dDhouvV] [-e<dataset-pattern>]+ [-H[newhlq]]
       [-i<dataset-pattern>]+ [-m<mgmtclas>] [-Q<tmphlq>] [-s<size>]
       [-S<storclas>] [-t<volume>] [<src-file>|<src-dataset>] [<volume>]

-d
    Prints out debug messages.

-D
    Source is a dataset.

-e
    Excludes particular dataset patterns when restoring the datasets from the
    dzip archive.

-h
    Displays syntax help.

-H
    Specifies the high-level-qualifier (HLQ) to use for the restored datasets.
    If not specified, then the username of the currently logged-in user will
    be used as the HLQ.

-i
    Includes particular dataset patterns from the dzip binary file in the
    unzipped contents.

-I
    Specifies that the datasets that are being restored were dumped from a
    different system.

-m
    Specifies the user-desired management class that is to replace the
    source management class as input to the ACS routines.

-N
    Restores datasets to their original HLQ from when they were archived.
    This overrides any value specified by the -H argument, if any.

-o
    Overwrites existing datasets with the same name on target device.

-Q
    Uses an alternative high-level qualifier (HLQ) for the temporary dataset
    name. This will override the TMPHLQ environment variable.

-s
    Specifies how large to allocate datasets. Valid units are:
    CYL, TRK, K, M, G. Defaults to bytes if no unit is provided.

-S
    Specifies the user-desired storage class that is to replace the source
    storage class as input to the ACS routines.

-t
    Specifies a particular volume should be used when creating temporary
    datasets.

-u
    Specifies the SMS classes specified with -S and/or -m should be used
    when creating temporary datasets.

-v
    Prints out verbose command information.

-V
    Unzip volume (default is dataset).

ENVIRONMENT VARIABLES

TMPHLQ
    Overrides the current high-level qualifier used for temporary
    dataset names.

DESCRIPTION

dunzip uses an archive file or dataset created by dzip to unterse and restore datasets with ADRDSSU and AMATERSE. It provides the option of changing the first segment of the HLQ. For example, USER.TEST.FILE could be changed to MY.TEST.FILE.

If you specify more than the first HLQ segment (such as MY.HLQ), the command exits with an error message.

If you specify multiple dataset patterns with -e or -i, you must separate them with a space or comma (,).

DATASET PATTERNS

The following rules apply to <dataset-pattern>.

Either fully or partially qualified dataset names can be used.

Use a single asterisk (*) in place of exactly one qualifier. You can also use it to indicate to DFSMSdss that only part of a qualifier has been specified. For example, just the first, last, middle, or first and last parts.

Using the double asterisk (**) with other qualifiers indicates either the nonexistence of leading, trailing, or middle qualifiers, or the fact that they play no role in the selection process.

Two asterisks are the maximum permissible in a qualifier. If there are two asterisks in a qualifier, they must be the first and last characters.

A question mark (?) or percent sign (%) matches a single character.

EXAMPLES

Extract datasets from the dzip file /tmp/zoau.dzp onto volume TEST. The datasets is created with a size of 5MB.

dunzip -s 5M /tmp/zoau.dzp TEST

Extract a volume from the dzip file /tmp/volume.dzp onto volume USER10. The volume is created with a size of 20GB.

dunzip -V -s 20G /tmp/volume.dzp USER10

Extract datasets from the dzip dataset SOURCE.DATA.SET, onto volume USER10. Datasets with the pattern USER.TEST.* are included in the extraction, but the dataset USER.TEST.SOMEDS is excluded.

dunzip -D -i user.test.* -e user.test.someds source.data.set USER10

EXIT VALUES

0
     dunzip completed successfully.

2
     The help text was printed.

4
     There is a syntax error in the dzip command.

8
     An error ocurred when dunzip was running.