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 DFHTUxxx Trace utility print program are renamed with new release identifier every release, so they are not specifically listed in Table 1 unless they have other functional changes.
Table 1. Highlights of CICS utilities changes across supported CICS TS releases
5.4 5.5 5.6 6.1

Changes to CICS utilities by release of CICS TS

View changes by utility.

DFH0STAT

Table 2 summarizes changes to DFH0STAT, CICS sample statistics program by release of CICS TS.

Table 2. Changes to DFH0STAT by release
5.4 5.5 5.6 6.1
NEW REPORT:

MQ monitors report

 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
TCP/IP report and TCP/IP services report

New fields added

 Connections and Modenames report
New field:
  • A14EAHWM Peak aids in chain
 TCP/IP services report
New field:
  • TCPIPSERVICE OPTIONSPGM
 TCP/IP report
New fields:
  • SOG-S8TLSHS-REQUESTS-MAX
  • SOG-S8TLSHS-REQUESTS-CUR
  • SOG-S8TLSHS-REQUESTS-PEAK
  • SOG-S8TLSHS-WAITERS-MAX
  • SOG-S8TLSHS-WAITERS-CUR
  • SOG-S8TLSHS-WAITERS-PEAK
  • SOG-TIMES-CICSTLS11-INB-USED
  • SOG-TIMES-CICSTLS12-INB-USED
  • SOG-TIMES-CICSTLS13-INB-USED
  • SOG-TIMES-CICSTLSALL-INB-USED
  • SOG-TIMES-CICSTLS11-OUTB-USED
  • SOG-TIMES-CICSTLS12-OUTB-USED
  • SOG-TIMES-CICSTLS13-OUTB-USED
  • SOG-TIMES-CICSTLSALL-OUTB-USED
  • SOG-TIMES-ATSSL3-INB-USED
  • SOG-TIMES-ATTLS10-INB-USED
  • SOG-TIMES-ATTLS11-INB-USED
  • SOG-TIMES-ATTLS12-INB-USED
  • SOG-TIMES-ATTLS13-INB-USED
  • SOG-TIMES-ATSSL3-OUTB-USED
  • SOG-TIMES-ATTLS10-OUTB-USED
  • SOG-TIMES-ATTLS11-OUTB-USED
  • SOG-TIMES-ATTLS12-OUTB-USED
  • SOG-TIMES-ATTLS13-OUTB-USED
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
  Db2® Connection report
New field:
  • D2G-TCB-PROTECTED-CURRENT Current number of connections with pthreads
 System status report
New fields added to Monitoring section:
  • Frequency
  • MCT program name
 Db2 Entries report
New field:
  • D2R-SHARELOCKS
    Storage above 16 MB report
Removed fields:
  • SMSMVSSTGREQWAITS
  • SMSTIMEWAITMVS
 Data Tables Storage report
New fields:
  • Entries + Index - Storage Allocated
  • Entries + Index - Storage In-Use
Removed fields:
  • Total - Storage Allocated
  • Total - Storage In-Use
      JVMSERVERs report
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
      Temporary Storage report
New fields:
  • TSGASU Current aux. temp storage usage %
  • TSGASUPK Peak aux. temp storage usage %
      Transactions report

New field XMR-PURGED-TRNCLS-THRESHOLD Purge Count
      Tranclass report

New field XMCGAMA Last at Max Act
      Storage below 16 MB (24-bit storage) report
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
      Storage above 16 MB (31-bit storage) report
New fields:
  • User Region limit established
  • Current User Region storage unallocated
  • Current free storage above User Region limit
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:
  • Private Area Storage available above 16MB
      Storage above 2 GB (64-bit storage) report
Removed fields:
  • MEMLIMIT minus allocated to Private Memory Objects
  • MEMLIMIT minus usable within Private Memory Objects

Back to Highlights of changes across releases

DFHEISUP

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

Table 3. Changes to DFHEISUP by release
5.4 5.5 5.6 6.1
    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).

Back to Highlights of changes across releases

DFHMNDUP

Table 4 summarizes changes to DFHMNDUP, Monitoring dictionary utility program by release of CICS TS.

Table 4. Changes to DFHMNDUP by release
5.4 5.5 5.6 6.1
CHANGED:

Specifying a 2 digit year on the DATE and JOBDATE control parameters now defines a date in the twenty-first century.

      

Back to Highlights of changes across releases

Dump utilities DFHPDxxx

Table 5 summarizes changes to 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 5.

Table 5. Changes to DFHPDxxx by release
5.4 5.5 5.6 6.1
CHANGED:

Changes to formatting of DFHMQINI CICS MQINI and EXCI dump

   CHANGED:

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

  

Back to Highlights of changes across releases

DFHSTUP

Table 6 summarizes changes to DFHSTUP, CICS statistics utility program by release of CICS TS.

Table 6. Changes to DFHSTUP by release
5.4 5.5 5.6 6.1
NEW TYPE:

IBM® MQ monitor

CHANGED:

New option MQMONITOR on SELECT TYPE and IGNORE TYPE control parameters

Specifying a 2 digit year on the DATE control parameter now defines a date in the twenty-first century.

 CHANGED:

DFHSTUP reports on the local system entry.

 NEW TYPE:

Security domain

CHANGED:

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

  
TCP/IP global and service statistics

New fields added

 CICS Db2 global statistics
New field:
  • D2G_TCB_PROTECTED_CURRENT Current number of connections with pthreads
 Dispatcher domain statistics

The CICS TCB Mode Statistics has been enhanced to print the QR TCB CPU Dispatch Ratio.

 Cipher statistics
New fields:
  • SOC_CIPHER
  • SOC_TIMES_CICSTLS_INB_USED
  • SOC_TIMES_CICSTLS_OUTB_USED
  • SOC_TIMES_ATTLS_INB_USED
  • SOC_TIMES_ATTLS_OUTB_USED
  ISC/IRC system entry resource statistics
New field:
  • A14EAHWM Peak aids in chain
 Monitoring domain statistics
New fields:
  • MNGRMI RMI Option
  • MNGAPPNS Application naming
  • MNGMCTNM MCT program name
  • MNGFREQ Frequency
 CICS Db2 resource statistics
New field:
  • D2R_SHARELOCKS
  Monitoring domain statistics
New fields:
  • MNGURIRL Urimap Resource Limit
  • MNGWEBRL Webservice Resource Limit
 Storage manager statistics
New fields added to global statistics, indicating user region and extended user region storage:
  • The time the MVS monitor system task last sampled MVS storage
  • State of the user region or the extended user region
  • The current total amount of unallocated storage
  • Low water mark of the total amount of unallocated storage
  • The size of the current largest contiguous storage area available in unallocated storage
  • Low water mark of the size of the largest contiguous storage area available in unallocated storage
  • The time the last SOS condition was detected
  • The time tasks waited because of the SOS or constrained state
  • The current, peak, and total number of tasks that are waiting because of the SOS or constrained state
 JVMSERVER resource statistics
New fields:
  • SJS_JVMSERVER_CODE_CACHE_USED
  • SJS_JVMSERVER_CODE_CACHE_ALLOC
  • SJS_JVMSERVER_DATA_CACHE_USED
  • SJS_JVMSERVER_DATA_CACHE_ALLOC
  • SJS_JVMSERVER_CLASS_STRG_USED
  • SJS_JVMSERVER_CLASS_STRG_ALLOC
  • SJS_JVMSERVER_CLASSCACHE_SIZE
  • SJS_JVMSERVER_CLASSCACHE_FREE
    TCP/IP resource statistics
New field:
  • Name of the HTTP OPTIONS handler program (OPTIONSPGM)
 TCP/IP global statistics
New fields showing TLS handshakes running in parallel:
  • SOG_S8TLSHS_REQUESTS_MAX
  • SOG_S8TLSHS_REQUESTS_CUR
  • SOG_S8TLSHS_REQUESTS_PEAK
New fields showing TLS handshakes in waiting:
  • SOG_S8TLSHS_WAITERS_MAX
  • SOG_S8TLSHS_WAITERS_CUR
  • SOG_S8TLSHS_WAITERS_PEAK
New fields showing TLS protocol handshakes:
  • SOG_TIMES_CICSTLS11_INB_USED
  • SOG_TIMES_CICSTLS12_INB_USED
  • SOG_TIMES_CICSTLS13_INB_USED
  • SOG_TIMES_CICSTLSALL_INB_USED
  • SOG_TIMES_CICSTLS11_OUTB_USED
  • SOG_TIMES_CICSTLS12_OUTB_USED
  • SOG_TIMES_CICSTLS13_OUTB_USED
  • SOG_TIMES_CICSTLSALL_OUTB_USED
  • SOG_TIMES_ATSSL3_INB_USED
  • SOG_TIMES_ATTLS10_INB_USED
  • SOG_TIMES_ATTLS11_INB_USED
  • SOG_TIMES_ATTLS12_INB_USED
  • SOG_TIMES_ATTLS13_INB_USED
  • SOG_TIMES_ATSSL3_OUTB_USED
  • SOG_TIMES_ATTLS10_OUTB_USED
  • SOG_TIMES_ATTLS11_OUTB_USED
  • SOG_TIMES_ATTLS12_OUTB_USED
  • SOG_TIMES_ATTLS13_OUTB_USED
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
    User domain statistics
New fields:
  • USGDESOF
  • USGDEENF
  • USGDRCUR
  • USGDRPK
  • USGTOCUR
  • USGTOPK
  • USGENFK
  • USGENFUN
 Temporary storage global statistics
New fields:
  • TSGASU Current aux. temp storage usage %
  • TSGASUPK Peak aux. temp storage usage %
      Transactions resource statistics
New field:
  • XMR_PURGED_TRNCLS_THRESHOLD, Purge Count
      Transaction class resource statistics
New field:
  • XMCGAMA, Last at MaxAct

Transaction class summary resource statistics

New fields:
  • First at Max Act
  • Last at Max Act

Back to Highlights of changes across releases