Dump Object (DMP)

The Dump (DMP) command dumps the contents and/or attributes of the specified integrated file system object to a spooled printer file named QPSRVDMP. Whether the contents and/or attributes can be dumped depends upon the object type. Any integrated file system object can be dumped, but only one object can be specified at a time on this command.

Restrictions:

• You must have read and execute (*RX) authorities to the directory containing the object and read (*R) to the object. If the object is in QSYS.LIB file system, you must have use (*USE) authority to the object and execute (*EXECUTE) authority to the library. To dump internal document library objects all object (*ALLOBJ) special authority is required.
• The Dump (DMP) command will not allow a pattern to be specified for a directory in the path name, only for the object name. You can invoke the Work with Object Links (WRKLNK) command to see objects in directories.
• For more information on specifying path names, refer to Chapter 2 of the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/. Additional information about object name patterns is in the Integrated file system topic collection in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.
• Not all file systems support the DMP command. The following list of local file systems are supported:
  • Root file system
  • QOpenSys file system
  • QSYS.LIB file system
  • QDLS file system
  • User-defined file systems

Parameters

Object (OBJ)

Specifies the path name of the object to dump.

*

If invoked from an interactive job, the Select Object menu is shown, listing all directories and files in the job's current directory. From this display, you can select an object to be dumped. You can use the Change Current Directory (CHGCURDIR or CD or CHDIR) command to change the current directory before running the DMP command.

path-name

Specifies the path name of the object to be dumped. If a pattern is specified on this parameter and more than one object matches the pattern, you can select the object from a list in an interactive job. If this is a batch job, the command fails with an error message.

Examples

Example 1: Dumping Stream File Contents

DMP   OBJ('/user/Test.stmf')

This command dumps the contents of the stream file named /user/Test.stmf. The dump is spooled to the printer output file QPSRVDMP.

Error messages

*ESCAPE Messages

CPFA08E

More than one name matches pattern.