Dump Object (DMPOBJ)

The Dump Object (DMPOBJ) command dumps the contents or attributes of the specified operating system object to a spooled printer file named QPSRVDMP. Whether the contents or attributes can be dumped depends on the object type. If the user had specified SPOOL(*NO) on either the CHGPRTF command or the OVRPRTF command, then the output is not spooled but printed directly; and, if the printer is not available, then this command overrides the print job and spools the output. When the user specifies SPOOL(*NO) on one of the two commands above, the user must specify QPSRVDMP as the printer file. Any library or object that is stored in a library can be dumped, but only one object can be specified at a time on this command.

Restrictions:

Parameters

Keyword Description Choices Notes
OBJ Object Qualified object name Required, Positional 1
Qualifier 1: Object Name
Qualifier 2: Library Name, *LIBL, *CURLIB, QTEMP
OBJTYPE Object type *ALRTBL, *AUTL, *BNDDIR, *CFGL, *CHTFMT, *CLD, *CLS, *CMD, *CNNL, *COSD, *CRG, *CRQD, *CSI, *CSPMAP, *CSPTBL, *CTLD, *DEVD, *DIR, *DOC, *DTAARA, *DTADCT, *DTAQ, *EDTD, *EXITRG, *FCT, *FILE, *FLR, *FNTRSC, *FNTTBL, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCSRT, *IGCTBL, *IMGCLG, *IPXD, *JOBD, *JOBQ, *JOBSCD, *JRN, *JRNRCV, *LIB, *LIND, *LOCALE, *MEDDFN, *MENU, *MODD, *MGTCOL, *MODULE, *MSGF, *MSGQ, *M36, *M36CFG, *NODL, *NTBD, *NWID, *NWSCFG, *NWSD, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDFMAP, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *SBSD, *SCHIDX, *SPADCT, *SQLPKG, *SQLUDT, *SQLXSR, *SRVPGM, *SSND, *SVRSTG, *S36, *TBL, *TIMZON, *USRIDX, *USRPRF, *USRQ, *USRSPC, *WSCST Required, Positional 2

Object (OBJ)

Specifies the object to be dumped. Only objects that are stored in libraries can be dumped. The DMP command can be used to dump objects stored in directories.

This is a required parameter.

Qualifier 1: Object

name
Specify the name of the object to be dumped.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is used to locate the object. If no current library entry exists in the library list, QGPL is used.
name
Specify the name of the library where the object is located.

Object type (OBJTYPE)

Specifies the object type of the operating system object being dumped. Any one of the object types can be specified.

This is a required parameter.

object-type
Specify the object type of the object to be dumped.

To see a complete list of object types when prompting this command, position the cursor on the field for this parameter and press F4 (Prompt). For a description of the object types, see "Object types" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.

Examples

Example 1: Dumping File Contents 

DMPOBJ   OBJ(ORDENT/ORDERIN)  OBJTYPE(*FILE)

This command dumps the contents of the file named ORDERIN that is stored in the ORDENT library.

Example 2: Dumping a Program 

DMPOBJ   OBJ(MYPROG)  OBJTYPE(*PGM)

This command dumps the first copy of the program MYPROG that is found in the library list. The dump is spooled to the printer output file QPSRVDMP.

Error messages

*ESCAPE Messages

CPF3560
Job being serviced not running.
CPF3561
Context &8 &9 &7 not found.
CPF3562
Object &7 not found.
CPF3673
Not authorized to library &7.
CPF3909
Service command will not be processed.
CPF3918
Service request canceled.
CPF3925
Cannot open file &1.
CPF3935
Job being serviced ended during dump.
CPF3946
Context damaged.
CPF3947
Library &7 not available.
CPF3948
Library &3 previously deleted.
CPF3949
Library &7 damaged.
CPF3950
Error message &2 received for file &1. Request ended.
CPF3951
File &1 cannot be overridden by file name &2.
CPF3967
Dump not started because serviced job not running.
CPF3968
Dump not started because serviced job completed running.
CPF3969
Error during close of file &1. Output may not be complete.