dfhe5_utils_intro.html |
Last updated: Saturday, 15 June 2019Changes to CICS® utilities in CICS Transaction Server for z/OS®, Version 5 Release 2 relate to new, changed, or obsolete CICS functions. The existing utility programs DFHCSDUP, DFHSTUP, and DFH0STAT support new resources. The trace formatting utility program DFHTUxxx and IPCS dump exit routine DFHPDxxx support new resources and are renamed for the release.
Because of the removal of support for pooled JVMs in CICS TS for z/OS, Version 5.1, the CICS JVM Application Isolation Utility is no longer shipped with CICS. The CICS JVM Application Isolation Utility was a code analyzer tool to discover static variables in Java™ applications. It was provided to assist with moving Java workloads from resettable to continuous JVMs.
The CICS JVM Application Isolation Utility was shipped with CICS as a JAR file named dfhjaiu.jar. It ran under z/OS UNIX System Services as a stand-alone utility.
DFH0STAT, the sample statistics utility program, produces additional statistics reports for any new resource types that are added in each CICS release. Statistics reports relating to any obsolete resource types are no longer produced.
In CICS TS 5.2, no new statistics reports were added.
DFH0STAT does not report any private resources for applications deployed on platforms, and it does not identify programs that are declared as application entry points.
The Data Tables Storage report that is produced by DFH0STAT now includes storage totals for each data table in the report.
The Storage above 2 GB report that is produced by DFH0STAT now includes a number of new fields relating to 64-bit storage use in the GDSA.
The CSD utility program supports all the new and changed resource types and attributes. See Changes to resource definitions for details of all the changes to CSD resource definitions that are supported by DFHCSDUP.
If you are sharing the CSD with earlier releases of CICS and want to alter definitions that are used only on earlier releases, you must use the latest DFHCSDUP, even if some attributes are obsolete in the latest releases of CICS. To use the latest DFHCSDUP to update obsolete options on resource definitions, specify the COMPAT option in the PARM string to indicate that you want DFHCSDUP to operate in compatibility mode.
The report data sets produced by the LIST function of DFHCSDUP now include release information for the CSD. The field CREATED BY RELEASE shows the release in which the CSD was created. The field UPGRADED TO RELEASE, if present, indicates that the CSD has been upgraded and to what release.
A new utility, DFHCSVCU, is provided to install the CICS Type 3 SVC without the need to perform an IPL of the z/OS system. Use of this utility program must be restricted to authorized users only.
This utility updates or adds a single SVC entry in the SVC table with a pointer containing the entry point of the supplied module. For an existing SVC number, before the SVC is updated, all CICS regions using that SVC number must be shut down, otherwise results can be unpredictable.
The dump formatting utility program is renamed to DFHPD690. When formatting a dump data set always ensure that you use the dump formatting program with the same level number for the release of CICS TS that created the dump data set.
The dump exit routine for formatting CICS system dumps formats the control blocks for the new domains. To select or ignore dump data for any domains, specify the dump component keywords for those domains. The dump component keywords for use with the CICS IPCS dump exit routine are the same as the CETR trace component codes.
The message editing utility is obsolete in this release. This function is no longer available.
The statistics formatting utility program formats additional statistics reports for new and updated resource types. Statistics reports relating to obsolete resource types are no longer produced. See Changes to statistics for information about changes to resource types and new and obsolete keywords on the SELECT TYPE and IGNORE TYPE parameters.
DFHSTUP reports private resources for applications deployed on platforms, and identifies programs that are declared as application entry points.
The maximum number of CICS regions (APPLIDs) that the DFHSTUP utility can process is increased from 520 to 2000. This change provides the flexibility to include all CICS regions in a single statistics report.
The trace formatting utility program is renamed to DFHTU690. When formatting a dump data set always ensure that you use the dump formatting program with the same level number for the release of CICS TS that created the dump data set.
The program formats trace entries written by the new domains and functions. The new identifiers that you can specify to DFHTU690 on the TYPETR parameter for these functional areas are the same as the CETR trace component codes.
Last updated: Saturday, 15 June 2019