In earlier releases of CICS®, DFH0STAT was supplied in source form only, with supporting
subroutines in assembler. Although the main programs are still written in
COBOL and supplied in source form in the CICSTS31.CICS.SDFHSAMP library, it is
now also supplied in pregenerated form in CICSTS31.CICS.SDFHLOAD.
There are also HTML versions of the BMS maps supplied with the sample application,
to enable you to run the STAT transaction using the CICS Web interface.
The sample statistics program consists of the following components, all
of which are defined in the CSD group DFH$STAT:
- COBOL programs
- There are eight COBOL programs:
- DFH0STAT
- This is the main program, which handles all BMS screen input/output,
and the open and close of the JES SPOOL. It links to DFH0STLK, which controls
all the other routines.
- DFH0STLK
- This COBOL module is called from DFH0STAT. DFH0STLK performs the following
functions:
- Initializes the page numbers
- Links to DFH0STSY.
- Links to DFH0STTP.
- Links to DFH0STPR.
- Links to DFH0STEJ.
- Links to DFH0STDB.
- Links to DFH0STGN.
- Prints the page index if selected.
- DFH0STSY
- This COBOL module is called from DFH0STLK to print system status and
the collected statistics for:
- Transaction manager
- Dispatcher
- Dispatcher MVS™ TCBs
- Storage analysis (DSAs)
- Loader (global)
- DFH0STTP
- This COBOL module is called from DFH0STLK to print the collected statistics
for:
- Transaction classes
- Transactions
- Programs (and programs by DSA and LPA)
- Temporary storage (global)
- Temporary storage main -- storage subpools
- Temporary storage models
- Temporary storage queues
- Transient data (global and resource)
- DFH0STPR
- This COBOL module is called from DFH0STLK to print the collected statistics
for:
- Journalnames
- Logstreams (global)
- Logstreams
- Program autoinstall
- Terminal autoinstall and VTAM®
- Connections and modenames
- TCP/IP
- TCP/IP services
URIMAP resource definitions
Virtual hosts
PIPELINE resources
WEBSERVICE resources
Document templates
- DFH0STEJ
- This COBOL module is called from DFH0STLK to print the collected statistics
for:
- The JVM pool and shared class cache
- JVMs
- JVM profiles
- JVM programs
- EJB system data sets
- CorbaServers and DJARs
- DJARs and enterprise beans
- Requestmodels
- DFH0STDB
- This COBOL module is called from DFH0STLK to print the collected statistics
for:
- Files
- Data set names
- Data tables
- DB2® connection
- DB2 entries
- LSRpools
- DFH0STGN
- This COBOL module is called from DFH0STLK to print the collected statistics
for:
- User exit programs
- Global user exits
Trace settings and levels
- Enqueue manager
- Enqueue models
- Recovery manager
- DFH0STCM
- The communications area (COMMAREA) used for communication between all
the COBOL programs in the DFH0STAT suite.
- DFH$STAS
- The assembler language subroutine called by the COBOL module DFH0STSY.
- DFH$STCN
- The assembler language subroutine called by six COBOL modules: DFH0STDB,
DFH0STEJ, DFH0STGN, DFH0STPR, DFH0STSY, and DFH0STTP.
- DFH$STTB
- The assembler language table of global user exit names, loaded by the
COBOL module DFH0STGN.
- DFH0STM
- This is the name of one of the map set source files supplied in SDFHSAMP,
and also the name of one of the physical mapsets, used by STAT transaction
in program DFH0STAT, supplied in SDFHLOAD.
- DFH0STS
- This is the name of one of the map set source files supplied in SDFHSAMP,
and also the name of one of the physical mapsets, used by STAT transaction
in program DFH0STAT, supplied in SDFHLOAD.
- DFH0STMU
- This is the name of the HTML version of the map set DFH0STM, supplied
in SDFHSAMP.
- DFH0STSU
- This is the name of the HTML version of the map set DFH0STS, supplied
in SDFHSAMP.
- STAT
- The transaction that invokes DFH0STAT.
Note:
The DFH$STAT CSD group also defines programs DFH$STED
and DFH$STER, but these are not part of the DFH0STAT sample application.
The sample program can be invoked as follows:
- As a program list table post-initialization (PLTPI) program, after the
DFHDELIM statement.
- As a program list table shut-down (PLTSD) program, before the DFHDELIM
statement.
- As a conversational transaction from a CICS terminal
- From a console
- As a started transaction using the EXEC CICS START command from a user-written application
program
- By a distributed program link request to DFH0STAT from a user-written
application program
To enable you to run the pregenerated sample statistics program from a CICS terminal, ensure SPOOL=YES is specified as a system initialization parameter for the CICS region. All
the required executable code and map sets are supplied ready for use in CICSTS31.CICS.SDFHLOAD.
To customize the sample statistics application programs:
- You can use the pregenerated map sets. The following map objects are supplied:
- Physical map sets, as load modules in CICSTS31.CICS.SDFHLOAD, which you can
use unchanged.
- Symbolic map sets, named DFH0STMD and DFH0STSD, for use as COBOL copybooks
in DFH0STAT to enable you to recompile the sample program. These are supplied
in CICSTS31.CICS.SDFHSAMP.
- Map set source macros DFH0STM and DFH0STS, in CICSTS31.CICS.SDFHSAMP, that
you can modify if you decide to customize the maps as well as the sample application
programs.
- HTML versions of the maps to enable you to run the sample application
using the CICS Web interface. For information on how to create and load the HTML
versions of the maps into a template data set, see the CICS Transaction Server for z/OS® Installation Guide. See also the sample data set creation job, DFHDEFDS, supplied
in SDFHINST.
- If your COBOL compiler does not have the integrated CICS translator,
first translate the customized COBOL program source code, using the translator
options COBOL3 and SP.
- Compile the translated output to produce object code.
- Link-edit the object module to produce a load module, which you store
in an application load library that is concatenated to the DFHRPL DD statement
of the CICS startup job stream.

[[ Contents Previous Page | Next Page Index ]]