System dump actions with messages DFHAP0001 and DFHSR0001
In the event of a program check or MVS abend in the AP domain or in a user application program, CICS may issue either message DFHAP0001 or DFHSR0001.
Message DFHSR0001 is issued by CICS only when storage protection
is active; that is, the system initialization parameter STGPROT=YES is
specified or allowed to default. CICS determines which of these messages
to issue depending on whether or not the program check or MVS abend
occurs in code running in user key.
- If the code had been running in user key at the time of the program check or MVS abend, CICS issues message DFHSR0001 and takes a system dump with dump code SR0001. Only application programs defined with EXECKEY(USER) run in user key.
- If the code had not been running in user key at the time of the program check or MVS abend, CICS issues message DFHAP0001 and takes a system dump with dump code AP0001.
So, if CICS storage protection is active, this mechanism enables
you to suppress the system dumps caused by errors in application programs,
while still allowing dumps caused by errors in CICS code to be taken.
To achieve this, use either a CEMT SET SYDUMPCODE or an EXEC CICS
SET SYSDUMPCODE command to suppress system dumps for system dumpcode
SR0001:
CEMT SET SYDUMPCODE(SR0001) ADD NOSYSDUMP
If storage protection is not active, the dumps may be suppressed by a suppression of dumpcode AP0001. Note, however, that this suppresses dumps for errors in both application and CICS code. The XDUREQ global user exit can be used to distinguish between AP0001 situations in application and nonapplication code.
You cannot control AP0001 and SR0001 system dumps by using the DUMP parameter of the TRANSACTION resource definition. The DUMP parameter of the TRANSACTION resource definition controls only transaction dumps.
Usually, program checks, or MVS abends caused by an application
program, are also followed by an ASRA, ASRB or ASRD transaction abend
and a transaction dump. If, in some instances, you want the SDUMP
for one of these transaction abends but not the other, specify the
one you want by using either a CEMT TRDUMPCODE or an EXEC CICS TRANDUMPCODE
command. For example, specifying:
CEMT SET TRDUMPCODE(ASRB) ADD SYSDUMP
adds
an entry to the dump table and ensures that SDUMPs are taken for ASRB
abends. However, note that the SDUMP in this instance is taken at
a later point than the SDUMP normally taken for system dump code AP0001
or SR0001.