Dump System Object (DMPSYSOBJ)

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

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:

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

Top

Parameters

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, 23	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, SQLXSR, 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

Object (OBJ)

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.

*PCS

The process control space of the current job or that of the job being serviced as a result of the Start Service Job (STRSRVJOB) command is dumped. *PCS specified here can be used with the Hexadecimal offsets (OFFSET) parameter and the Area of space to dump (SPACE) parameter to dump objects in the job structure. If *PCS is specified, the following parameters are ignored:

Object type (OBJTYPE parameter).
Internal object subtype (SUBTYPE parameter).
Internal object type (TYPE parameter).
Context or library (CONTEXT parameter).

*MCHCTX

The machine context (which contains a list of the objects in the context) is dumped. If *MCHCTX is specified here, all the other parameters in this command are ignored.

*ALL

All the system objects in the specified context are dumped if they match the requirements specified on either the OBJTYPE parameter or the TYPE and SUBTYPE parameters.

generic-name

Specify the generic object name that identifies the group of system objects to dump. An object name can have as many as 30 characters in it.

name

Specify the name of the object that is to be dumped. A maximum of 30 characters can be entered. If more than one object has the same name, all objects having that name and matching the attributes specified are dumped.

If a specific object is being dumped, values should be specified for on one of the following groups of parameters:

CONTEXT, TYPE, and SUBTYPE
CONTEXT and OBJTYPE

Top

Context or library (CONTEXT)

Specifies in which context or library the objects to be dumped are located.

*NONE: The object specified on the Object (OBJ) parameter is not in any context. *NONE is valid only if *PCS or *MCHCTX is specified or defaulted for the OBJ parameter, or if QTEMP is specified on the OBJ along with either *LIB for the OBJTYPE parameter, or 04 for the TYPE parameter and 01 for the SUBTYPE parameter.
*MCHCTX: The objects to dump are in the machine context. The following operating system object types, whose system object names are given in parentheses, can reside only in the machine context: library (context), user profile, device description, line description, network interface description, and controller description. *MCHCTX is valid only if one of these five object types is dumped.
name: Specify the name of the context containing the objects being dumped. The name of a library, such as QGPL or QTEMP, can be specified. If QTEMP is specified, the objects to dump are in 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.

Top

Internal object type (TYPE)

Specifies the type of MI objects to dump.

*ALL: All object types in the specified context that have the specified name (if used) are dumped.
MI-system-object-type-in-hex: Specify the hexadecimal value that specifies the type of system objects to dump. The value must be specified with both characters, but it does not have to be enclosed in apostrophes.

Top

Internal object subtype (SUBTYPE)

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.

*ALL: All the sub-types of the specified objects are dumped.
MI-system-object-subtype-in-hex: Specify the specific subtype of the system objects to dump. The subtypes are in the range of 00 through FF. However, the subtype specified must be for an MI object actually in the specified context. If *ALL is specified on the TYPE parameter, a specific subtype cannot be specified.

Top

Object type (OBJTYPE)

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.

*ALL: The specified MI objects of all operating system object types are dumped.
operating-system-object-type: Specify the Operating System object type for the objects 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/.

Top

Hexadecimal offsets (OFFSET)

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

*NONE: No offset is specified. The object located through the context is dumped.

Other values

X'00000000'-X'00FFFFFF': Specify the list of offsets to pointers to use to address the object or space to dump. A maximum of 50 offset values can be specified.

Top

Area of space to dump (SPACE)

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

*: If the final pointer is a system pointer, the object pointed to by that pointer is dumped. If the final pointer is a space pointer, the portion of the space that starts at the location pointed to by that pointer is dumped.

Element 1: Hexadecimal offset

X'00000000'-X'00FFFFFF': Specify the value to add to the final pointer to point to the beginning of the area to dump. The value specified must be a positive hexadecimal value or zero and, when added to the final pointer, must result in a valid address.

Element 2: Hexadecimal length or *

*: The rest of the space pointed to as a result of the offset value is being dumped.
X'00000000'-X'00FFFFFF': Specify a positive hexadecimal value that specifies the length of the area to dump. If the length specified is greater than the actual length of the space, only the actual space available is dumped.

Top

Examples

Example 1: Dumping Indexes

DMPSYSOBJ  OBJ(*ALL)  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  1000)

This command dumps the work control block from the space associated with the process control space for the job.

Example 4: Two Samples Specifying Offset Values

DMPSYSOBJ  OFFSET(1F0)

This command dumps the job message queue.

DMPSYSOBJ  OBJ(QINTER)  CONTEXT(QSYS)  OBJTYPE(*SBSD)
           OFFSET(1D0 310 D0)

This command dumps the flight recorder of an active subsystem.

Top

Error messages

*ESCAPE Messages

CPF3502: No objects printed because no objects found.
CPF3508: SUBTYPE (&5) value is not permitted.
CPF3523: Starting offset &8 greater than size of space.
CPF3534: Not authorized to object.
CPF3537: Object &2 is damaged.
CPF3538: Cannot allocate object.
CPF3539: Object destroyed while being dumped.
CPF3560: Job being serviced not running.
CPF3561: Context &8 &9 &7 not found.
CPF3562: Object &7 not found.
CPF3563: Overflow value for file &1 in &2 too large.
CPF3566: No objects dumped because no objects found.
CPF3577: Data object &7 not found.
CPF3578: Base data object &7 not found.
CPF3642: Address of chain pointer &7 not permitted.
CPF3643: Address for chain pointer &7 not 16-byte aligned.
CPF3644: Base object &7 has no associated space.
CPF3645: Not authorized to base object &7.
CPF3646: Base object &2 is damaged.
CPF3647: Base object &8 or previous base object destroyed.
CPF3648: Base object &2 data area not found.
CPF3649: Chaining pointer &7 does not exist at location specified.
CPF3650: Chaining pointer &7 is instruction pointer.
CPF3651: Offset too large for base object &7.
CPF3652: Offset to last chaining pointer too large.
CPF3653: Location for last chaining pointer not 16-byte aligned.
CPF3654: Object &2 is damaged.
CPF3655: Last base object or final object previously deleted.
CPF3656: Base object &2 data area not found.
CPF3663: Base object number &7 not found.
CPF3664: Object &2 has no associated space.
CPF3665: Not authorized to dump object &2.
CPF3666: Object &2 is damaged.
CPF3667: Object to be dumped was destroyed.
CPF3668: Object &2 data area not found.
CPF3669: Final pointer does not exist at specified location.
CPF3670: Final pointer is instruction pointer.
CPF3671: Starting offset &8 too large.
CPF3672: Object specified by final pointer not found.
CPF3673: Not authorized to library &7.
CPF3909: Service command will not be processed.
CPF3913: Context &7 previously deleted.
CPF3914: Context &7 data area not found.
CPF3915: Context &7 damaged.
CPF3916: Context &7 not available.
CPF3918: Service request canceled.
CPF3925: Cannot open file &1.
CPF3935: Job being serviced ended during dump.
CPF3941: CONTEXT(*MCHCTX) and TYPE(&4) cannot be used together.
CPF3942: CONTEXT(*MCHCTX) and OBJTYPE(*&6) cannot be used together.
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