ADDDUMP subcommand — add a source description to a dump directory

Use the ADDDUMP subcommand to add a source description to a dump directory. The description is for an unformatted source that IPCS can format, for example, an SVC dump, a stand-alone dump, an SYSMDUMP dump, a trace data set, a data set, or active storage. The directory is allocated with ddname IPCSDDIR and is your current dump directory. The current dump directory is your user dump directory or, for users with write access authority, might be the sysplex dump directory.

If the source is a dump, IPCS does not initialize it, as this is a process that takes time. If IPCS can access the dump and it is an unformatted dump from an z/OS MVS™ system or an MVS/ESA SP 5.2 or 5.2.2 system, IPCS accesses it to define symbols for the dump and place them in the symbol table in the record. For information about the symbol table, see z/OS MVS IPCS User's Guide. IPCS defines the following symbols, as appropriate; for information about these symbols, see IPCS symbols.

DUMPINGPROGRAM
DUMPORIGINALDSNAME
DUMPREQUESTOR
DUMPTIMESTAMP
DUMPTOD
ERRORID
INCIDENTTOKEN
PRIMARYSYMPTOMS
REMOTEDUMP
SECONDARYSYMPTOMS
SLIPTRAP
TITLE

Related subcommands
- DROPDUMP

Syntax

  ADDDUMP

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

              [ ACTIVE|MAIN|STORAGE            ]
              [ DSNAME(dsname)|DATASET(dsname) ]
              [ FILE(ddname)|DDNAME(ddname)    ]
              [ PATH(path-name)     ]
              [ FLAG(severity) ]
              [ TEST | NOTEST ]

Parameters
ACTIVE or MAIN or STORAGE

DSNAME(dsname) or DATASET(dsname)

FILE(ddname) or DDNAME(ddname)

PATH(path-name)

Specifies the source storage or data set to be represented by the source description. One of these parameters is required.
ACTIVE, MAIN, or STORAGE specifies central storage.

DSNAME or DATASET specifies a cataloged data set.

FILE or DDNAME specifies the ddname of a data set.

PATH specifies the path 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 ADDDUMP subcommand.
Example: Add a dump to your user dump directory.
- Action
```
adddump dsname('sys1.dump.d930428.t110113.system1.s00001')
```
- Result
  IPCS creates in your user dump directory a source description for the dump with the data set name of sys1.dump.d930428.t110113.system1.s00001. IPCS accesses the dump but does not initialize it.