General CA MIM Statements and Commands › (MIM) DUMP MIM Command-Create Dump

(MIM) DUMP MIM Command-Create Dump

CA Technical Support uses the DUMP MIM command for diagnostic purposes. This command is to be used only when you are directed by CA Technical Support to do so.

Scope: Local

This command has the following format:

DUMP MIM [ACTAREA]
         [ADDRESS=(address[,length])]
         [CHANGEMEMORY=(addr,newvalue[,key])]
         [C0AREA]
         [DFRE]
         [DI0AREA]
         [FCV]
         [GCDAREA[={CHKPT[=00]|CTC|DASD[=00]|VCF}]]
         [GMR[={CHKPT|VCF}]]
         [GPRMBLK]
         [GQ0AREA]
         [GQ1AREA]
         [GQ2AREA]
         [GQ8AREA]
         [GSIE]
         [GVALBLK]
          [HYPERSTAR=hyperopt]
         [IOSTATS[=CHKPT]]
         [KILL=({TASKNAME=identifier|TCB=tcbaddr[,ASID=asid]}]
         [LOCKS]
         [LXCELL]
         [LXWA] 
         [MLI]
         [MODULE=(module[,length] )]
         [MSGDIR]
         [MSGTBL]
         [PATH]
         [ROUTINE]
         [S1AREA]
         [STRNAME=structure]
         [T1AREA]
         [TRAPS=keywords]
         [UCB=(dddd[,length])[,UPDATE=(disp,data)]]
         [USERAUTH]
         [UXDEF]
         [UX0AREA]
         [UX1AREA]
         [VCFAREA]
         [VCFPATHS]
         [VCFTRACE]
         [XESDATA=structure]

ACTAREA

(Optional) Dumps the ACTAREA control block.

ADDRESS

(Optional) Dumps the requested storage beginning at the specified one- to four-byte address and for the specified length. The address is required, while length is optional. Both values are specified in hexadecimal format. For example, the address could be entered as X'1C000' or 1C000. The default length displayed if no value is entered for length is X'D0' bytes.

CHANGEMEMORY

(Optional) Changes the contents of memory.

C0AREA

(Optional) Dumps the C0AREA control block.

DFRE

(Optional) Dumps the DFRE control blocks.

DI0AREA

(Optional) Dumps the DI0AREA control block.

FCV

(Optional) Dumps the FCV control block.

GCDAREA

(Optional) Dumps the GCDAREA control block for the active control file. Optionally, you can specify CHKPT (or CKPT) for the current checkpoint file, CTC for CTC information, a DASD file ID for DASD file information, or VCF for virtual control file information.

GMR

(Optional) Dumps the GMR control block. Optionally, you can dump the GMR information for the active checkpoint data set (DUMP MIM GMR=CHKPT (or CKPT)), or for the virtual control file (DUMP MIM GMR=VCR).

GPRMBLK

(Optional) Dumps the GPRMBLK control block.

GQ0AREA

(Optional) Dumps the GQ0AREA control block.

GQ1AREA

(Optional) Dumps the GQ1AREA control block.

GQ2AREA

(Optional) Dumps the GQ2AREA control block.

GQ8AREA

(Optional) Dumps the GQ8AREA control block.

GSIE

(Optional) Dumps the GSIE control blocks.

GVALBLK

(Optional) Dumps the GVALBLK control block.

HYPERSTAR

(Optional) Sets debugging options for the Hyperstar selectable feature. When

IOSTATS

(Optional) Dumps the I/O statistics control block for the active control file. Optionally, you can dump the I/O statistics for the active checkpoint data set if you specify DUMP MIM IOSTATS,CHKPT.

KILL

Note: This parameter has no effect on z/VM systems. It is included here only for consistency with CA MIM for z/OS systems.

(Optional) Cancels a specific TCB within the CA MIM address space. Specify one of the following:

TASKNAME

Identifies a task name identifier corresponding to one listed in the DISPLAY TASK command response.

TCB

Identifies a TCB address.

ASID

(Optional.) Specifies the target address space ID. This keyword may be specified with the TCB keyword to qualify a TCB in an address space other than the CA MIM address space. If the ASID keyword is omitted, the target TCB address is assumed to be within the CA MIM address space.

Note: The TCB and TASKNAME keywords are mutually exclusive.

LOCKS

(Optional) Dumps the lock words for the CA MIM internal lock mechanism.

LXCELL

(Optional) Dumps the LXCELL control block.

LXWA

(Optional) Dumps the LXWA control block.

MLI

(Optional) Dumps the MLI control block.

MODULE

(Optional) Dumps the specified module in hexadecimal dump format. The one- to eight-character module name is required. Optionally, you can specify the one- to four-byte length. The default length displayed is X'C0' bytes.

MSGDIR

(Optional) Dumps the MSGDIR control block.

MSGTBL

(Optional) Dumps the MSGTBL control block.

PATH

(Optional) Dumps VCFPATH control blocks for all locally defined paths.

ROUTINE

(Optional) Dumps the storage where the named routine is loaded.

S1AREA

(Optional) Dumps the S1AREA control block.

STRNAME

(Optional) Specifies the name of a coupling facility structure control file that is to be dumped to a system dump data set.

T1AREA

(Optional) Dumps the T1AREA control block.

TRAPS

(Optional) Enables and disables the internal CA MIM diagnostic code.

UCB

(Optional) Provides display and update of UCB control blocks. If UPDATE is specified, then the UCB is updated. If UPDATE is not specified, then the UCB contents are displayed. These values can be specified as follows:

dddd

Specifies the device address of UCB to display or update.

length--(Optional) Specifies the length, in hex, to display.

Default: 30.

UPDATE

(Optional) Specifies that the UCB is to be updated.

disp--Specifies the displacement into UCB to update.

data--Specifies the data to place at displacement disp into UCB. You can specify one or more contiguous bytes.

UXDEF

(Optional) Dumps the UXDEF control block.

UX0AREA

(Optional) Dumps the UX0AREA control block.

UX1AREA

(Optional) Dumps the UX1AREA control block.

VCFAREA

(Optional) Dumps the VCFAREA control block.

VCFPATHS

(Optional) Dumps VCFPATHS control blocks for all locally defined paths.

VCFTRACE

(Optional) Dumps the trace table data associated with virtual control file processing.

XESDATA

(Optional) Displays internal information regarding the named coupling facility structure control file.

Usage Notes: DUMP MIM Command

• This command is solely intended for use as a diagnostic tool under the direction of CA Technical Support.
• The displays generated by this command are unformatted, and therefore not readily usable by those unfamiliar with the CA MIM internal control blocks.
• Some parameters of this command may cause serious performance degradation of CA MIM and its facilities, or may cause unexpected system ABENDs.

Example: DUMP MIM Command

To dump the contents of the VCFAREA control block, issue this command:

DUMP MIM VCFAREA