An area dump is requested via the operand specification SCOPE=*AREA of the CDUMP2 macro (permitted only from the TU area). It contains the areas of class 5 and 6 memory selected with the call and is stored under the user ID of the caller (exceptions: see section "Influence of page attributes").
Some system parameters also influence memory area output (see section "Control by means of system parameters").
The DSCTRL operand can be used to address areas in a data space that are to be included in the area dump.
The default setting is MODE=*STD; in this case, area dumps include the following items in addition to the specified areas
the AIDSYSD module
the areas containing COMAREA
TU-PCB
the TCB.
If MODE=*EXP is specified, area dumps also contain the following items
the areas containing COMAREA
the AIDSYSD module
trace dump list
TTSAV (internal CDUMP data)
TU AUDIT table
binder/loader metadata
memory areas with the following tables
XTV (eXecutive Vector Table)
SVMT (System Virtual Memory Table)
UVMT (User Virtual Memory Table)
TCB (Task Control Block)
TU-PCBs (Process Control Block)pages to which the reference address specified in the PC operand points
File name of the area dump
CDUMP creates the area dump under one of the following IDs:
under the user ID of the caller, provided he or she is authorized to read all the data output by the dump.
under the SYSUSER system ID if the dump contains read-protected data (e.g. programs protected with a read password that the user has not included in the task’s password table).
Then only the system administrator can permit access to the user, e.g. by means of
/MODIFY-FILE-ATTRIBUTES dateiname, -
/ PROTECTION=*PARAMETERS(USER-ACCESS=*ALL-USERS,READ-PASSWORD=readpass)
The file name of an area dump has the following structure:
:catid:$userid.SYS.ADUMP[.jobname].tsn.i,
if the file is saved under the caller’s user ID:catid:$SYSUSER.SYS.ADUMP[.jobname].tsn.i.userid,
if the file is saved under the SYSUSER system ID.
where: |
|