Dump System Object (DMPSYSOBJ)

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

 

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 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

 

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

 

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