How to Trace and Analyze Events › CTG Transaction Trace Components Properties › CTG Tracing Properties

CTG Tracing Properties

The use of the class method com.ibm.ctg.client.JavaGateway.flow() by an instrumented application generates the CTG flow method trace component with the following properties. Properties that can be filtered in the Transaction Trace Session dialog list the filter name.

Requests of the type com.ibm.ctg.client.CicsCpRequest have the following properties:

Class

The instrumented class is com.ibm.ctg.client.JavaGateway.

CTG Request Class

class name

Default: com.ibm.ctg.client.CicsCpRequest

CTG Request Type

Code Page

Method

The method name is always equal to flow.

Requests of the type com.ibm.ctg.client.ECIRequest have the following properties:

Communication Method

communication method

• CTG Channel
• CommArea Static
• CommArea Dynamic

Filter: CICS/IMS communication method equals

Correlation UUID

correlation UUID:IScopeCTGID

Properties with this value have a name that specifies a UUID used for correlation. The value is applicable only to CTG transaction traces. A different UUID is used for each CTG transaction, with multiple calls to a single extended transaction using one UUID.

Format: The name is a 32-byte UUID, and the value is IScopeCTGID.

Class

The instrumented class is com.ibm.ctg.client.JavaGateway

CTG Extend Mode

extend mode

Specifies the value that is used in the method call for the ECIRequest.Extend_Mode. Possible values are:

• ECI_BACKOUT—The transaction is being backed out.
• ECI_COMMIT—The transaction is being committed.
• ECI_EXTENDED—This is one program call in an extended transaction.
• ECI_NO_EXTEND—This is the first program call in a non-extended transaction or the last in an extended transaction that is committing.

CTG Server Name:

server

The host name of the connected CTG Server.

Default: server

CTG Request Class

class name

Default: com.ibm.ctg.client.ECIRequest

Method

The instrumented method name is always equal to 'flow'.

Program Name

program name

The name of the transaction that is invoked on the CTG Server. This property does not exist for backout and commit calls.

Filter: CICS program name (CTG) equals.

Transaction Name

The name of the transaction that is invoked on the CTG Server.

Filter: CICS transaction name (CTG) equals.

User ID

user

This property only exists if a user ID is set.

Filter: User ID equals.

Requests of the type com.ibm.ctg.client.EPIRequest have the following properties:

Class

The instrumented class com.ibm.ctg.client.JavaGateway

CTG Request Class

class name

Default: com.ibm.ctg.client.EPIRequest

CTG Request Type

EPI

CTG Server name

server

Method

The instrumented method name is always equal to "flow."

Transaction Name

transaction ID

User ID

user

This property only exists if a user ID is set.

Filter: User ID equals.

Requests of the type com.ibm.ctg.client.ESIRequest have the following properties:

Class

The instrumented class com.ibm.ctg.client.JavaGateway.

CTG Request Class

class name

Default: com.ibm.ctg.client.ESIRequest

CTG Request Type

ESI

Method

The instrumented method name is always equal to "flow."

Server Name

server

User ID

user

This property only exists if a user ID is set.

Filter: User ID equals.

Requests of the type com.ibm.ctg.client.XARequest have the following properties:

Class

The instrumented class is com.ibm.ctg.client.JavaGateway

CTG Request Class

class name

Default: com.ibm.ctg.client.XARequest

CTG Request Type

XA

Method

The instrumented method name is always equal to "flow."

Server Name

server

User ID

user

This property only exists if a user ID is set.

XA Request Type

Has the following values:

• XA_START
• XA_END
• XA_PREPARE
• XA_COMMIT
• XA_ROLLBACK
• XA_FORGET
• XA_RECOVER
• CLEANUP

Blame Point Metrics

The blame point metrics that the CTG CA SYSVIEW Tracer generates are in the following folders, depending on the request type.

• Requests of the type com.ibm.ctg.client.CicsCpRequest are in the folder Backends | CTG Code Page.
• Requests of the type com.ibm.ctg.client.ECIRequest are in the one of the following folders:
  • Backends | CTG ECI server server program program folder
  • Backends | CTG ECT server server ECI_COMMIT folder
  • Backends | CTG ECI server server ECI_BACKOUT folder
• Requests of the type com.ibm.ctg.client.EPIRequest are in the folder Backends | CTG EPI server server transaction transaction.
• Requests of the type com.ibm.ctg.client.ESIRequest are in the folder Backends | CTG ESI server server.
• Requests of the type com.ibm.ctg.client.XARequest are in the folder Backends | CTG XA server server XA request type with the following XA request types:
  • XA_START
  • XA_END
  • XA_PREPARE
  • XA_COMMIT
  • XA_ROLLBACK
  • XA_FORGET
  • XA_RECOVER
  • CLEANUP
• All other request types are in the Backends | CTG Unknown folder.