1.2.2.1.1 Call Path Query by Filter Panel

The following lists the panel options. Results are displayed in the Call Path Results List panel.

Table 1-19 Call Path Query By Filter Options

Options Descriptions
Initiator Specifies the call path initiator type to limit the scope. You can select the following values:
  • Type:
    • All
    • Workstation Client
    • Jolt Client
    • Native Client
    • Domain Gateway
    • Web Service Client
    • Application Server
    • TMQFORWARD

    The default value is All.

Note:

The "Initiator Type" supports multiple selections for specific initiator types.
  • Domain: Lists all Domains. The default value is Any.
  • Machine: Lists all machines for the selected domain. The default value is Any.
  • Server: Lists all servers for the selected machine. The default value is Any.
  • Initial Called Service: The first service of the call path.

Note:

If the initiator type is set to "Application Server", the "Initial Called Service" value must be host service name.
  • Client Process Name: The initiator process name.
  • User Name: The Tuxedo user name is provided to call initial called service.
Message Tag Specifies the Tuxedo Message Tag in the call path segments.

Note:

To use this function, the following product versions are required:
  • Oracle Tuxedo 12.1.3 RP013 or later
  • Oracle TSAM Plus standalone 12.1.3 RP006 or later
This filter only takes effect when the database type is Oracle.
Status Checks the call path status. You can select the following values:
  • Any
  • Success
  • Running
  • Application Failure
  • System Failure
  • Any Failure
The default value is Any.

Note:

"Application Failure" indicates tperrno is TPESVCFAIL. Other errors situations belong to System Failure.
Time Specifies a specific time period.
  • Any.
  • Recent: Specifies the recent time period between 0~60 minutes/hours/days. Default value is 1 hour.
  • Time Period: Specifies a particular time span.
Min. Elapsed Displays call paths with minimum microseconds spent (0 means all).
Max Record Specifies the call path max number. If the query results are larger than this number, the latest max records are retrieved.
Correlation ID / ECID (Optional) This option can be used to query call path by Correlation ID or ECID. If the Execution Context ID is inputted, Oracle TSAM Plus use it to filter related call path. ECID Query works only if related Tuxedo application enables ECID.

If the call path Correlation ID is inputted, Oracle TSAM Plus uses it to filter. The default value is empty (which indicates a Correlation ID is not used in the query).

Note:

Correlation ID" query is exclusive with "Filtering Parameters":

The Correlation ID consists of the following field values separated by a space:

  • Tuxedo domain ID: <DOMAINID>:<master machine name>:<IPCKEY> in the UBBCONFIG *RESOURCE section.
  • Logical Machine ID: LMID in the UBBCONFIG *MACHINES section.
  • Process Name:
    • “client”: Used for native clients.
    • “JSH”: Used for Jolt clients.
    • “WSH”: Used for /WS clients.
    • <server name>: Used for the server name.
  • Process ID (pid)
  • Thread ID
  • A counter in range of 1..99999999 (starting from 1)
  • Timestamp
Correlation ID Example:

TUXEDO:lcsol18:200401 SITE1 client 18505 1 1 1259031468

ECID Example:

004u3D6nvTI5qYSLMEo2ye0003KL000000

Parent topic: Call Path