How to request a SYSMDUMP under Language Environment

 
Option 1 - CEEOPTS DD & SYSMDUMP DD:
1) Specify the following Language Environment run-time options for the application (ex: via CEEOPTS DD card):

//CEEOPTS DD *
 ABTERMENC(ABEND),TERMTHDACT(UADUMP),TRAP(ON,SPIE)
/*

2) Include a SYSMDUMP DD card in the JCL specifying the following (where hlq.mydump is a dump data set name):

//SYSMDUMP DD DSN=hlq.mydump,DISP=(NEW,CATLG),
            UNIT=SYSDA,SPACE=(CYL,(250,250),RLSE),
            DCB=(LRECL=4160,RECFM=FBS,BLKSIZE=4160)

3) Rerun the program.
 

 
Option 2 - CEEOPTS DD including DYNDUMP:
1) Specify the following Language Environment run-time options for the application (ex: via CEEOPTS DD card) and include in the DYNDUMP run-time option (where hlq is is the high level qualifier for the dump data set to be created):

//CEEOPTS DD *
 ABTERMENC(ABEND),TERMTHDACT(UADUMP),TRAP(ON,SPIE),DYNDUMP(hlq,DYNAMIC,TDUMP)
/*

2) Rerun the program.
 

 
Additional notes:

• ABTERMENC run-time option is not available for a 64-bit environment.
• Ensure that your IEADMR00 Parmlib member reflects the following SDATA parameters:
  SDATA=(CSA,LPA,LSQA,RGN,SQA,SUM,SWA,TRT,ALLNUC,GRSQ)
• See "Methods available for specifying runtime options" for other ways to override run-time options.
• If a SYSMDUMP of only the original exception is desired, use TERMTHDACT(UAIMM) TRAP(ON,NOSPIE) sub-options instead.
   

 
Option 1 - CLER & CEMT

1) Set the following run-time options under CICS (ex: via CLER transaction)

  CLER                                                            CICS IYCLZCFE
                                                                               
               LANGUAGE ENVIRONMENT REGION LEVEL RUNTIME OPTIONS               
                                                                               
                                                                               
TYPE IN YOUR CHOICES.                                                          
                                                                               
RUNTIME OPTION     CHOICE      
TERMTHDACT    ==>  UADUMP        QUIET,MSG,TRACE,DUMP,UAONLY,UADUMP,UAIMM,UATRACE
TRAP          ==>  ON            ON, OFF         

2) Update the transaction dump table with the CICS-supplied CEMT command (this will produce a CICS system dump): 

CEMT SET TRD(40xx) SYS ADD

You will see CEMT output, for example:

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

3) Rerun the program.
 

 
Additional Notes:

• ABTERMENC run-time option is not available for a 64-bit environment.
• Because Language Environment never sets a SPIE or STAE in this environment, the TRAP(,SPIE|NOSPIE) sub-option is ignored under CICS.
• Using TERMTHDACT(UADUMP) in CICS can cause significant overhead in a production environment. See "Tuning with Language Environment" for notes on setting TERMTHDACT settings under CICS.
• If a Language Environment run-time option override (for example, ABTERMENC) is required and CLER does not provide a mechanism to modify it, refer to the CEEUOPT documentation for instructions on linking the override module with a High-Level Language (HLL) application.
• If a SYSMDUMP of only the original exception is desired, use TERMTHDACT(UAIMM) sub-option instead.
   

Option 1 - _CEE_RUNOPTS & _BPXK_MDUMP:
1) Specify the following Language Environment run-time options:

export _CEE_RUNOPTS="ABTERMENC(ABEND),TERMTHDACT(UADUMP),TRAP(ON,SPIE)"

2) Specify where to write the system dump:

To write the SYSMDUMP to a z/OS data set (where hlq.mydump is a fully qualified dataset specifying LRECL=4160, BLKSIZE=4160, and RECFM=FBS):

export _BPXK_MDUMP=hlq.mydump

To write the SYSMDUMP to an HFS file (where mydump.dmp is a fully qualified HFS filename):

export _BPXK_MDUMP=/tmp/mydump.dmp

3) Rerun the program.
 

 
Option 2 - _CEE_RUNOPTS including DYNDUMP:
1) Specify the following Language Environment run-time options (where hlq is is the high level qualifier for the dump data set to be created):

export _CEE_RUNOPTS="ABTERMENC(ABEND),TERMTHDACT(UADUMP),TRAP(ON,SPIE),DYNDUMP(hlq,DYNAMIC,TDUMP)"

2) Rerun the program.
 

Additional notes:

• ABTERMENC run-time option is not available for a 64-bit environment.
• Environment variables (ex: _CEE_RUNOPTS and _BPXK_MDUMP) can be set either directly in the shell (for the currently logged-in user's session only), or in that user's $HOME/.profile file (to make the settings persistent for that user across future logins).
• If a SYSMDUMP of only the original exception is desired, use TERMTHDACT(UAIMM) TRAP(ON,NOSPIE) sub-options instead.