This is the documentation for the development version. There are no official binaries for it; build it from the source code in git. Download links on these pages work only after the release. For the current release, see version 7.0.

Oracle Tuxedo and Enduro/X Monitoring

The tuxedo subagent monitors an Oracle Tuxedo or Enduro/X application from the NetXMS agent on one of the application’s machines. It reads the state and statistics of the domain, machines, clients, queues, servers, services, and service groups, and provides them as metrics, lists, and tables.

Enduro/X is an open-source middleware compatible with the Oracle Tuxedo ATMI programming interface. The subagent uses the same ATMI calls, FML32 buffers, and .TMIB administration requests with both products; which product it works with is decided when it is built.

How It Works

Tuxedo and Enduro/X Builds

The subagent is compiled against the libraries of one product:

  • Oracle Tuxedo build — linked with the Tuxedo libraries. The metrics, lists, and tables have names that start with Tuxedo..

  • Enduro/X build — linked with the Enduro/X libraries. The names start with EnduroX.. The Enduro/X build provides fewer metrics (31 instead of 74), but only the Enduro/X build returns values for the service group success and failure counters and execution times. Both builds provide the same lists and tables.

The module file is tuxedo.nsm in both cases. The metric reference in Agent Metrics shows for each metric whether the Enduro/X build provides it.

Data Collection

The subagent does not query the application when a metric is requested. A background thread reads all information at a fixed interval and keeps it in memory; metric requests return the values from the last read.

At every polling interval (parameter PollingInterval, default 10 seconds), the thread:

  1. Joins the application as a native ATMI client with tpinit(). The subagent passes no TPINIT buffer, so it uses no user name, client name, or application password.

  2. Sends GET requests in FML32 buffers to the .TMIB service for the MIB classes T_CLIENT, T_DOMAIN, T_MACHINE, T_QUEUE, T_SERVER, T_SVCGRP, and T_SERVICE, in this order. When the application returns more records than fit in one reply, the thread reads the rest with GETNEXT requests.

  3. Replaces the stored information of each class with the new records.

  4. Leaves the application with tpterm().

The first read takes place one polling interval after the agent starts; until then, all metrics return an error.

If tpinit() fails, the subagent discards the cached class information, and metrics based on that data return an error until a later read succeeds. Tuxedo.LocalMachineId keeps its value once the local machine ID has been learned, even when later reads fail. If the request for one class fails, only the information of that class is discarded.

MIB class Metrics Machine filter QueryLocalData bit

T_DOMAIN

Domain.*, Tuxedo.IsMasterMachine

No

 — 

T_MACHINE

Machine.*, Tuxedo.LocalMachineId

No

1

T_CLIENT

Client.*

Yes

 — 

T_QUEUE

Queue.*

Yes

2

T_SERVER

Server.*, ServerInstance.*

Yes

4

T_SVCGRP

ServiceGroup.*

Yes

8

T_SERVICE

Service.*

No

 — 

The Machine filter column shows which classes are limited to the agent host’s machine when machine filtering is active (see Local Machine ID and Filtering).

The QueryLocalData parameter is a bit mask. For each class with a bit in the table, the subagent sets the MIB_LOCAL flag in the TA_FLAGS field of the request when the bit is set. See the MIB(5) reference in the Oracle Tuxedo documentation for the effect of this flag. By default, all bits are set (15).

Local Machine ID and Filtering

A Tuxedo or Enduro/X application can span several machines, each with a logical machine ID (LMID) and a physical machine ID (PMID). After each read of the machine list, as long as the local machine ID is not known yet, the subagent looks for the machine whose physical machine ID is equal to the host name of the agent host (the node name from uname, compared case-insensitively). The logical machine ID of that machine becomes the local machine ID. The subagent keeps it until the agent restarts and does not check it again.

The local machine ID is used in three places:

  • Machine filtering — when FilterByLocalMachineId is enabled (the default), the requests for clients, queues, servers, and service groups ask only for objects on the local machine. Disable it to monitor the objects of all machines from one agent. Machines, services, and the domain information are never filtered.

  • Service group metrics — when the machine argument of a ServiceGroup.* metric is omitted, the local machine ID is used.

  • Tuxedo.LocalMachineId — returns it.

If no physical machine ID matches the host name, for example because the application configuration uses a fully qualified name and the host name is short, there is no local machine ID. The subagent then does not filter, Tuxedo.LocalMachineId returns an error, and the service group metrics need the machine argument.

Within each read, the client list is read before the machine list. The first client list after agent start is therefore not filtered.

Requirements

  • Build from source — tuxedo.nsm is not included in the NetXMS agent packages or installers. Build the agent from source on the application machine, with the Tuxedo or Enduro/X development files installed (see Building the Subagent). The subagent builds on UNIX-like systems; there is no Windows build.

  • Application machine — the agent connects as a native client, so it must run on a machine of the application, with access to the application’s configuration. The application must be booted, and its .TMIB service must be available.

  • No client authentication — because the subagent passes no user name or password to tpinit(), it cannot join an application that requires client authentication.

  • Environment — the agent process needs the product’s client environment:

    • Oracle Tuxedo build: the TUXCONFIG environment variable, plus the other variables the Tuxedo libraries need (for example TUXDIR). The subagent refuses to load when TUXCONFIG is not set.

    • Enduro/X build: at least one of the environment variables NDRX_CONFIG, NDRX_CCONFIG, NDRX_CCONFIG1 …​ NDRX_CCONFIG5. The subagent refuses to load when none of them is set.

  • Libraries — the dynamic linker must find the product’s shared libraries when the agent loads the subagent: libtux and libfml32 for Oracle Tuxedo (on AIX also libengine, if present), libatmi, libubf, and libnstd for Enduro/X. The build does not record the library directory in the module, so add it to the system’s linker configuration or to LD_LIBRARY_PATH in the environment of the agent service.

You can set the product’s environment variables in the [ENV] section of nxagentd.conf or in an environment file loaded with EnvironmentFile (see Environment Variables). The agent applies both before it loads subagents. LD_LIBRARY_PATH is different: the dynamic linker reads it only when a process starts, so set it in the agent service definition instead (for example, with Environment= in a systemd unit).

Building the Subagent

Add the --with-tuxedo option when you configure the agent build (see Building the Agent from Source):

./configure --enable-release-build --with-agent --with-tuxedo=/opt/tuxedo
make
sudo make install

The directory given to --with-tuxedo is the installation directory of Oracle Tuxedo or Enduro/X; the build uses its include and lib subdirectories. Without a directory, the compiler and linker search their default paths.

The build checks for the Tuxedo library libtux first. If it finds it, it produces the Oracle Tuxedo build; otherwise it looks for the Enduro/X library libatmi and produces the Enduro/X build. If neither library is found, configure stops with the error libtux or libatmi is required for Tuxedo support.

Enabling Tuxedo Monitoring

  1. Make sure the agent process has the environment described in Requirements.

  2. Load the subagent in nxagentd.conf:

    SubAgent = tuxedo
  3. Optionally, change the subagent settings in the [Tuxedo] section.

  4. Restart the agent.

  5. Check that the subagent is loaded: the Agent.SubAgentList list contains TUXEDO. After one polling interval, query a metric, for example nxget <agent-address> Tuxedo.Domain.State.

Table 1. [Tuxedo] section parameters
Parameter Default Description

PollingInterval

10

Interval in seconds between reads of the application information.

FilterByLocalMachineId

yes

Limit client, queue, server, and service group information to the local machine (see Local Machine ID and Filtering).

QueryLocalData

15

Bit mask that selects the classes for which the MIB_LOCAL flag is set: 1 — machines, 2 — queues, 4 — servers, 8 — service groups (see Data Collection). Decimal, hexadecimal (0x prefix), and octal (0 prefix) values are accepted.

The subagent reads these parameters only at agent startup.

Example configuration for an Oracle Tuxedo application:

SubAgent = tuxedo

[ENV]
TUXCONFIG = /home/tuxapp/tuxconfig
TUXDIR = /opt/tuxedo

[Tuxedo]
PollingInterval = 30
FilterByLocalMachineId = no

Collecting Data

Most metrics take the ID or name of an object as argument. The lists return valid arguments, so you can create DCIs with instance discovery: select the method Agent List with the matching list (see Instance Discovery Methods).

List Example DCI metric with {instance}

Tuxedo.Machines

Tuxedo.Machine.State({instance})

Tuxedo.Clients

Tuxedo.Client.State({instance})

Tuxedo.Queues

Tuxedo.Queue.RequestsCurrent({instance})

Tuxedo.Servers

Tuxedo.Server.RunningInstances({instance})

Tuxedo.ServerInstances

Tuxedo.ServerInstance.State({instance})

Tuxedo.Services

Tuxedo.Service.State({instance})

Tuxedo.ServiceGroups

Tuxedo.ServiceGroup.State({instance})

Server, server instance, and service group list entries contain several arguments separated by commas (for example 1,10 for server group 1, base server ID 10), so {instance} expands to the complete argument list.

The tables contain the same information, with more attributes, for table DCIs. In the Enduro/X build, replace the Tuxedo. prefix with EnduroX..

Reference

Agent Metrics

These metrics are provided by the tuxedo subagent. The subagent is built either for Oracle Tuxedo or for Enduro/X: the Tuxedo build provides the Tuxedo.* names, and the Enduro/X build provides the EnduroX.* names. Each entry shows the Enduro/X name next to the Tuxedo name when the Enduro/X build provides the metric; otherwise the metric exists only in the Tuxedo build.

The values come from the data that the subagent reads from the application every PollingInterval seconds, not from a request at query time. Metrics that read the class caches return an error when the last read of their class failed or no read has completed yet, and the error no such instance when the argument does not match an object in the last read data (the ServerInstance metrics return not supported instead). Tuxedo.LocalMachineId keeps its learned value across later collection failures. String arguments are matched case-insensitively.

Domain Metrics

Tuxedo.Domain.ID, EnduroX.Domain.ID

Domain ID (TA_DOMAINID of class T_DOMAIN).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Domain.Master

Logical machine IDs of the master machine and, after a comma, of the backup master machine, if one is configured (TA_MASTER).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Tuxedo.Domain.Model

Configuration model of the application (TA_MODEL).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Tuxedo.Domain.Queues, EnduroX.Domain.Queues

Current number of queues in the application (TA_CURQUEUES).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Domain.Routes

Current number of bulletin board routing table entries (TA_CURDRT).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Tuxedo.Domain.Servers, EnduroX.Domain.Servers

Current number of servers in the application (TA_CURSERVERS).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Domain.Services, EnduroX.Domain.Services

Current number of services in the application (TA_CURSERVICES).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Domain.State, EnduroX.Domain.State

State of the application (TA_STATE of class T_DOMAIN).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.IsMasterMachine

1 if the agent host is the master machine of the application, 0 otherwise. The subagent takes the first logical machine ID from Tuxedo.Domain.Master, looks up the physical machine ID (TA_PMID) of that machine, and compares it with the host name of the agent host (case-sensitive on UNIX-like systems). Returns an error when domain or machine information is unavailable, or the master machine is absent from the machine list.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Tuxedo.LocalMachineId

Logical machine ID (LMID) of the agent host: the machine whose physical machine ID (TA_PMID) matches the host name of the agent host (case-insensitive). Returns an error until the subagent has found such a machine (see Local Machine ID and Filtering).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Machine Metrics

Tuxedo.Machine.Accessers(lmid), EnduroX.Machine.Accessers(lmid)

Number of clients and servers currently accessing the application on the machine (TA_CURACCESSERS).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 2. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.Bridge(lmid)

Bridge device of the machine (TA_BRIDGE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 3. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.Clients(lmid), EnduroX.Machine.Clients(lmid)

Number of clients currently logged in on the machine (TA_CURCLIENTS).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 4. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.Conversations(lmid), EnduroX.Machine.Conversations(lmid)

Number of active conversations on the machine (TA_CURCONV).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 5. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.Load(lmid)

Current service load of the machine (TA_CURRLOAD).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 6. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.PhysicalID(lmid)

Physical machine ID (TA_PMID).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 7. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.Role(lmid)

Role of the machine in the application (TA_ROLE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 8. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.SoftwareRelease(lmid)

Software release installed on the machine (TA_SWRELEASE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 9. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.State(lmid), EnduroX.Machine.State(lmid)

State of the machine (TA_STATE of class T_MACHINE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 10. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.Type(lmid)

Machine type (TA_TYPE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 11. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.WorkloadsInitiated(lmid)

Workloads initiated on the machine (TA_WKINITIATED).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 12. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.WorkloadsProcessed(lmid)

Workloads processed on the machine (TA_WKCOMPLETED).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 13. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.WorkstationClients(lmid)

Number of workstation clients currently logged in on the machine (TA_CURWSCLIENTS).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 14. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Client Metrics

Tuxedo.Client.ActiveConversations(client-id), EnduroX.Client.ActiveConversations(client-id)

Number of conversations of the client that are currently active (TA_CURCONV of class T_CLIENT).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 15. Arguments
Argument Type Description

client-id

String

Client ID (TA_CLIENTID), as returned by the Tuxedo.Clients list; case-insensitive

Tuxedo.Client.ActiveRequests(client-id), EnduroX.Client.ActiveRequests(client-id)

Number of requests of the client that are currently active (TA_CURREQ of class T_CLIENT).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 16. Arguments
Argument Type Description

client-id

String

Client ID (TA_CLIENTID), as returned by the Tuxedo.Clients list; case-insensitive

Tuxedo.Client.Machine(client-id), EnduroX.Client.Machine(client-id)

Logical machine ID (TA_LMID) of the client.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 17. Arguments
Argument Type Description

client-id

String

Client ID (TA_CLIENTID), as returned by the Tuxedo.Clients list; case-insensitive

Tuxedo.Client.Name(client-id), EnduroX.Client.Name(client-id)

Client name (TA_CLTNAME).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 18. Arguments
Argument Type Description

client-id

String

Client ID (TA_CLIENTID), as returned by the Tuxedo.Clients list; case-insensitive

Tuxedo.Client.State(client-id), EnduroX.Client.State(client-id)

State of the client (TA_STATE of class T_CLIENT).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 19. Arguments
Argument Type Description

client-id

String

Client ID (TA_CLIENTID), as returned by the Tuxedo.Clients list; case-insensitive

Queue Metrics

Tuxedo.Queue.Machine(queue), EnduroX.Queue.Machine(queue)

Logical machine ID of the queue (TA_LMID).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 20. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Tuxedo.Queue.RequestsCurrent(queue), EnduroX.Queue.RequestsCurrent(queue)

Number of requests currently queued (TA_NQUEUED). The metric is registered with data type String, but the value is an integer.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 21. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Tuxedo.Queue.RequestsTotal(queue)

Total number of requests queued (TA_TOTNQUEUED). The metric is registered with data type String, but the value is an integer.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 22. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Tuxedo.Queue.Server(queue)

Executable name of the server that reads the queue (TA_SERVERNAME without the directory).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 23. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Tuxedo.Queue.ServerCount(queue)

Number of servers reading the queue (TA_SERVERCNT). The metric is registered with data type String, but the value is an integer.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 24. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Tuxedo.Queue.State(queue), EnduroX.Queue.State(queue)

State of the queue (TA_STATE of class T_QUEUE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 25. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Tuxedo.Queue.WorkloadsCurrent(queue)

Workloads currently queued (TA_WKQUEUED). The metric is registered with data type String, but the value is an integer.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 26. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Tuxedo.Queue.WorkloadsTotal(queue)

Total workloads queued (TA_TOTWKQUEUED). The metric is registered with data type String, but the value is an integer.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 27. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Server Metrics

Tuxedo.Server.ActiveRequests(group, base-id)

Number of requests currently being processed, summed over all instances of the server (TA_CURREQ).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 28. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.CommandLine(group, base-id)

Command line options of the server (TA_CLOPT). The value is taken from the first instance record that the application returns for the server.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 29. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.Group(group, base-id)

Server group name (TA_SRVGRP).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 30. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.Machine(group, base-id)

Logical machine ID of the server (TA_LMID). The value is taken from the first instance record that the application returns for the server.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 31. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.MaxInstances(group, base-id)

Maximum number of server instances (TA_MAX).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 32. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.MinInstances(group, base-id)

Minimum number of server instances (TA_MIN).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 33. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.Name(group, base-id)

Executable name of the server (TA_SERVERNAME without the directory).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 34. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.ProcessedRequests(group, base-id)

Number of requests processed, summed over all instances of the server (TA_TOTREQC).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 35. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.ProcessedWorkloads(group, base-id)

Workloads processed, summed over all instances of the server (TA_TOTWORKL).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 36. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.RunningInstances(group, base-id)

Number of server instances in state ACTIVE.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 37. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Server Instance Metrics

Tuxedo.ServerInstance.ActiveRequests(group, server-id)

Number of requests the instance is currently processing (TA_CURREQ).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 38. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.BaseID(group, server-id)

Base server ID of the server the instance belongs to (TA_BASESRVID).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 39. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.CommandLine(group, server-id), EnduroX.ServerInstance.CommandLine(group, server-id)

Command line options of the instance (TA_CLOPT).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 40. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.CurrentService(group, server-id)

Service the instance is currently processing (TA_CURRSERVICE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 41. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.Generation(group, server-id), EnduroX.ServerInstance.Generation(group, server-id)

Generation of the instance (TA_GENERATION).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 42. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.Group(group, server-id)

Server group name (TA_SRVGRP).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 43. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.Machine(group, server-id), EnduroX.ServerInstance.Machine(group, server-id)

Logical machine ID of the instance (TA_LMID).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 44. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.Name(group, server-id), EnduroX.ServerInstance.Name(group, server-id)

Executable name of the server (TA_SERVERNAME without the directory).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 45. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.PID(group, server-id), EnduroX.ServerInstance.PID(group, server-id)

Process ID of the instance (TA_PID).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 46. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.ProcessedRequests(group, server-id)

Number of requests processed by the instance (TA_TOTREQC).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 47. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.ProcessedWorkloads(group, server-id)

Workloads processed by the instance (TA_TOTWORKL).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 48. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.State(group, server-id), EnduroX.ServerInstance.State(group, server-id)

State of the instance (TA_STATE of class T_SERVER).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 49. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Service Metrics

Tuxedo.Service.Load(service)

Load of the service (TA_LOAD).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 50. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME), as returned by the Tuxedo.Services list; case-insensitive

Tuxedo.Service.Priority(service)

Priority of the service (TA_PRIO).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 51. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME), as returned by the Tuxedo.Services list; case-insensitive

Tuxedo.Service.RoutingName(service)

Routing criteria name of the service (TA_ROUTINGNAME).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 52. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME), as returned by the Tuxedo.Services list; case-insensitive

Tuxedo.Service.State(service), EnduroX.Service.State(service)

State of the service (TA_STATE of class T_SERVICE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 53. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME), as returned by the Tuxedo.Services list; case-insensitive

Service Group Metrics

Tuxedo.ServiceGroup.CompletedRequests(service, group[, lmid]), EnduroX.ServiceGroup.CompletedRequests(service, group[, lmid])

Number of completed requests (TA_NCOMPLETED).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 54. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.FailedRequests(service, group[, lmid]), EnduroX.ServiceGroup.FailedRequests(service, group[, lmid])

Number of failed requests (TA_TOTSFAILNUM). Only the Enduro/X build returns a value. The Tuxedo build registers the metric, but every request returns the error not supported.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 55. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.LastExecutionTime(service, group[, lmid]), EnduroX.ServiceGroup.LastExecutionTime(service, group[, lmid])

Execution time of the last request, in microseconds (TA_LASTEXECTIMEUSEC). Only the Enduro/X build returns a value. The Tuxedo build registers the metric, but every request returns the error not supported.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 56. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.Load(service, group[, lmid])

Load of the service in the server group (TA_LOAD).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 57. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.MaxExecutionTime(service, group[, lmid]), EnduroX.ServiceGroup.MaxExecutionTime(service, group[, lmid])

Longest request execution time, in microseconds (TA_MAXEXECTIMEUSEC). Only the Enduro/X build returns a value. The Tuxedo build registers the metric, but every request returns the error not supported.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 58. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.MinExecutionTime(service, group[, lmid]), EnduroX.ServiceGroup.MinExecutionTime(service, group[, lmid])

Shortest request execution time, in microseconds (TA_MINEXECTIMEUSEC). Only the Enduro/X build returns a value. The Tuxedo build registers the metric, but every request returns the error not supported.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 59. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.Priority(service, group[, lmid])

Priority of the service in the server group (TA_PRIO).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 60. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.QueuedRequests(service, group[, lmid])

Number of requests currently queued (TA_NQUEUED).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 61. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.RequestAddress(service, group[, lmid])

Request queue name of the servers offering the service (TA_RQADDR).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 62. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.RoutingName(service, group[, lmid])

Routing criteria name (TA_ROUTINGNAME).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 63. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.State(service, group[, lmid]), EnduroX.ServiceGroup.State(service, group[, lmid])

State of the service in the server group (TA_STATE of class T_SVCGRP).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 64. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.SuccessfulRequests(service, group[, lmid]), EnduroX.ServiceGroup.SuccessfulRequests(service, group[, lmid])

Number of successfully completed requests (TA_TOTSUCCNUM). Only the Enduro/X build returns a value. The Tuxedo build registers the metric, but every request returns the error not supported.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 65. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Lists

Both builds provide all lists, under the names Tuxedo.<name> and EnduroX.<name>.

Tuxedo.Clients, EnduroX.Clients (List)

Client IDs (TA_CLIENTID) of the clients. With machine filtering active, only clients on the local machine.

Data Type

List

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Machines, EnduroX.Machines (List)

Logical machine IDs (LMID) of all machines of the application.

Data Type

List

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Queues, EnduroX.Queues (List)

Names (TA_RQADDR) of the queues. With machine filtering active, only queues on the local machine.

Data Type

List

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.ServerInstances, EnduroX.ServerInstances (List)

Server instances in group,server-id form (server group number and server ID), ready to use as the argument of the Tuxedo.ServerInstance.* metrics. With machine filtering active, only instances on the local machine.

Data Type

List

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Servers, EnduroX.Servers (List)

Servers in group,base-id form (server group number and base server ID), ready to use as the argument of the Tuxedo.Server.* metrics. With machine filtering active, only servers on the local machine.

Data Type

List

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.ServiceGroups, EnduroX.ServiceGroups (List)

Service groups in service,group,lmid form (service name, server group name, logical machine ID), ready to use as the argument of the Tuxedo.ServiceGroup.* metrics. With machine filtering active, only service groups on the local machine.

Data Type

List

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Services, EnduroX.Services (List)

Names of all services of the application (TA_SERVICENAME).

Data Type

List

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tables

Both builds provide all tables, under the names Tuxedo.<name> and EnduroX.<name>, with the same columns, except the Enduro/X-only columns of the service group table.

Tuxedo.Clients, EnduroX.Clients (Table)

Clients of the application (class T_CLIENT), one row per client. With machine filtering active, only clients on the local machine.

Data Type

Table

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 66. Columns
Column Type Description

ID

String

Client ID (TA_CLIENTID), instance column

NAME

String

Client name (TA_CLTNAME)

MACHINE

String

Logical machine ID (TA_LMID)

STATE

String

State (TA_STATE)

GROUP

String

Server group (TA_SRVGRP)

USERNAME

String

User name (TA_USRNAME)

IDLE_TIME

Integer

Idle time (TA_IDLETIME)

PID

Integer

Process ID (TA_PID)

ACTIVE_REQUESTS

Integer

Active requests (TA_CURREQ)

ACTIVE_CONV

Integer

Active conversations (TA_CURCONV)

CONV_COUNT

Integer

Conversations (TA_NUMCONV)

DEQUEUE_COUNT

Integer

Dequeue operations (TA_NUMDEQUEUE)

ENQUEUE_COUNT

Integer

Enqueue operations (TA_NUMENQUEUE)

POST_COUNT

Integer

Posts (TA_NUMPOST)

REQUEST_COUNT

Integer

Requests (TA_NUMREQ)

SUBSCR_COUNT

Integer

Subscriptions (TA_NUMSUBSCRIBE)

TRAN_COUNT

Integer

Transactions (TA_NUMTRAN)

WSCLIENT

String

Workstation client flag (TA_WSC)

WSCID

String

Workstation handler client ID (TA_WSHCLIENTID)

NETADDR

String

Network address (TA_NADDR)

ENCBITS

Integer

Encryption bits (TA_CURENCRYPTBITS)

Tuxedo.Machines, EnduroX.Machines (Table)

Machines of the application (class T_MACHINE), one row per machine. The machine list is not filtered by machine.

Data Type

Table

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 67. Columns
Column Type Description

ID

String

Logical machine ID (TA_LMID), instance column

PMID

String

Physical machine ID (TA_PMID)

TYPE

String

Machine type (TA_TYPE)

STATE

String

State (TA_STATE)

ROLE

String

Role (TA_ROLE)

BRIDGE

String

Bridge device (TA_BRIDGE)

SW_REL

String

Software release (TA_SWRELEASE)

ACCESSERS

Integer

Current accessers (TA_CURACCESSERS)

CLIENTS

Integer

Current clients (TA_CURCLIENTS)

WS_CLIENTS

Integer

Current workstation clients (TA_CURWSCLIENTS)

CONVERSATIONS

Integer

Current conversations (TA_CURCONV)

LOAD

Integer

Current load (TA_CURRLOAD)

WK_PROCESSED

Integer

Workloads processed (TA_WKCOMPLETED)

WK_INITIATED

Integer

Workloads initiated (TA_WKINITIATED)

TUXCONFIG

String

Configuration file (TA_TUXCONFIG)

TUXDIR

String

Product installation directory (TA_TUXDIR)

APPDIR

String

Application directory (TA_APPDIR)

ENV_FILE

String

Environment file (TA_ENVFILE)

TLOG_DEVICE

String

Transaction log device (TA_TLOGDEVICE)

TLOG_NAME

String

Transaction log name (TA_TLOGNAME)

Tuxedo.Queues, EnduroX.Queues (Table)

Queues of the application (class T_QUEUE), one row per queue name. Records with the same queue name (on different machines) are merged into one row: the counters are summed, the other columns come from the first record. With machine filtering active, only queues on the local machine.

Data Type

Table

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 68. Columns
Column Type Description

NAME

String

Queue name (TA_RQADDR), instance column

MACHINE

String

Logical machine ID (TA_LMID)

SERVER

String

Executable name of the server (TA_SERVERNAME without the directory)

STATE

String

State (TA_STATE)

SRV_COUNT

Integer

Number of servers (TA_SERVERCNT)

RQ_TOTAL

Integer

Total requests queued (TA_TOTNQUEUED)

RQ_CURRENT

Integer

Requests currently queued (TA_NQUEUED)

WK_TOTAL

Integer

Total workloads queued (TA_TOTWKQUEUED)

WK_CURRENT

Integer

Workloads currently queued (TA_WKQUEUED)

Tuxedo.ServerInstances, EnduroX.ServerInstances (Table)

Server instances (class T_SERVER), one row per instance. With machine filtering active, only instances on the local machine.

Data Type

Table

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 69. Columns
Column Type Description

GROUP_ID

Integer

Server group number (TA_GRPNO), instance column

ID

Integer

Server ID (TA_SRVID), instance column

BASE_ID

Integer

Base server ID (TA_BASESRVID)

NAME

String

Executable name (TA_SERVERNAME without the directory)

GROUP_NAME

String

Server group name (TA_SRVGRP)

STATE

String

State (TA_STATE)

RQ_ADDR

String

Request queue name (TA_RQADDR)

LMID

String

Logical machine ID (TA_LMID)

PID

Integer

Process ID (TA_PID)

GENERATION

Integer

Generation (TA_GENERATION)

THREADS

Integer

Current dispatch threads (TA_CURDISPATCHTHREADS)

THREADS_MIN

Integer

Minimum dispatch threads (TA_MINDISPATCHTHREADS)

THREADS_MAX

Integer

Maximum dispatch threads (TA_MAXDISPATCHTHREADS)

ACTIVE_REQUESTS

Integer

Active requests (TA_CURREQ)

CURR_SERVICE

String

Current service (TA_CURRSERVICE)

TRAN_LEVEL

Integer

Transaction level (TA_TRANLEV)

PROCESSED_REQUESTS

Integer

Processed requests (TA_TOTREQC)

PROCESSED_WORKLOADS

Integer

Processed workloads (TA_TOTWORKL)

CONVERSATIONS

Integer

Conversations (TA_NUMCONV)

DEQUEUE_COUNT

Integer

Dequeue operations (TA_NUMDEQUEUE)

ENQUEUE_COUNT

Integer

Enqueue operations (TA_NUMENQUEUE)

POSTS

Integer

Posts (TA_NUMPOST)

INITIATED_REQUESTS

Integer

Initiated requests (TA_NUMREQ)

SUBSCRIPTIONS

Integer

Subscriptions (TA_NUMSUBSCRIBE)

TRANSACTIONS

Integer

Transactions (TA_NUMTRAN)

START_TIME

Integer

Start time (TA_TIMESTART)

RESTART_TIME

Integer

Restart time (TA_TIMERESTART)

ENV_FILE

String

Environment file (TA_ENVFILE)

CMDLINE

String

Command line options (TA_CLOPT)

Tuxedo.Servers, EnduroX.Servers (Table)

Servers (class T_SERVER), one row per server: all instances with the same server group number and base server ID. Counters are summed over the instances; NAME, GROUP_NAME, MIN, MAX, LMID, THREADS_MIN, THREADS_MAX, ENV_FILE, and CMDLINE come from the first instance record. With machine filtering active, only servers on the local machine.

Data Type

Table

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 70. Columns
Column Type Description

GROUP_ID

Integer

Server group number (TA_GRPNO), instance column

BASE_ID

Integer

Base server ID (TA_BASESRVID), instance column

NAME

String

Executable name (TA_SERVERNAME without the directory)

GROUP_NAME

String

Server group name (TA_SRVGRP)

MIN

Integer

Minimum instances (TA_MIN)

MAX

Integer

Maximum instances (TA_MAX)

RUNNING

Integer

Instances in state ACTIVE

LMID

String

Logical machine ID (TA_LMID)

THREADS

Integer

Current dispatch threads, sum (TA_CURDISPATCHTHREADS)

THREADS_MIN

Integer

Minimum dispatch threads (TA_MINDISPATCHTHREADS)

THREADS_MAX

Integer

Maximum dispatch threads (TA_MAXDISPATCHTHREADS)

ACTIVE_REQUESTS

Integer

Active requests, sum (TA_CURREQ)

PROCESSED_REQUESTS

Integer

Processed requests, sum (TA_TOTREQC)

PROCESSED_WORKLOADS

Integer

Processed workloads, sum (TA_TOTWORKL)

CONVERSATIONS

Integer

Conversations, sum (TA_NUMCONV)

DEQUEUE_COUNT

Integer

Dequeue operations, sum (TA_NUMDEQUEUE)

ENQUEUE_COUNT

Integer

Enqueue operations, sum (TA_NUMENQUEUE)

POSTS

Integer

Posts, sum (TA_NUMPOST)

INITIATED_REQUESTS

Integer

Initiated requests, sum (TA_NUMREQ)

SUBSCRIPTIONS

Integer

Subscriptions, sum (TA_NUMSUBSCRIBE)

TRANSACTIONS

Integer

Transactions, sum (TA_NUMTRAN)

ENV_FILE

String

Environment file (TA_ENVFILE)

CMDLINE

String

Command line options (TA_CLOPT)

Tuxedo.ServiceGroups, EnduroX.ServiceGroups (Table)

Service groups (class T_SVCGRP): one row per service, server group, and machine. With machine filtering active, only service groups on the local machine.

Data Type

Table

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 71. Columns
Column Type Description

SVCNAME

String

Service name (TA_SERVICENAME), instance column

SRVGROUP

String

Server group name (TA_SRVGRP), instance column

LMID

String

Logical machine ID (TA_LMID), instance column

GROUPNO

Integer

Server group number (TA_GRPNO)

RQADDR

String

Request queue name (TA_RQADDR)

STATE

String

State (TA_STATE)

RT_NAME

String

Routing criteria name (TA_ROUTINGNAME)

LOAD

Integer

Load (TA_LOAD)

PRIO

Integer

Priority (TA_PRIO)

COMPLETED

Integer

Completed requests (TA_NCOMPLETED)

QUEUED

Integer

Queued requests (TA_NQUEUED)

SUCCESSFUL

Integer

Successful requests (TA_TOTSUCCNUM); Enduro/X build only

FAILED

Integer

Failed requests (TA_TOTSFAILNUM); Enduro/X build only

EXECTIME_LAST

Integer

Execution time of the last request in microseconds (TA_LASTEXECTIMEUSEC); Enduro/X build only

EXECTIME_MAX

Integer

Longest execution time in microseconds (TA_MAXEXECTIMEUSEC); Enduro/X build only

EXECTIME_MIN

Integer

Shortest execution time in microseconds (TA_MINEXECTIMEUSEC); Enduro/X build only

Tuxedo.Services, EnduroX.Services (Table)

Services of the application (class T_SERVICE), one row per service. The service list is not filtered by machine.

Data Type

Table

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 72. Columns
Column Type Description

NAME

String

Service name (TA_SERVICENAME), instance column

STATE

String

State (TA_STATE)

RT_NAME

String

Routing criteria name (TA_ROUTINGNAME)

LOAD

Integer

Load (TA_LOAD)

PRIO

Integer

Priority (TA_PRIO)

Troubleshooting

  • The subagent does not load — the agent log contains TUXCONFIG environment variable not set (Oracle Tuxedo build) or Enduro/X environment is not configured (Enduro/X build). Set the variables described in Requirements. If the log reports that the module cannot be loaded, the dynamic linker cannot find the Tuxedo or Enduro/X libraries.

  • All metrics return an error — the subagent cannot join the application or has not completed its first read. Check that the application is booted, that the environment variables point to it, and that the application does not require client authentication. The debug message tpinit() call failed shows the reason reported by the product.

  • Client, queue, server, or service group metrics return no such instance — with machine filtering active, only objects on the local machine are available. Check Tuxedo.LocalMachineId, or set FilterByLocalMachineId = no.

  • Tuxedo.LocalMachineId returns an error — no machine of the application has a physical machine ID equal to the host name of the agent host; compare the PMID column of the Tuxedo.Machines table with the output of uname -n.

To see details, enable the agent debug tag tuxedo with DebugTags in nxagentd.conf (see Diagnostics), for example DebugTags = tuxedo:3:

Level Messages

1

Local machine ID found

2

Configuration file or Enduro/X configuration in use, subagent shutdown

3

Settings at startup, poller start with polling interval, failed tpcall() requests, and failed tpinit() calls (the first failure and then every 40th)

Every failed tpinit() call is also logged at debug level 3 without a tag, so it appears with DebugLevel = 3.