IHSROOT/bin/envvars
Add the environment variable _CEE_DMPTARG=directory e.g.,
export _CEE_DMPTARG=/tmp/dumpdir
Add the directive CoreDumpDirectory directory e.g.,
CoreDumpDirectory /tmp/dumpdir
[notice] Core file limit is 0; core dumps will be not be written
for server crashes
[notice] CoreDumpDirectory not set; core dumps may not be written for
child process crashes
The _CEE_DMPTARG
takes precedence over CoreDumpDirectory. If neither is used then
the dump may be located in:
The name of the dump is CEEDUMP (or the
name
specified in the FNAME option of CEE3DMP) suffixed with:
date.time.process ID. See CEEDUMP
for additional information.
To generate a system dump in a batch run-time environment complete the following steps:
//APACHSH JOB 'U=USER84=100',
// CLASS=A,MSGLEVEL=(1,1),TIME=(5),REGION=2M
//APACHE EXEC PGM=BPXBATCH,
// PARM='SH /u/USERX/bin/apachectl start'
//STDOUT DD PATH='/u/USERX/logs/stdout.txt',
// PATHOPTS=(OWRONLY,OCREAT,OTRUNC),PATHMODE=(SIRWXU,SIRWXG)
//STDERR DD PATH='/u/USERX/logs/stderr.txt',
// PATHOPTS=(OWRONLY,OCREAT,OTRUNC),PATHMODE=(SIRWXU,SIRWXG)
//STDENV DD PATH='/u/USERX/bin/stdenv.txt'
//SYSMDUMP DD DSNAME=SYS1.DUMP02,
// UNIT=SYSDA,VOLUME=SER=CPDLB1,
// DCB=(LRECL=4160,BLKSIZE=4160,RECFM=F),
// DISP=(SHR,KEEP,CATLG)
export _CEE_RUNOPTS=TER(UADUMP),ABTERMENC(ABEND)
More information about TERMTHDACT or the ABTERMENC run-time option
To generate a system dump from the OS/390 UNIX shell complete the following steps:
IHSROOT/bin/envvars
:
export _BPXK_MDUMP=filenamewhere 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
export _BPXK_MDUMP=filenamewhere filename is a fully qualified HFS filename, e.g.
export _BPXK_MDUMP=/tmp/mydump.dmp
IHSROOT/bin/envvars
: 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.
export _CEE_RUNOPTS=TER(UADUMP),ABTERMENC(ABEND)
More information about TERMTHDACT or the ABTERMENC run-time option
The system dump is written to the dataset name or HFS filename specified. See UNIX System Services Command Reference for additional BPXK_MDUMP information.
In addition to dumps, mod_backtrace and mod_whatkilledus can be used to obtain synopsis information in the error log.
Example of basic records in the error log for a SIGSEGV (without the
other diagnostic modules):
[Tue Dec 05 08:57:29 2006] [error] [client 9.37.242.127] mod_silly2:
process 438 thread 0A52AAE000000011 about to generate signal
Segmentation fault - 11
CEE3204S The system detected a protection exception (System Completion
Code=0C4).
CEE5203S The signal SIGSEGV was received.
From entry point
generate_sig at compile unit offset +000000000A7A470E at entry offset
+00000000000001E6
at address 000000000A7A470E.
[Tue Dec 05 08:57:43 2006] [notice] child pid 438 exit signal
Segmentation fault (11)