The DURETRY system initialization parameter specifies,
in seconds, the total time that CICS is to continue trying to obtain a system
dump using the SDUMP macro.
- DURETRY={30|number-of-seconds|0}
- DURETRY allows you to control whether, and for how long, CICS is to reissue
the SDUMP macro if another address space in the same MVS system is already
taking an SDUMP when CICS issues an SDUMP request.
In the event of an
SDUMP failure, CICS responds, depending on the reason for the failure, as
follows:
- If MVS is already taking an SDUMP for another address space, and the DURETRY
parameter is nonzero, CICS issues an MVS STIMERM macro to wait for five seconds,
before retrying the SDUMP. CICS issues a message to say that it is waiting
for five seconds before retrying the SDUMP. After five seconds CICS issues
another message to say that it is retrying the SDUMP request.
- If the SDUMP fails for any other reason, such as no SYS1.DUMP data sets
being available, or I/O errors preventing completion of the dump, CICS issues
a message to inform you that the SDUMP has failed, and to give the reason
why.
- 30
- 30 seconds allows CICS to retry up to 6 times (once every 5 seconds),
if the cause of failure is that another region is taking an SDUMP.
- number-of-seconds
- Code the total number of seconds (up to 32767) during which you want CICS
to continue retrying the SDUMP macro if the reason for failure is that another
region is taking an SDUMP. CICS retries the SDUMP, once every five seconds,
until successful or until retries have been made over a period equal to or
greater than the DURETRY value.
- 0
- Code a zero value if you do not want CICS to retry the SDUMP macro.