Dump Object (DMPOBJ)

Where allowed to run: All environments (*ALL) Threadsafe: No

Parameters Examples Error messages

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:

• To use this command, be signed on as QPGMR, QSYSOPR, QSRV, or QSRVBAS, or have all object (*ALLOBJ) special authority.

Top

---

 

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, *SRVPGM, *SSND, *SVRSTG, *S36, *TBL, *TIMZON, *USRIDX, *USRPRF, *USRQ, *USRSPC, *WSCST	Required, Positional 2

Top

 

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.

Top

 

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 concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.

Top

---

 

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.

Top

---

 

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.

Top