1.2.1.1.2.3 Call Path Tab

The following table lists the Call Path tab options:

Table 1-7 Call Path Tab Options

Options Description
Basic Policy Options -
Enable Enables/disables call path monitoring.

Note:

The fist policy deployed to the Tuxedo domain takes effect when there are more than one policies enabled on a Tuxedo target. The fist policy attributes, such as extended, bridge decode, affect the whole call path.
Ratio/Interval Selects Ratio or Interval policy. If multiple policies cover one initiator process and the ratio or interval policy are different, the smaller value is used. Applies to other monitoring policy definitions as well.
  • Ratio: Accepts a value range of 1-65535. It indicates that monitoring starts for a certain number of requests. The default value is 1 (indicating each request is monitored).
  • Interval: Accepts a value range of 1-65535. It indicates a period of time (in seconds) that monitoring can be started. It is exclusive of ratio settings. The default value is 1. The ratio/interval control only applies to the call path initiator.
Alert Only Specifies alert evaluation only. No metrics are sent to manager.
Bridge Decode Allows all BRIDGEs in the call path to decode messages. By default, BRIDGEs do not decode messages and the call path representation does not show BRIDGE points.

Note:

Use this option carefully. Decode/encode impacts application performance.
Enable Extended Monitoring When this option is enabled, the extended monitoring data reported by the tsambegin() and tsamend() API are collected by call path. These API are invoked automatically in Oracle Tuxedo ART for CICS and Batch when a CICS command, EXEC SQL, or IMS DLI is invoked. Following SQL are supported by OCI:

Note:

To monitor Pro*C sql by OCI , OCI library must be loaded in TSAM Plus Agent. Specify libclntsh.so location in the lib path when starting up the domain
Following SQL are supported by OCI:
  • EXEC SQL ALTER
  • EXEC SQL AUDIT
  • EXEC SQL COMMENT
  • EXEC SQL CREATE
  • EXEC SQL DROP
  • EXEC SQL GRANT
  • EXEC SQL NOAUDIT
  • EXEC SQL RENAME
  • EXEC SQL REVOKE
  • EXEC SQL TRUNCATE
  • EXEC SQL DELETE
  • EXEC SQL EXPLAIN PLAN
  • EXEC SQL INSERT
  • EXEC SQL LOCK TABLE
  • EXEC SQL OPEN
  • EXEC SQL SELECT
  • EXEC SQL UPDATE
  • EXEC SQL SAVEPOINT
  • EXEC SQL EXECUTE
  • EXEC SQL PREPARE
  • EXEC SQL SET ROLE
  • EXEC SQL EXECUTE END-EXEC
Enable Extended Monitoring Limit When this option is enabled, it specifies the maximum extended call path segments that can be generated in a call path when "Enable Extended Monitoring" is enabled. The acceptable value range is 1~ 2147483647. Default value is 1000.
Enable Service Contract Discovery When this option is selected, the monitored services contract information is collected. For more information, see User Payload Collection.
Define Payload Collection Click this button to specify the payload collection policies. For more information, see User Payload Collection.
Define Alert Displays the alert definition page. For more information, see Tuxedo Alert Definition.
Define Conditional Filter Click the button to define the conditional call path filters. When specified, only the call path metrics matched are collected and sent to TSAM Plus manager side. This feature saves network and database resources and allows administrators to focus on exceptional cases.

To specify the filter, select Enable.

Report Previous/Next Callpath Number

When it is enabled, the previous and next call paths of the matched one are also collected. You can specify the amounts of the associated call paths. The available values range is 0~100.
  • Metrics Evaluation Expression(s)
    You can select the metric, operator and threshold value to compose an expression. The logic for the expression can be "and" or "or". Following conditional filters are available:
    • Elapse Time exceeds a numeric value
    • Execution Status is or is not a value
    • URcode (tpreturn) is or is not a numeric value
    • Call depth is greater than or equal to a numeric value
    • Message Number on Request Queue is greater than (or equal to) a numeric value
  • FML Boolean Expression(s)

    You can also input FML Boolean expressions directly.

Dynamic Filter Panel Dynamic filter conditions are independent of each other. If multiple conditions are configured, the evaluation is for all conditions and the monitoring can be initiated. For single condition items by default, if one of the item evaluations is, then the condition is true. This applies to other monitoring policy definitions unless there is a special comment.
Initiator Type List Allows you to choose the following Initiator types:
  • Native Client
  • Workstation Client
  • Jolt Client
  • Domain Gateway
  • Application Server
  • Web Service Client
  • TMQFORWARD

Note:

"Domain Gateway" acts as a call path initiator for local service requests. For imported services, the initiator type is set to the original caller process. The "Web Service Client" initiator point is established from the Web service gateway process (GWWS). To enable the call path monitoring for GWSNAX inbound request, you must select "Domain Gateway" when defining the policy. The WTC module is not supported for call path monitoring.
Service List Specifies the initiator location monitored call path services. Select a service from the drop-down list. If Machine, Group, or Server is selected using an FML32 boolean expression, you must edit/input manually.
IP Address List Applies to workstation client and Jolt client initiator types. Specifies the IP address that initiates call path monitoring. The value can be an IPV4 or IPV6 address, or an FML32 boolean expression.
Client Name List Lists the native client, workstation client, and Jolt client initiator type client names.
User Name List Lists the initiator type user names.