Information on DFH0STAT

The main programs for the sample statistics program DFH0STAT are written in COBOL and supplied in source form in the CICSTS51.CICS.SDFHSAMP library. DFH0STAT is also supplied in pregenerated form in CICSTS51.CICS.SDFHLOAD.

HTML versions of the BMS maps are supplied with the sample application, so that you can run the STAT transaction using CICS® Web support.

The components of DFH0STAT are all defined in the CSD group DFH$STAT. They include a number of COBOL modules and some additional components such as map sets. The DFH$STAT CSD group also defines programs DFH$STED and DFH$STER, but these are not part of the DFH0STAT sample application.

The following COBOL modules are components of the sample statistics program DFH0STAT:
DFH0STAT
This is the main COBOL 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 the other routines.
  • Prints the page index if selected.
DFH0STDB
This COBOL module is called from DFH0STLK to print the collected statistics for:
  • Files
  • Data set names
  • Data tables
  • DB2® connection
  • DB2 entries
  • LSRpool
  • WebSphere® MQ connection
DFH0STEJ
This COBOL module is called from DFH0STLK to print the collected statistics for:
  • JVMs
  • JVM programs
  • JVMSERVER resources
DFH0STEP
This COBOL module is called from DFH0STLK to print the collected statistics for:
  • Event processing
  • Event bindings
  • Capture specifications
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
DFH0STPR
This COBOL module is called from DFH0STLK to print the collected statistics for:
  • Journalnames
  • Logstreams
  • Program autoinstall
  • Terminal autoinstall and z/OS® Communications Server
  • Connections and modenames
  • TCP/IP
  • TCP/IP services
  • IPCONN resources
DFH0STSA
This COBOL module is called from DFH0STLK to print the collected statistics for:
  • Storage analysis (DSAs)
  • Loader
  • LIBRARY resources
  • LIBRARY data set concatenation
DFH0STSY
This COBOL module is called from DFH0STLK to print the collected statistics for:
  • System Status
  • Transaction manager
  • Dispatcher
  • Dispatcher MVS™ TCBs
DFH0STTP
This COBOL module is called from DFH0STLK to print the collected statistics for:
  • Transaction classes
  • Transactions
  • Program definitions
  • Programs (and programs by DSA and LPA)
  • DFHRPL and LIBRARY analysis
DFH0STTS
This COBOL module is called from DFH0STLK to print the collected statistics for:
  • Temporary storage
  • Temporary storage main — storage subpools
  • Temporary storage models
  • Temporary storage queues
  • Transient data
DFH0STWB
This COBOL module is called from DFH0STLK to print the collected statistics for:
  • BUNDLE resources
  • URIMAP resources
  • Virtual hosts
  • ATOMSERVICE resources
  • PIPELINE resources
  • WEBSERVICE resources
  • DOCTEMPLATE resources
  • XMLTRANSFORM resources
The additional components for DFH0STAT that are defined in the CSD group DFH$STAT are:
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 modules DFH0STSA and DFH0STSY.
DFH$STCN
The assembler language subroutine called by the other COBOL modules in the DFH0STAT suite.
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 map sets, 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 map sets, used by STAT transaction in program DFH0STAT, supplied in SDFHLOAD.
DFH0STMU
The HTML version of the map set DFH0STM, supplied in SDFHSAMP.
DFH0STSU
The HTML version of the map set DFH0STS, supplied in SDFHSAMP.
STAT
The transaction that invokes DFH0STAT.
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 CICSTS51.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 CICSTS51.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 CICSTS51.CICS.SDFHSAMP.
    • Map set source macros DFH0STM and DFH0STS, in CICSTS51.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 Creating the CICS data sets . 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.
Parent topic: The sample statistics program, DFH0STAT

dfht3_stats_0stat_reference.html | Timestamp icon Last updated: Thursday, 27 June 2019