IBM Systems > Servers > Mainframe servers > z/OS >

APAR II10573

How to request dumps in a Language Environment® Run-Time environment in OS/390 V2R7

The method for generating a system dump varies for each of the Language Environment run-time environments. The following procedures describe the recommended steps needed to generate a system dump in a batch, IMS, CICS, and OS/390 UNIX shell run-time environment. Other methods may exist, but these are the recommended steps for generating a system dump.

Generating a System Dump in a Batch Run-Time Environment

To generate a system dump in a batch run-time environment complete the following steps:

Specify run-time options TERMTHDACT(UAONLY, UADUMP, UATRACE, or UAIMM), and TRAP(ON). If you specify the suboption UAIMM then you must set TRAP(ON,NOSPIE). The TERMTHDACT suboption determines the level of detail of the Language Environment formatted dump.
Include a SYSMDUMP DD card with the desired dataset name and DCB information: LRECL=4160, BLKSIZE=4160, and RECFM=FBS.
Rerun the program.

Generating a System Dump in an IMS Run-Time Environment

To generate a system dump in an IMS run-time environment complete the following steps:

Specify run-time options TERMTHDACT(UAONLY, UADUMP, UATRACE, or UAIMM), and TRAP(ON). If you specify the suboption UAIMM then you must set TRAP(ON,NOSPIE). The TERMTHDACT suboption determines the level of detail of the Language Environment formatted dump. In an IMS environment you can only use CEEUOPT, CEEDOPT, or CEEROPT to change run-time options. CEEUOPT cannot be used by OS/VS COBOL or non-Language Environment assembler.
Include a SYSMDUMP DD card with the desired dataset name and DCB information: LRECL=4160, BLKSIZE=4160, and RECFM=FBS.
Rerun the program.

Generating a System Dump in an CICS Run-Time Environment

Under CICS, a system dump provides the most useful information for diagnosing problems. To generate a system dump in a CICS run-time environment complete the following steps:

Specify run-time options TERMTHDACT(UAONLY, UADUMP, UATRACE, or UAIMM), and TRAP(ON). If you specify the suboption UAIMM then you must set TRAP(ON,NOSPIE). The TERMTHDACT suboption determines the level of detail of the Language Environment formatted dump.

Update the transaction dump table with the CICS supplied CEMT command,

CEMT SET TRD(40XX) SYS ADD

A sample CEMT output is shown:

STATUS:  RESULTS - OVERTYPE TO MODIFY
Trd(4088)  Sys      Loc Max( 999 )  Cur(0000)

Rerun the program.

If you have a Language Environment U4038 abend, CICS will not generate a system dump. In order to generate diagnostic information you must create a Language Environment U4039 abend by performing the following steps:

Specify DUMP=YES in CICS DFHSIT
Relink your program by including CEEUOPT. CEEUOPT cannot be used by OS/VS COBOL or non-Language Environment assembler.
Take CEECOPT from SCEESAMP and modify the Language Environment run-time options TERMTHDACT(UAONLY, UATRACE, or UADUMP), ABTERM(ABEND), and TRAP(ON). By setting these run-time options a Language Environment U4039 abend occurs which generates a system dump.
Rerun the program

Generating a System Dump in an OS/390 UNIX Shell

To generate a system dump from the OS/390 UNIX shell complete the following steps:

Specify where to write the system dump
- To write the system dump to an OS/390 dataset, issue the command:
```
export _BPXK_MDUMP=filename
```
  where filename is a fully qualified OS/390 dataset name with DCB information, LRECL=4160, BLKSIZE=4160, and RECFM=FBS, e.g.
```
export _BPXK_MDUMP=hlq.mydump
```
- To write the system dump to an HFS file, issue the command:
```
export _BPXK_MDUMP=filename
```
  where filename is a fully qualified HFS filename, e.g.
```
export _BPXK_MDUMP=/tmp/mydump.dmp
```
Specify Language Environment run-time options:
```
export _CEE_RUNOPTS="termthdact(suboption)"
```
where suboption =UAONLY, UADUMP, UATRACE, or UAIMM. If UAIMM is set, TRAP(ON,NOSPIE) must also be set. The TERMTHDACT suboption determines the level of detail of the Language Environment formatted dump.
Rerun the program.
The system dump is written to the dataset name or HFS filename specified.
See UNIX System Services Command Reference for additional BPXK_MDUMP information.

You can also specify the signal, SIGDUMP on the kill command to generate a system dump of the user address space. See UNIX System Services Command Reference for more information regarding the SIGDUMP signal.