IBM SC34-6814-04 - Manual (Page 711)

Chapter 26. The extended recovery facility overseer program
The information in this chapter is of interest only to users of the extended recovery
facility (XRF). Details of XRF are provided in the CICS/ESA 3.3 XRF Guide.
The XRF overseer program has two major functions:
v To display the current status of active and alternate CICS regions
v To restart failed CICS regions in place without operator intervention.
There is a CICS-supplied sample overseer program that performs these two
functions and which you may find adequate for your installation.
The chapter is divided into the following sections:
1. “The sample XRF overseer program” contains:
v “The functions of the sample program”
v “How the sample overseer program interfaces with CICS” on page 693
v “How to tell the overseer which actives and alternates to monitor” on page
693.
2. “The DFHWOSM macros” on page 695 describes the macros that you use to
provide services to the overseer program.
3. “Customizing the sample XRF overseer program” on page 703 describes how
you can extend the functions of the sample program.
The sample XRF overseer program
The CICS-supplied sample overseer is an assembler-language batch program that
runs in its own address space. The source of the sample program is in four
members of CICSTS32.CICS.SDFHSAMP:
v DFH$AXRO
v DFH$AGCB
v DFH$ADSP
v DFH$ARES.
The associated DSECTs are supplied in DFH$XRDS in the same library. An
assembled version of the sample program is supplied in
CICSTS32.CICS.SDFHAUTH.
The functions of the sample program
The program acts on five commands entered by the console operator. (Minimum
abbreviations are shown like this: D.) The commands are as follows:
Display
to display the current status of all active-alternate pairs being monitored by the
overseer program
Restart
to enable or disable the restart-in-place function of the overseer program
Snap
to take a snap dump of the sample program
© Copyright IBM Corp. 1977, 2011 689