The DFH0STXD sample program

The DFH0STXD sample extract program produces a basic report from the CICS statistics records for installed CICS resources. Each print line displays details for the resource listed including the resource type, the define source and the installation signature.

The DFH0STXD sample program can be customized (see Using the extract statistics reporting function for guidance).

The existing record selection capabilities of the statistics utility program, such as, applid, date and time, apply automatically to the DFH0STXD reports, in addition to the installed resource statistics reports.

You have the option in the design of the user program to write the statistics data to a data set to be used as input to a database, such as DB2®, or to a reporting tool such as z/OS DFSORT's ICETOOL utility.

The source code for DFH0STXD is supplied in the CICSTS54.CICS.SDFHSAMP library. It is also supplied in compiled form in CICSTS54.CICS.SDFHLOAD.

The JCL and DFHSTUP control statements required to invoke DFH0STXD are:

//STXDRPT  DD SYSOUT=x
EXTRACT USERPROGRAM=DFH0STXD

The following example shows these control statements:

//xxxxxxxx JOB (job accounting)
//stepname EXEC PGM=DFHSTUP,REGION=0M
//STEPLIB  DD DSN=....
//         DD DSN=....
//DFHSTATS DD DSN=....
//SYSPRINT DD SYSOUT=x
//SYSOUT   DD SYSOUT=x
//STXDRPT  DD SYSOUT=x
//DFHPRINT DD SYSOUT=x
//SYSIN DD *
SELECT APPLID=(xxxxxxxx)
SELECT TYPE=(yyyyyyy)
EXTRACT USERPROGRAM=DFH0STXD
COLLECTION TYPE=ALL
SUMMARY
/*
//

A sample extract from the DFH0STXD report using the following control statements is shown here:

SELECT APPLID=(IYK0AS)
SELECT TYPE=(LIBRARY)
EXTRACT USERPROGRAM=DFH0STXD
COLLECTION TYPE=ALL
SUMMARY

Figure 1. Sample output from DFHSTUP using the DFH0STXD sample extract program

CICS 6.6.0 Statistics Resource Definition Reporter                     Report Date 03/31/2008   Report Time 14:56:52   Page     1
____________________________________________________________________________________________________________________________________
 <- Statistics Record  ->          Resource                                      Define    <---------- Install Signature ----------->
    Date      Time   Type Applid     Type       Resource ID                      Source    Agent           Date      Time     Userid
____________________________________________________________________________________________________________________________________
 03/31/2008 14:21:44  REQ IYK0AS   LIBRARY      DFHRPL                           SYSTEM    SYSTEM       03/31/2008 12:03:48  ASTEWAR
 03/31/2008 14:21:44  REQ IYK0AS   LIBRARY      BOB                              NEWTEST   GRPLIST      03/31/2008 12:03:52  CICSUSER
 03/31/2008 14:21:44  REQ IYK0AS   LIBRARY      ALLIB                            LIBGRP    GRPLIST      03/31/2008 12:03:52  CICSUSER
 03/31/2008 14:21:44  REQ IYK0AS   LIBRARY      BIGBANG                          LIBGRP    GRPLIST      03/31/2008 12:03:52  CICSUSER
 03/31/2008 14:21:44  REQ IYK0AS   LIBRARY      ALIB1                            TESTLIB   GRPLIST      03/31/2008 12:03:52  CICSUSER
 03/31/2008 14:21:44  REQ IYK0AS   LIBRARY      ALIB11                           TESTLIB   GRPLIST      03/31/2008 12:03:52  CICSUSER
 03/31/2008 14:21:44  REQ IYK0AS   LIBRARY      ALIB12                           TESTLIB   GRPLIST      03/31/2008 12:03:52  CICSUSER
 03/31/2008 14:21:44  REQ IYK0AS   LIBRARY      ALIB2                            TESTLIB   GRPLIST      03/31/2008 12:03:52  CICSUSER
 03/31/2008 14:21:44  REQ IYK0AS   LIBRARY      BLIB1                            TESTLIB   GRPLIST      03/31/2008 12:03:52  CICSUSER
 03/31/2008 14:21:44  REQ IYK0AS   LIBRARY      BLIB11                           TESTLIB   GRPLIST      03/31/2008 12:03:52  CICSUSER

CICS 6.6.0 Statistics Resource Definition Reporter                     Report Date 03/31/2008   Report Time 14:56:52   Page     2
____________________________________________________________________________________________________________________________________