IBM Support

CICSPA TRANSTAT field report values

Question & Answer


Question

Where is the documentation describing the values CICS Performance Analyzer for z/OS (CICS PA) includes in the TRANSTAT column? I am running a CICS PA V5.2 report and have included the new TRANSTAT column. Some columns print nothing and others print a character "O".

Answer

TRANSTAT is in Byte 5 of the DFHTASK FIELD_ID(164). The section entitled Performance data in group DFHTASK in the CICS TS documentation describes the byte 5 data as follows:

 Byte 5
     Transaction status information:
 
     Bit 0
         The transaction origin  

     Bit 1
         Reserved  

     Bit 2
         Resource class record, or records, for this task  

     Bit 3
         Identity class record, or records, for this task  

     Bit 4
         Reserved  

     Bit 5
         Reserved  

     Bit 6
         Task purged on an open TCB

         Note: If bit 6 is set, the task was purged while running on an open TCB, and its transaction 
         timing clocks were left in an unreliable state. Because of this, the clocks are set to zero when
         the record is written by the CICS Monitoring Facility (CMF).  

     Bit 7
         Task abnormally terminated
 

Most CICS TS modules set it by issuing:

 DFHMN function(SET_FLAG)
 entryname(dfhtask)
 field_id(164)
 flag(nn);

(where nn is the bit offset relative to 1 for the 8 byte TRANFLAG field.

In a CICS PA output report where both the TRANFLAG and TRANSTAT field are formatted, the byte 5 value in the TRANFLAG either has no bits on, or in the case where the character "O" is printed for TRANSTAT, byte 5 has the x'80' bit on indicating bit 0 for the transaction origin.

A request to update the CICS PA documentation has been submitted to describe the TRANSTAT values. Byte 5 bits 1,2,3,6, and 7 should format as "O", "R", "I", "P", "A", for "Origin", "Resource", "Identity", "Purged", and "Abended".

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSPPU4","label":"CICS Performance Analyzer for z\/OS"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICSPA CICS PA

Document Information

Modified date:
21 October 2015

UID

dwa1233919