| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Dump System Object (DMPSYSOBJ) command is used primarily for various problem analysis tasks. It dumps the contents or attributes of machine interface (MI) system objects to a spooled printer file named QPSRVDMP. Any MI object that is stored in any context or that is addressable through an object stored in a context can be dumped.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| OBJ | Object | Character value, *PCS, *MCHCTX, *ALL | Optional, Positional 1 |
| CONTEXT | Context or library | Name, *NONE, *MCHCTX | Optional, Positional 2 |
| TYPE | Internal object type | *ALL, 01, 02, 03, 04, 07, 08, 09, 0A, 0B, 0C, 0D, 0E, 0F, 10, 11, 12, 13, 14, 15, 18, 19, 1A, 1B, 1C | Optional, Positional 3 |
| SUBTYPE | Internal object subtype | Character value, *ALL | Optional, Positional 4 |
| OBJTYPE | Object type | *ALL, *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 | Optional, Positional 5 |
| OFFSET | Hexadecimal offsets | Single values: *NONE Other values (up to 50 repetitions): 00000000-00FFFFFF |
Optional |
| SPACE | Area of space to dump | Single values: * Other values: Element list |
Optional |
| Element 1: Hexadecimal offset | 00000000-00FFFFFF | ||
| Element 2: Hexadecimal length or * | 00000001-00FFFFFF, * |
| Top |
Specifies which of the system objects are to be dumped. The name of a specific object, the generic name of a group of objects, the process control space of the job, the machine context, or all of the objects in a context can be specified. If a library name is specified, the library is dumped, but not the objects in it. If QTEMP is specified here along with either *LIB on the Object type (OBJTYPE) parameter, or 04 on the Internal object type (TYPE) parameter and 01 on the Internal object subtype (SUBTYPE) parameter, then the temporary job context associated with the job that this command is entered from, or the job being serviced as a result of the Start Service Job (STRSRVJOB) command, is dumped. In either case, the Context or library (CONTEXT) parameter value is ignored.
If a specific object is being dumped, values should be specified for on one of the following groups of parameters:
| Top |
Specifies in which context or library the objects to be dumped are located.
| Top |
Specifies the type of MI objects to dump.
| Top |
Specifies the subtype of the specified MI objects to dump, or specifies that all subtypes are being dumped. This parameter is valid only if the Internal object type (TYPE) parameter is also specified.
| Top |
Specifies the object type of the operating system objects to have their associated MI system objects dumped. If an object type is specified, values cannot be specified on either the Internal object type (TYPE) parameter or the Internal object subtype (SUBTYPE) parameter.
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 |
Specifies a list of values to use as offsets to indirectly address a single object that is being dumped. The values must be positive hexadecimal values or zeros that, when added to a pointer, result in valid addresses. If an offset of zero is added to a system pointer, the result is a pointer to the start of the space associated with the object that is addressed by the system pointer.
Single values
Other values
| Top |
Specifies the area of a space or associated space to be dumped. The space is pointed to by the final pointer determined by the Hexadecimal offsets (OFFSET) parameter. If no value is specified for the OFFSET parameter, the final pointer is a system pointer to the specified object in the context.
Single values
Element 1: Hexadecimal offset
Element 2: Hexadecimal length or *
| Top |
Example 1: Dumping Indexes
DMPSYSOBJ CONTEXT(QTEMP) TYPE(0E)
This command dumps the contents and attributes of all the indexes in the temporary job context to a spooled file for printing. MI indexes are identified by the type code 0E.
Example 2: Dumping a Device Description
DMPSYSOBJ OBJ(WS1) CONTEXT(*MCHCTX) OBJTYPE(*DEVD)
This command dumps the device description for work station WS1, which is stored in the machine context.
Example 3: Dumping Process Control Space
DMPSYSOBJ OBJ(*PCS) SPACE(0 2A0)
This command dumps the work control block from the space associated with the process control space for the job.
Example 4: Specifying Offset Values
DMPSYSOBJ OBJ(*PCS) OFFSET(60 E0 10 10) SPACE(0 20)
This command dumps the second call entry of the process automatic storage area (offset 60 E0) for a length of 32 bytes (SPACE(0 20)). If the third call level is dumped, OFFSET(60 E0 10 10 10) is specified.
| Top |
*ESCAPE Messages
| Top |