User dump

A user dump is requested via the operand specification SCOPE=*USER of the CDUMP2 macro or via the CREATE-DUMP command. It covers the entire user address space, i.e. class 5 and class 6 memory.
Some system parameters influence memory area output (see section "Control by means of system parameters").

Output options using CDUMP2 operands:

• user-specific data spaces with the DS operand

• user-specific DIV windows with the DIV operand

• imported POSIX files with the MMAP operand

If the error task instruction counter points to the system address space, all the pages referenced via general registers and PCs (up to 256 PCBs of the error task) are output, including the preceding five pages and the following five pages.

User dumps also contain the following memory areas:

• the AIDSYSD module

• trace dump list

• TTSAV (internal CDUMP data)

• P1 AUDIT table

• binder/loader metadata

• system trace table

• memory areas containing the following tables
  XTV (eXecutive Vector Table)
  SVMT (System Virtual Memory Table)
  UVMT (User Virtual Memory Table)
  TCB (Task Control Block)
  P1-PCBs (Process Control Block)

• page to which the reference address specified in the PC operand points

• JIT390 administration data

In the event of a user dump, the system trace table is buffered with its contents as they were when CDUMP was called. When the dump is generated, the system trace table is incorporated in the dump (at the position at which the table is located in the system).

File name of a user dump

CDUMP creates the user 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).

  If the dump includes at least one page that is privileged but not “common readable”, the user dump is output to the user ID SYSUSER as well. 
  If the dump is stored under $SYSUSER, 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 a user dump has the following structure:

• :catid:$userid.DUMP[.jobname].tsn.i,
  if the file is saved under the caller’s user ID :

• :catid:$SYSUSER.DUMP[.jobname].tsn.i.userid,
  if the file is saved under the SYSUSER system ID.

where: catid userid jobname tsn i

is the catalog ID of the public volume set on which the dump is stored. is the user ID of the caller. is the name of the job, comprising up to eight characters. is the four-digit task sequence number of the error task. is the five-digit sequence number of the user dump.