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.6 6.1 6.2 CICS TS 6.3
 

DFH0STAT

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

Table 3 through Table 16 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.6 6.1 6.2 CICS TS 6.3
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 - Data Tables Storage report
5.6 6.1 6.2 CICS TS 6.3
  NEW FIELDS:
  • Entries + Index - Storage Allocated
  • Entries + Index - Storage In-Use
REMOVED FIELDS:
  • Total - Storage Allocated
  • Total - Storage In-Use
    
Table 4. DFH0STAT - Db2 Entries report
5.6 6.1 6.2 CICS TS 6.3
  NEW FIELD:
  • DB2Entry Share Locks
    
Table 5. DFH0STAT - JVMSERVERs report
5.6 6.1 6.2 CICS TS 6.3
  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 6. DFH0STAT - Security report
5.6 6.1 6.2 CICS TS 6.3
    NEW FIELDS:
  • Failed authorizations NOLOG NOTAUTH
  • Failed authorizations NOLOG NOTFND
  
Table 7. DFH0STAT - Storage above 16 MB (31-bit storage) report
5.6 6.1 6.2 CICS TS 6.3
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 8. DFH0STAT - Storage above 2 GB (64-bit storage) report
5.6 6.1 6.2 CICS TS 6.3
  REMOVED FIELDS:
  • MEMLIMIT minus allocated to Private Memory Objects
  • MEMLIMIT minus usable within Private Memory Objects
    
Table 9. DFH0STAT - Storage below 16 MB (24-bit storage) report
5.6 6.1 6.2 CICS TS 6.3
  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 10. DFH0STAT - System status report
5.6 6.1 6.2 CICS TS 6.3
NEW FIELDS added to Monitoring section:
  • Frequency
  • MCT program name
      
Table 11. DFH0STAT - TCP/IP report
5.6 6.1 6.2 CICS TS 6.3
  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 12. DFH0STAT - TCP/IP services report
5.6 6.1 6.2 CICS TS 6.3
NEW FIELD:
  • TCPIPSERVICE OPTIONSPGM
      
Table 13. DFH0STAT - Temporary Storage report
5.6 6.1 6.2 CICS TS 6.3
  NEW FIELDS:
  • Current auxiliary storage usage %
  • Peak auxiliary storage usage %
    
Table 14. DFH0STAT - Transactions report
5.6 6.1 6.2 CICS TS 6.3
  NEW FIELD:
  • Purge Count
    
Table 15. DFH0STAT - Transaction Classes report
5.6 6.1 6.2 CICS TS 6.3
  NEW FIELD:
  • Last at Max Act
 NEW FIELD:
  • Purge A (Purge action)
  
Table 16. DFH0STAT - User region, extended user region and MEMLIMIT storage monitoring report
5.6 6.1 6.2 CICS TS 6.3
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 17 summarizes changes to DFHEISUP, Load module scanner by release of CICS TS.

Table 17. Changes to DFHEISUP by release
5.6 6.1 6.2 CICS TS 6.3
  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 18 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 18.

Table 18. Changes to DFHPDxxx by release
5.6 6.1 6.2 CICS TS 6.3
CHANGED:

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

      

DFHSTUP

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

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

Table 19. Changes to the DFHSTUP utility and introduction of new types of statistics, by release
5.6 6.1 6.2 CICS TS 6.3
NEW TYPE:
  • Security domain
      
CHANGED:

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

      
Table 20. DFHSTUP - CICS Db2 statistics
5.6 6.1 6.2 CICS TS 6.3
  CICS Db2® resource statistics
NEW FIELD:
  • Share Locks
    
       
Table 21. DFHSTUP - Cipher statistics
5.6 6.1 6.2 CICS TS 6.3
  Resource statistics
NEW FIELDS:
  • Number
  • TLS Inbound
  • TLS Outbound
  • AT-TLS Inbound
  • AT-TLS Outbound
    
Table 22. DFHSTUP - ISC/IRC system and mode entry statistics
5.6 6.1 6.2 CICS TS 6.3
       
Table 23. DFHSTUP - JVM server statistics
5.6 6.1 6.2 CICS TS 6.3
  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 24. DFHSTUP - Monitoring domain statistics
5.6 6.1 6.2 CICS TS 6.3
Global statistics
NEW FIELDS:
  • RMI Option
  • Application naming
  • MCT program name
  • Frequency
      
Table 25. DFHSTUP - Security domain statistics
5.6 6.1 6.2 CICS TS 6.3
    Global statistics
NEW FIELDS:
  • Failed authorizations NOLOG NOTAUTH
  • Failed authorizations NOLOG NOTFND
  
Table 26. DFHSTUP - Storage manager statistics
5.6 6.1 6.2 CICS TS 6.3
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 27. DFHSTUP - Temporary storage statistics
5.6 6.1 6.2 CICS TS 6.3
  Global statistics
NEW FIELDS:
  • Current aux. temp storage usage %
  • Peak aux. temp storage usage %
    
Table 28. DFHSTUP - TCP/IP global statistics
5.6 6.1 6.2 CICS TS 6.3
  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 29. DFHSTUP - TCP/IP services resource statistics
5.6 6.1 6.2 CICS TS 6.3
NEW FIELD:
  • TCPIPSERVICE OPTIONSPGM
      
Table 30. DFHSTUP - Transaction class (TCLASS) statistics
5.6 6.1 6.2 CICS TS 6.3
  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 31. DFHSTUP - Transaction statistics
5.6 6.1 6.2 CICS TS 6.3
  Transactions resource statistics
NEW FIELD:
  • Purge Count
    
Table 32. DFHSTUP - User domain statistics
5.6 6.1 6.2 CICS TS 6.3
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