Changes to CICS utilities

This section summarizes the changes to the CICS®-supplied utilities across supported CICS releases. Use this information to plan the impact of upgrading from one release to another.

If you are upgrading from an end-of-service release, you can find information about the changes that are relevant to those releases in Summary of changes from end-of-service releases.

Highlights of changes across supported releases of CICS TS

Table 1 lists changed utilities in each supported CICS TS release. The links take you to the relevant tables that describe changes to specific utilities by release.

Note: Dump utilities DFHDUxxx and DFHPDxxx and the CICS trace utility print program DFHTUxxx are renamed with a new release identifier every release, so they are not specifically listed in Table 1 unless they have other functional changes.
Table 1. Highlights of changed CICS utilities across supported CICS TS releases
5.5 5.6 6.1 6.2

DFH0STAT

Table 2 describes changes to the utility itself and introduction of new reports by release of CICS TS.

Table 3 through Table 18 summarize changes by report, across supported releases of CICS TS.

Table 2. Changes to the DFH0STAT utility and introduction of new reports, by release
5.5 5.6 6.1 6.2
CHANGED:

DFH0STAT reports on the local system entry.

 NEW REPORTS:

User report

Security report

MVS™ user region and extended user region storage report

 NEW REPORT:

Policy report

 CHANGED:

User region, extended user region and MEMLIMIT storage monitoring report is renamed from MVS user region and extended user region storage report.
Table 3. DFH0STAT - Connections and Modenames report
5.5 5.6 6.1 6.2
New field:
  • Peak aids in chain
      
Table 4. DFH0STAT - Data Tables Storage report
5.5 5.6 6.1 6.2
    New fields:
  • Entries + Index - Storage Allocated
  • Entries + Index - Storage In-Use
Removed fields:
  • Total - Storage Allocated
  • Total - Storage In-Use
  
Table 5. DFH0STAT - Db2 Connection report
5.5 5.6 6.1 6.2
New field:
  • Current® number of connections with pthreads
      
Table 6. DFH0STAT - Db2 Entries report
5.5 5.6 6.1 6.2
    New field:
  • DB2Entry Share Locks
  
Table 7. DFH0STAT - JVMSERVERs report
5.5 5.6 6.1 6.2
    New fields:
  • JVMSERVER code cache memory used
  • JVMSERVER code cache memory alloc
  • JVMSERVER data cache memory used
  • JVMSERVER data cache memory alloc
  • JVMSERVER class storage memory used
  • JVMSERVER class storage memory alloc
  • JVMSERVER classcache size
  • JVMSERVER classcache free
  
Table 8. DFH0STAT - Security report
5.5 5.6 6.1 6.2
      New fields:
  • Failed authorizations NOLOG NOTAUTH
  • Failed authorizations NOLOG NOTFND
Table 9. DFH0STAT - Storage above 16 MB (31-bit storage) report
5.5 5.6 6.1 6.2
  New fields: None New fields:
  • User Region limit established
  • Current User Region storage unallocated
  • Current free storage above User Region limit
  
  Changed fields: None Changed fields:
  • Private Area size above 16MB: the field name is changed from Private Area Region size above 16MB
  • Peak LSQA/SWA storage allocated: the field name is changed from Max LSQA/SWA storage allocated above 16MB (SYS), and its field description is updated accordingly.
  • Peak User Region storage allocated: the field name is changed from Max User storage allocated above 16MB (EXT), and its field description is updated accordingly.
  
  Removed fields:
  • Requests for MVS storage causing waits
  • Total time waiting for MVS storage
 Removed fields:
  • Private Area Storage available above 16MB
  
Table 10. DFH0STAT - Storage above 2 GB (64-bit storage) report
5.5 5.6 6.1 6.2
    Removed fields:
  • MEMLIMIT minus allocated to Private Memory Objects
  • MEMLIMIT minus usable within Private Memory Objects
  
Table 11. DFH0STAT - Storage below 16 MB (24-bit storage) report
5.5 5.6 6.1 6.2
    New fields:
  • User Region limit established
  • Current User Region storage unallocated
  • Current free storage above User Region limit
  
    Changed fields:
  • Private Area size below 16MB: the field name is changed from Private Area Region size below 16MB.
  • Peak LSQA/SWA storage allocated (SYS): the field name is changed from Max LSQA/SWA storage allocated below 16MB (SYS), and its field description is updated accordingly.
  • Peak User Region storage allocated (VIRT): the field name is changed from Max User storage allocated below 16MB (VIRT), and its field description is updated accordingly.
  
    Removed fields:
  • Private Area Storage available below 16MB
  • Region size established from REGION= parameter
  • RTM
  • System Use
  
Table 12. DFH0STAT - System status report
5.5 5.6 6.1 6.2
  New fields added to Monitoring section:
  • Frequency
  • MCT program name
    
Table 13. DFH0STAT - TCP/IP report
5.5 5.6 6.1 6.2
    New fields:
  • Maximum parallel TLS handshakes
  • Current parallel TLS handshakes
  • Peak parallel TLS handshakes
  • Maximum waiting TLS handshakes
  • Current waiting TLS handshakes
  • Peak waiting TLS handshakes
  • Inbound: TLS 1.1
  • Inbound: TLS 1.2
  • Inbound: TLS 1.3
  • Inbound: Total
  • Outbound: TLS 1.1
  • Outbound: TLS 1.2
  • Outbound: TLS 1.3
  • Outbound: Total
  • Inbound: AT-TLS SSL 3
  • Inbound: AT-TLS 1.0
  • Inbound: AT-TLS 1.1
  • Inbound: AT-TLS 1.2
  • Inbound: AT-TLS 1.3
  • Outbound: AT-TLS SSL 3
  • Outbound: AT-TLS 1.0
  • Outbound: AT-TLS 1.1
  • Outbound: AT-TLS 1.2
  • Outbound: AT-TLS 1.3
  
    Changed fields:
  • Current number of outbound sockets: Its source field is changed to SOG-CURR-OUTB-SOCKETS.
  • Peak number of outbound sockets: Its source field is changed to SOG-PEAK-OUTB-SOCKETS.
  
    Removed fields:
  • SOG-CURR-PERS-OUTB-SOCKETS
  • SOG-PEAK-BOTH-OUTB-SOCKETS
  • SOG-PEAK-PERS-OUTB-SOCKETS
  • SOG-PERS-OUTBOUND-CREATED
  
Table 14. DFH0STAT - TCP/IP services report
5.5 5.6 6.1 6.2
  New field:
  • TCPIPSERVICE OPTIONSPGM
    
Table 15. DFH0STAT - Temporary Storage report
5.5 5.6 6.1 6.2
    New fields:
  • Current auxiliary storage usage %
  • Peak auxiliary storage usage %
  
Table 16. DFH0STAT - Transactions report
5.5 5.6 6.1 6.2
    New field:
  • Purge Count
  
Table 17. DFH0STAT - Transaction Classes report
5.5 5.6 6.1 6.2
    New field:
  • Last at Max Act
 New field:
  • Purge A (Purge action)
Table 18. DFH0STAT - User region, extended user region and MEMLIMIT storage monitoring report
5.5 5.6 6.1 6.2
  NEW REPORT with report name MVS user region and extended user region storage report   CHANGED:

Renamed to User region, extended user region and MEMLIMIT storage monitoring report.

NEW:

Reports on z/OS® MEMLIMIT storage in the 64-bit addressing range, under the heading MEMLIMIT.
      New fields:
  • SOS duration
  • Times SOS

DFHEISUP

Table 19 summarizes changes to DFHEISUP, Load module scanner by release of CICS TS.

Table 19. Changes to DFHEISUP by release
5.5 5.6 6.1 6.2
    CHANGED: DFHEISUP is changed to be RMODE(ANY) instead of RMODE(24). This change allows DFHEISUP to use 31-bit virtual storage (above 16 MB but below 2 GB).  

Dump utilities DFHPDxxx

Table 20 summarizes changes to the Dump utilities DFHPDxxx by release of CICS TS.

Dump utilities DFHPDxxx are renamed with new release identifier every release, so this is not specifically stated again in Table 20.

Table 20. Changes to DFHPDxxx by release
5.5 5.6 6.1 6.2
  CHANGED:

The TRS KE_NUM parameter enhanced to format out the most recent trace entries information for the specified task.

    

DFHSTUP

Table 21 describe changes to the utility itself (for example, control parameters) and introduction of new types of statistics by release of CICS TS.

Table 22 through Table 34 summarize changes by type of statistics, across supported releases of CICS TS. The DFHSTUP name is used to identify statistic fields.

Table 21. Changes to the DFHSTUP utility and introduction of new types of statistics, by release
5.5 5.6 6.1 6.2
NEW TYPE: None NEW TYPE:
  • Security domain
    
CHANGED:

DFHSTUP reports on the local system entry.

 CHANGED:

New option SECURITY added to SELECT TYPE and IGNORE TYPE control parameters.

    
Table 22. DFHSTUP - CICS Db2 statistics
5.5 5.6 6.1 6.2
    CICS Db2® resource statistics
New field:
  • Share Locks
  
CICS Db2 global statistics
New field:
  • Current conn owned by protected threads
      
Table 23. DFHSTUP - Cipher statistics
5.5 5.6 6.1 6.2
    Resource statistics
New fields:
  • Number
  • TLS Inbound
  • TLS Outbound
  • AT-TLS Inbound
  • AT-TLS Outbound
  
Table 24. DFHSTUP - ISC/IRC system and mode entry statistics
5.5 5.6 6.1 6.2
ISC/IRC system entry resource statistics
New field:
  • Peak aids in chain
      
Table 25. DFHSTUP - JVM server statistics
5.5 5.6 6.1 6.2
    JVMSERVER resource statistics
New fields:
  • JVMSERVER code cache memory used
  • JVMSERVER code cache memory alloc
  • JVMSERVER data cache memory used
  • JVMSERVER data cache memory alloc
  • JVMSERVER class storage mem used
  • JVMSERVER class storage mem alloc
  • JVMSERVER classcache size
  • JVMSERVER classcache free
  
Table 26. DFHSTUP - Monitoring domain statistics
5.5 5.6 6.1 6.2
Global statistics
New fields:
  • Urimap Resource Limit
  • Webservice Resource Limit
 Global statistics
New fields:
  • RMI Option
  • Application naming
  • MCT program name
  • Frequency
    
Table 27. DFHSTUP - Security domain statistics
5.5 5.6 6.1 6.2
      Global statistics
New fields:
  • Failed authorizations NOLOG NOTAUTH
  • Failed authorizations NOLOG NOTFND
Table 28. DFHSTUP - Storage manager statistics
5.5 5.6 6.1 6.2
  Storage manager global statistics
New fields for user region and extended user region storage:
  • Last monitor sample time
  • The following fields are reported for user region (24-bit) storage and extended user region (31-bit) storage respectively.
  • State
  • Current unallocated total
  • LWM unallocated total
  • Current unallocated largest contiguous area
  • LWM unallocated largest contiguous area
  • Last date and time SOS
  • Time tasks waited because SOS
  • Current tasks waiting because SOS
  • Peak tasks waiting because SOS
  • Total waits because SOS
   Storage manager global statistics
New fields for user region storage and extended user region storage:
  • SOS duration
  • Times SOS
NEW: Reports on z/OS MEMLIMIT storage in the 64-bit addressing range, under the heading MEMLIMIT:
  • State
  • Current unallocated
  • LWM unallocated
  • Last date and time SOS
  • SOS duration
  • Times SOS

CHANGED: The report name is changed to User region, extended user region and MEMLIMIT storage monitoring from MVS user region and extended user region storage.
Table 29. DFHSTUP - Temporary storage statistics
5.5 5.6 6.1 6.2
    Global statistics
New fields:
  • Current aux. temp storage usage %
  • Peak aux. temp storage usage %
  
Table 30. DFHSTUP - TCP/IP global statistics
5.5 5.6 6.1 6.2
    New fields:
  • Maximum parallel TLS handshakes
  • Current parallel TLS handshakes
  • Peak parallel TLS handshakes
  • Maximum waiting TLS handshakes
  • Current waiting TLS handshakes
  • Peak waiting TLS handshakes
  • Inbound: TLS 1.1
  • Inbound: TLS 1.2
  • Inbound: TLS 1.3
  • Inbound: Total
  • Outbound: TLS 1.1
  • Outbound: TLS 1.2
  • Outbound: TLS 1.3
  • Outbound: Total
  • Inbound: AT-TLS SSL 3
  • Inbound: AT-TLS 1.0
  • Inbound: AT-TLS 1.1
  • Inbound: AT-TLS 1.2
  • Inbound: AT-TLS 1.3
  • Outbound: AT-TLS SSL 3
  • Outbound: AT-TLS 1.0
  • Outbound: AT-TLS 1.1
  • Outbound: AT-TLS 1.2
  • Outbound: AT-TLS 1.3
  • Inbound: Full
  • Inbound: Abbreviated
  • Outbound: Full
  • Outbound: Abbreviated
  
    Changed fields:
  • SOG_CURR_OUTB_SOCKETS: Its DFHSTUP name is changed to Current number of outbound sockets.
  • SOG_PEAK_OUTB_SOCKETS: Its DFHSTUP name is changed to Peak number of outbound sockets.
 
    Removed fields:
  • SOG_CURR_PERS_OUTB_SOCKETS
  • SOG_PEAK_BOTH_OUTB_SOCKETS
  • SOG_PEAK_PERS_OUTB_SOCKETS
  • SOG_PERS_OUTBOUND_CREATED
  
Table 31. DFHSTUP - TCP/IP services resource statistics
5.5 5.6 6.1 6.2
  New field:
  • TCPIPSERVICE OPTIONSPGM
    
Table 32. DFHSTUP - Transaction class (TCLASS) statistics
5.5 5.6 6.1 6.2
    Transaction class resource statistics
New field:
  • Last at MaxAct
Transaction class resource statistics
New field:
  • Purge A (Purge action)
   

Transaction class summary resource statistics

New fields:
  • First at Max Act
  • Last at Max Act
  
Table 33. DFHSTUP - Transaction statistics
5.5 5.6 6.1 6.2
    Transactions resource statistics
New field:
  • Purge Count
  
Table 34. DFHSTUP - User domain statistics
5.5 5.6 6.1 6.2
  Global statistics
New fields:
  • Delete count due to sign off
  • Delete count due to ENF
  • Current instances in directory
  • Peak instances in directory
  • Current instances in timeout
  • Peak instances in timeout
  • ENF events matched
  • ENF events not matched