COPYDDIR subcommand — copy source description from dump directory

Use the COPYDDIR subcommand to copy one or more source descriptions. A description is a reference to a source of data, a dsname, ddname, or path. Additional, optional records may also be present and copied:

Some records may help you understand the significance of the source.
Other records may enable IPCS to assist in analysis and formatting of its contents.
A few records may serve dual roles, symbols allowing you to refer to important data by name and allowing IPCS to locate the same important data and check its validity just once in the course of analyzing a dump.

COPYDDIR can perform three similar types of operations:

Copy operations transcribe records to the current session dump directory from another dump directory. You designate the source directory via INDATASET, INDDNAME, or aliases of those keywords. Multiple descriptions may be selected for transcription in a single operation.
Import operations transcribe records to the current session dump directory from a RECFM=VB data set. You designate the source RECFM=VB data via INDATASET, INDDNAME, or aliases of those keywords. No selectivity is supported. One description is copied.
Export operations transcribe records from either the current session dump directory or another dump directory to a RECFM=VB data set.
- You imply the use of the current session dump directory by omitting INDATASET, INDDNAME, and their aliases.
- You designate the source directory via INDATASET, INDDNAME, or aliases of those keywords.
You designate the target RECFM=VB data set via the EXPORT keyword. The same selection options supported for COPY may be used to select a single description to be exported.

The main purpose of the COPYDDIR subcommand is to place the source description of a dump or trace into your current user dump directory, so that you can format and analyze the dump or trace.

See z/OS MVS IPCS User's Guide for information about dump directories.

Syntax

    COPYDDIR   [ INDATASET(dsname)|INDSNAME(dsname) ]
               [ INFILE(ddname)|INDDNAME(ddname)    ]
               [ EXPORT {(DSNAME(dsname))|(DATASET(dsname))} ]        
                        {(FILE(ddname))|(DDNAME(ddname))   }
               [ SUMMARY | NOSUMMARY ]
               [ DSNAME(dslist)|DATASET(dslist)                    ]
               [ FILE(ddname-range-list)|DDNAME(ddname-range-list) ]
               [ PATH(path-name ...)                     ]

-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.

               [ TEST | NOTEST ]

Parameters
Use a DSNAME, DATASET, FILE, DDNAME, or PATH parameter to specify the source for the source description to be copied. You can request copying of more than one source description. Note that you can also use a SCREEN keyword with INDATASET or INFILE while the IPCS dialog is active in order to display the COPYDDIR inventory panel for the input dump directory selected.
INDATASET(dsname) or INDSNAME(dsname)

INFILE(ddname) or INDDNAME(ddname)

Specifies the input for copy or import operations. One of these parameters is required except when the EXPORT option is selected. EXPORT uses the current session directory as a source of records when neither input dsname nor input ddname are specified.
Note: Do not specify your current dump directory. Do not specify IPCSDDIR as the ddname.

INDATASET or INDSNAME specifies the input directory by its data set name.

INFILE or INDDNAME specifies the ddname of the input data set.

EXPORT(DSNAME(dsname)) or EXPORT(DATASET(dsname))

EXPORT(FILE(ddname)) or EXPORT(DDNAME(ddname))

Specifies a RECFM=VB data set to receive dump directory records pertaining to one source. RECFM=VB data sets must have a LRECL of 3076 or larger.

SUMMARY or NOSUMMARY

SUMMARY indicates that a summary line containing the total number of dump descriptions copied should be displayed and is the default.
NOSUMMARY suppresses the summary line unless one or more source descriptions were not copied, for example, if error conditions exist, or if the description already exists in the output directory. You might use NOSUMMARY when running COPYDDIR within a CLIST or REXX exec.

DSNAME(dslist) or DATASET(dslist)

FILE(ddname-range-list) or DDNAME(ddname-range-list)

Specifies one or more data sets for the source descriptions to be copied. If one of these parameters is not specified, the default is the SETDEF-defined default source data set.
DSNAME or DATASET specifies the data set name or a list of data set names of cataloged data sets. The dslist can include a wildcard character (*) to represent any name. A data set name can contain a single asterisk in place of any qualifier except the first. For example, DSNAME (A,*,C) specifies all names with 3 qualifiers that have A as the first qualifier and C as the third qualifier.

FILE or DDNAME specifies the ddname, a list of ddname, or a range of ddnames for the data sets. For example, FILE(A:C) specifies all ddnames from A to C, including A, AA, ABC, B, C, and so on.

When specifying more than one data set name or ddname, separate the names with commas or blanks. When specifying a range of ddnames, separate the first and last ddname with a colon.

PATH specifies the path-name or list of path-names of a file or directory on a z/OS® UNIX file.
Return codes
See Standard subcommand return codes for a description of the return codes produced by the COPYDDIR subcommand.
Example 1: Copy the source description for the dump data set MY.DUMP from the sysplex dump directory, SYS1.DDIR, to your current user dump directory.
- Action
```
COMMAND ===>  COPYDDIR INDSNAME(SYS1.DDIR) DSNAME(MY.DUMP)
```
- Result
  COPYDDIR copies the source description for MY.DUMP from SYS1.DDIR into your current user dump directory and displays a summary of the processing.
Example 2: Copy source descriptions for multiple data sets to your current user dump directory:
- Action
```
COMMAND ===>  COPYDDIR FILE(W:X) DSNAME(MY.DUMP2) INDSNAME(DUMPDIR)
```
- Result
  IPCS copies the source descriptions from the DUMPDIR directory for all data sets beginning with W or X and data set MY.DUMP2 into your current user dump directory. IPCS displays a summary of the processing.