![]() ![]() ![]() ![]() ![]() ![]() ![]() |
Oracle Tuxedo systems incorporate the capability to use application queues for time-independent communication. The Tuxedo Application Queue MIB provides the administrative environment required for managing and controlling access to application queues. The Application Queue MIB defines the structure of the application queues.
In Tuxedo applications, messages are stored on a queue, and queues are defined within a particular queue space. Queueing and dequeuing is done within a transaction. The Application Queue MIB consists of five different groups for defining queue access, queues, messages, queues spaces, and queue transactions.
The Application Queue MIB consists of the following groups.
The tuxTAppQctrl
group enables controlled access to all Application Queue related MIB groups.
This applies to all Application Queue related MIB groups. This object value controls the machines for which the values are returned.
If the value is local(1)
, only the local host where Oracle SNMP Agent is running is considered; alternatively, all LMIDs known to the application are considered if the value is all(2)
.
The default for this object is local(1)
.
This applies to all Application Queue related MIB groups. This object value controls the device for which the values are returned.
The default for this object is “*”, in which case all known devices (which are a part of some group) are considered.
This applies to all Application Queue related MIB groups. This object value controls the queue space for which the values are returned.
The default for this object is “*”, in which case all queue spaces for the devices (qualified by tuxTAppQctrlQmConfig
) are considered.
This object value controls the queue for which the values are returned. This applies to tuxTAppQTbl
and tuxTAppQmsgTbl
.
The default for this object is “*”, in which case all queues for the devices (qualified by tuxTAppQctrlQmConfig
) and queue spaces (qualified by tuxTAppQctrlSpaceName
) are considered.
This object applies only to tuxTAppQmsgTbl
. The lowest priority within which to search for occurrences of tuxTAppQmsgTbl
instances. This object value is valid only for PRIO-based queues. By default, the minimum value of priority is considered. To revert to the default setting, set this object to 0
.
This object applies only to tuxTAppQmsgTbl
. The highest priority within which to search for occurrences of tuxTAppQmsgTbl
instances. This object value is valid only for PRIO-based queues. By default, the maximum value of priority is considered. To revert to the default setting, set this object to 0
.
This object applies only to tuxTAppQmsgTbl
. The end time within which to search for occurrences of tuxTAppQmsgTbl
instances. The range is inclusive. This object value is valid only for TIME-based queues. The default value is the maximum number possible on that machine. To use the default setting, set this object to “*”.
YY[MM[DD[hh[mm[ss]]]]]
This object applies only to tuxTAppQmsgTbl
. The start time within which to search for occurrences of tuxTAppQmsgTbl
instances. The range is inclusive. This object value is valid only for TIME-based queues. By default, the minimum time value is considered to be 0
. To use the default setting, set this object to “*”.
YY[MM[DD[hh[mm[ss]]]]]
This object applies only to tuxTAppQmsgTbl
. The expire end time within which to search for occurrences of tuxTAppQmsgTbl
instances. The range is inclusive. This object value is valid only for TIME-based queues. The default value is the maximum number possible on that machine. To use the default setting, set this object to “*”.
YY[MM[DD[hh[mm[ss]]]]]
This object applies only to tuxTAppQmsgTbl
. The Expire start time within which to search for occurrences of tuxTAppQmsgTbl
instances. The range is inclusive. This object value is valid only for TIME-based queues. By default, the minimum time value is considered to be 0
. To use the default setting, set this object to “*”.
YY[MM[DD[hh[mm[ss]]]]]
The tuxTAppQTbl
group contains objects that represent application queues. One or more application queues can exist in a single application queue space. Objects in this table are only accessible through a Tuxedo SNMP agent installed on the local machine.
Creation of a New Queue — For creating a new queue(row), in this group the SET
request should have the value of tuxTAppQname
, tuxTAppQspaceName
, and tuxTAppQmConfig
. Also the value of tuxTAppQgrpNo
(which is a part of the index) should be the corresponding group number for that queue space or “40000” (if no such group exists).
Note: | For this and all other Application Queue related MIB groups, there is a control MIB which can be used to filter the data returned as a part of all Application Queue related MIB groups. Refer to tuxTAppQctrl . |
To create a new row in this table, issue a SET request that specifies at least the values for tuxTAppQname
, tuxTAppQspaceName
, and tuxTAppQmConfig
.
Name of the application queue.
Note: | This object can be updated only during row creation. |
Name of the application queue space containing the application queue.
Note: | This object can be updated only during row creation. |
Absolute pathname of the file or device where the application queue space is located.
Note: | This object can be updated only during row creation. |
Identifier of the logical machine where the application queue space is located.
Note: | This object can be updated only during row creation. |
Group number of any server group for which this queue is a resource manager, in other words that group’s openinfo string tuxTgroupOpenInfo
contains the device name and queue space name for this queue.
Note: | This object can be updated only during row creation. |
INTEGER { valid(1), invalid(2) }
The values for GET
and SET
operations are as follows:
GET: valid(1)
GET
operation retrieves information about the selected application queues. The following list describes the meaning of the tuxTAppQstate
object returned in response to a GET
request. States not listed are not returned.
valid(1)
SET: invalid(2)
SET
operation changes characteristics of the selected application queue or creates a new queue. The following list describes the meaning of the tuxTAppQstate
object returned by a SET
request. States not listed cannot be set.
invalid(2)
invalid(2)
state.
The order in which messages in the queue are to be processed. Legal values are PRIO
or TIME
, followed by a comma, optionally followed by another occurrence of PRIO
or TIME
, followed by one of the values LIFO
or FIFO
. If neither FIFO
nor LIFO
is specified, FIFO
is assumed. If nothing is specified when a queue is created, the default is FIFO
. For example, these are some legal settings:
PRIO
PRIO,TIME,LIFO
TIME,PRIO,FIFO
TIME,FIFO
DisplayString
(SIZE
(0..127
)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)
The command to be automatically executed when the high water mark, tuxTAppQcmdHw
, is reached. The command is re-executed when the high water mark is reached again after the low water mark, tuxTAppQcmdLw
, has been reached.
The high water mark. Refer to tuxTAppQcmdLw
for further information.
The low water marks that control the automatic execution of the command specified in the tuxTAppQcmd
object. Each is an integer greater than or equal to zero optionally followed by one of the following keyletters. The keyletters must be consistent for tuxTAppQcmdHw
and tuxTAppQcmdLw
.
b
B
m
%
For example, if tuxTAppQcmdLw
is 50m and tuxTAppQcmdHw
is 100m, then the command specified in tuxTAppQcmd
is executed when 100 messages are on the queue, and it is not executed again until the queue is drained below 50 messages and is filled again to 100 messages.
The maximum number of retries for a failed queue message. When the number of retries is exhausted, the message is placed on the error queue of the associated application queue space. If there is no error queue, the message is dropped. The default is zero.
INTEGER { none(1), top(2), msgid(3) }
The way in which out-of-order message processing is to be handled. The default is none(1)
.
The delay, in seconds, between retries for a failed queue message. The default is zero.
The number of disk pages currently consumed by the queue.
The number of messages currently in the queue.
This object specifies an expiration time for messages enqueued with no explicit expiration time. The expiration time can be either a relative expiration time or none. The relative expiration time is determined by associating a fixed amount of time with a message after the message arrives at the queue manager process. When a message’s expiration time is reached and the message has not been dequeued or administratively deleted, all resources associated with the message are reclaimed by the system and statistics are updated. If a messages expires during a transaction, the expiration does not cause the transaction to fail. Messages that expire while being enqueued or dequeued within a transaction are removed from the queue when the transaction ends. There is no notification that the message has expired. If no default expiration time is specified for a queue, the message without an explicit expiration time does not expire. When the queue’s expiration time is modified, the expiration times of messages that were in the queue before the modification are not changed.
The format is +seconds
, where seconds
is the number of seconds allowed to lapse between the time that the queue manager successfully completes the operation and the time that the message is to expire. If seconds
is set to zero (0), the message expires immediately.
The value of this object may also be set to the string “none
.” The none
string indicates that messages enqueued to the queue with no explicit expiration time do not expire. You can change the expiration time for messages already in a queue with the tuxTAppQmsgExpireTime
object of the tuxTAppQmsgTbl
group.
INTEGER { persist(1), non-persist(2) }
This object specifies the default delivery policy for the queue when no delivery mode is specified for a message enqueued to the queue. When the value is “persist,
” messages enqueued to the queue without an explicitly specified delivery mode are delivered using the persistent (disk-based) delivery method. When the value is non-persist, messages enqueued to the queue without an explicitly specified delivery method are delivered using the non-persistent (in memory) delivery method. When a queue’s default delivery policy is modified, the delivery quality of service of messages that are in the queue before the modification are not changed. If the queue being modified is the reply queue named for any messages currently in the queue space, the reply quality of service is not changed for those messages as a result of changing the default delivery policy of the queue.
For non-persistent delivery, if the memory area is exhausted or fragmented so that a message cannot be enqueued, the enqueuing operation fails, even if there is sufficient persistent storage for the message. Similarly, if the persistent storage area is exhausted or fragmented so that a message cannot be enqueued, the enqueuing operation fails, even if there is sufficient non-persistent storage for the message. If the tuxTQspaceMemNonPersist
object of the tuxTQspaceTbl
group is zero (0) for a queue space, no space is reserved for non -persistent messages. In such a case, any attempt to enqueue a non-persistent message fails. This type of failure results, for example, when no delivery quality of service has been specified for a message and the tuxTAppQDefDeliveryPolicy
object for the target queue has been set to “non-persist.”
DisplayString
(SIZE
(1..127
)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)
This object specifies the command to be executed automatically when the high-water mark for non -persistent (memory-based delivery) messages, tuxTAppQCmdNonPersistHw
, is reached. The command is re-executed when the high-water mark is reached again after the low-water mark for non-persistent (memory-based delivery) messages, tuxTAppQCmdNonPersistLw
, has been reached.
These objects specify the high- and low-water marks that control the automatic execution of the command specified in the tuxTAppQCmdNonPersist
object. Each is an integer greater than or equal to zero, followed by one of the following keyletters. The keyletters must be consistent for tuxTAppQCmdNonPersistHw
and tuxTAppQCmdNonPersistLw
.
b
B
%
The messages threshold type specified through the tuxTAppQCmdHw
and tuxTAppQcmdLw
objects (when followed by an m) applies to all messages in a queue, including both persistent and non-persistent messages, and therefore is not available as a threshold type for tuxTAppQCmdNonPersistHw
and tuxTAppQCmdNonPersistLw.
These objects specify the high- and low-water marks that control the automatic execution of the command specified in the tuxTAppQCmdNonPersist
object. Each is an integer greater than or equal to zero, followed by one of the following keyletters. The keyletters must be consistent for tuxTAppQCmdNonPersistHw
and tuxTAppQCmdNonPersistLw
.
b
B
%
The messages threshold type specified through the tuxTAppQCmdHw
and tuxTAppQcmdLw
objects (when followed by an m) applies to all messages in a queue, including both persistent and non-persistent messages, and therefore is not available as a threshold type for tuxTAppQCmdNonPersistHw
and tuxTAppQCmdNonPersistLw
.
This object specifies the number of shared memory bytes currently consumed by the non-persistent messages on the queue.
This object specifies the number of non-persistent messages currently in the queue. To determine the total number of messages in the queue, add the value of tuxTAppQcurMsg
to this value.
The tuxTAppQmsgTbl
group contains objects that represent messages stored in application queues. A message is not created by an administrator; instead, it comes into existence as a result of a call to tpenqueue
(3). A message can be destroyed either by a call to tpdequeue
(3) or by an administrator. In addition, certain objects of a message can be modified by an administrator. For example, an administrator can move a message from one queue to another queue within the same queue space or change its priority.
Objects in this table are only accessible through a Tuxedo SNMP agent installed on the local machine.
A unique identifier for the queue message, which can be used to select the message for GET
or SET
operations. No significance should be placed on this value beyond using it for equality comparisons.
A running number corresponding to tuxTAppQmsgId
for the queue message, which is a part of the composite index of this table.
Group number of any server group for which this queue is a resource manager, in other words that group’s openinfo string tuxTgroupOpenInfo
contains the device name and queue space name for this queue.
Name of the application queue in which the message is stored.
Absolute pathname of the file or device where the application queue space for the queue containing this message is located.
Name of the application queue space containing the application queue in which this message is located.
Logical machine id for the machine on which the queue containing this message is located.
INTEGER { valid(1), invalid(2) }
The values for GET
and SET
operations are as follows:
GET: valid(1)
GET
operation retrieves information about the selected messages. The following list describes the meaning of the tuxTAppQmsgState
object returned in response to a GET
request. States not listed are not returned.
valid(1)
SET: invalid(2)
SET
operation changes characteristics of the selected message. The following list describes the meaning of the tuxTAppQmsgState
object returned by a SET
request. States not listed cannot be set.
invalid(2)
valid(1)
before attempting this operation. Successful return leaves the object in the invalid(2)
state.
Name of the queue into which to move the selected message. This queue must be an existing queue in the same queue space. The message must be in state valid(1)
for this operation to succeed. This object value is not returned by a GET
operation.
The priority of the message. This object value is valid only for PRIO-based queues. The value -1 is returned by a GET
operation if the queue is not PRIO-based.
The time when the message is processed. This object value is valid only for TIME-based queues. The empty string is returned by a GET
operation if the queue is not TIME-based. The format is one of the following:
+seconds
seconds
in the future. The value zero specifies that the message should be processed immediately.
YY[MM[DD[hh[mm[ss]]]]]
The correlation identifier for this message provided by the application in the tpenqueue
(3) request. The empty string indicates that a correlation identifier is not present.
The number of retries that have been attempted so far on this message.
The size of the message, in bytes.
This object specifies the time at which a message expires (that is, the time at which the message should be removed from the queue if it has not already been dequeued or administratively deleted). When a message expires, all resources it uses are reclaimed by the system and statistics are updated. If a message expires during a transaction, the expiration does not cause the transaction to fail. Messages that expire while being enqueued or dequeued within a transaction are removed from the queue when the transaction ends. There is no notification that the message has expired. Expiration times cannot be added to messages enqueued by versions of the Oracle Tuxedo system that do not support message expiration, even when the queue manager responsible for changing this value supports message expiration. Attempts to add an expiration time fail.
The empty string is returned by a GET
operation if the expiration time is not set. The expiration time format is one of the following:
+seconds
YY[MM[DD[hh]MM[SS]]]]
none
This read-only state is set to “no
” for non-persistent messages and “yes
” for persistent messages. It is the delivery quality of service for the message.
This read-only state is set to “no
” for non-persistent messages and “yes
” for persistent messages. It is the delivery quality that replies to the message
The tuxTQspaceTbl
group contains objects that represent application queue spaces. Objects in this table are only accessible through a Tuxedo SNMP agent installed on the local machine.
Note: | The values returned by this MIB are controlled by tuxTAppQctrl . For details, see the description of the above group. |
To create a new row in this table, a SET
request should be issued with an index (tuxTQspaceGrpNo
) of 40000, which is a reserved value for row creation in the table. The SET
request also needs to specify values for at least tuxTQspaceQmConfig
, tuxTQspaceName
, tuxTQspaceLmid
, tuxTQspaceIpckey
, tuxTQspaceMaxMsg
, tuxTQspaceMaxPages
, tuxTQspaceMaxProc
, tuxTQspaceMaxQueues
, and tuxTQspaceMaxTrans
. The newly created instance (row) is not visible until it is attached to some server group.
Name of the application queue space.
Note: | This object can be updated only during row creation. |
Absolute pathname of the file or device where the application queue space is located.
Note: | This object can be updated only during row creation. |
Identifier of the logical machine where the application queue space is located.
Note: | This object can be updated only during row creation. |
Group number of any server group for which this queue space is a resource manager, in other words that group’s openinfo string tuxTgroupOpenInfo
contains the device name and queue space name for this queue space.
Note: | This object can be updated only during row creation. |
INTEGER { inactive(1), initializing(2), open(3), active(4), cleaning(5), invalid(6) }
The values for GET
and SET
operations are as follows:
GET: inactive(1)|initializing(2)|open(3)|active(4)
GET
operation retrieves information about the selected application queue space. The following list describes the meaning of the tuxTQspaceState
object returned in response to a GET
request. States not listed are not returned.
inactive(1)
initializing(2)
open(3)
active(4)
TMS_QM
, TMQUEUE
, and perhaps TMQFORWARD
) associated with the queue space, or they can be administrative processes such as qmadmin
(1), or they can be processes associated with another application.
SET: open(3)|cleaning(5)|invalid(6)
SET
operation changes the selected application queue space or creates a new one. The following list describes the meaning of the tuxTQspaceState
object returned by a SET
request. States not listed cannot be set.
open(3)
inactive(1)
state.
cleaning(5)
active(4)
or open(3)
state. Successful return leaves the object in the inactive(1)
state.
invalid(6)
active(4)
or if messages exist on any queues in the queue space. Successful return leaves the object in the invalid(6)
state.
The blocking factor used for disk space management of the queue space. The default when a new queue space is created is 16.
Name of the error queue associated with the queue space. If there is no error queue, an empty string is returned by a GET
request.
This object value determines whether or not to initialize disk pages on new extents for the queue space. The default is not to initialize. Depending on the device type (e.g., regular file or raw slice), initialization can occur even if not requested.
The IPC key used to access queue space shared memory.
The maximum number of messages that the queue space can contain.
The maximum number of disk pages for all queues in the queue space. Each time the tuxTQspaceMaxPages
object is increased, a new extent is allocated (see tuxTQspaceCurExtent
). It is not possible to decrease the number of pages by setting this object to a lower number; an error is reported in this case.
The maximum number of processes that can attach to the queue space.
The maximum number of queues that the queue space can contain.
The maximum number of simultaneously active transactions allowed by the queue space.
The current number of extents used by the queue space. The largest number allowed is 100. Each time the tuxTQspaceMaxPages
object is increased, a new extent is allocated.
The current number of messages in the queue space. This number can be determined only if the queue space is open(3)
or active(4)
, or if the queue space is newly created. If none of the conditions apply, the value -1 is returned.
The current number of processes accessing the queue space.
The current number of queues existing in the queue space. This number can be determined only if the queue space is open(3)
or active(4)
, or if the queue space is newly created. If none of these conditions apply, the value -1 is returned.
The current number of outstanding transactions involving the queue space.
The highest number of messages in the queue space since the queue space was last opened. The number is reset to 0 when the queue space state is set to cleaning(5)
.
The highest number of processes simultaneously attached to the queue space since the queue space was last opened. The number is reset to 0 when the queue space state is set to cleaning(5)
.
The highest number of queues existing in the queue space since the queue space was last opened. The number is reset to 0 when the queue space state is set to cleaning(5)
.
The highest number of outstanding transactions involving the queue space since the queue space was last opened. If the queue space is accessed by more than one application, this number reflects all applications — not just the application represented by the TUXCONFIG environment variable. The number is reset to 0 when the queue space state is set to cleaning(5)
.
The percentage (as an integer between 0 and 100 inclusive) of disk space that has been initialized for the queue space.
This object specifies the number of additional actions that the Queuing Services component of the Oracle Engine can handle concurrently. When a blocking operation is encountered and additional actions are available, the blocking operation is set aside until it can be satisfied. After setting aside the blocking operation, another operation request can be handled. When the blocking operation is completed, the action associated with the operation is made available for a subsequent operation. The system reserve actions are equivalent to the number of processes that can attach to a queue space, so that each queue manager process can have at least one blocking action. Beyond the system-reserved number of blocking actions, the administrator can configure the system to enable it to accommodate additional blocking actions beyond the reserve. An operation fails if a blocking operation is requested and cannot be immediately satisfied and there are no actions available.
This object specifies the number of handles that users of the Queueing Services component of the Oracle Engine can use concurrently. Objects manipulated by the queuing services API require handles to access the objects. When an object is opened by a call to the Queuing Services API, a new handle is created and returned to the user. When an object handle is closed, the handle is made available for subsequent open object operations. When the Queuing Services API is used by an application, the administrator must configure the system to accommodate the maximum number of handles that are opened concurrently. An operation fails if a user attempts to open a queuing services object and there are no handles available. Adjusting this value has no effect on Tuxedo applications other than unnecessarily consuming shared memory resources.
This object specifies the number of additional Oracle Engine authenticated users that can concurrently use Queuing Services resources. There is one owner record per user, regardless of the number of open handles for the user. When there are no open handles for a user, the owner record is made available to subsequent users. The system reserves a number of owners equivalent to the number of actions, so that each action can be initiated by a different owner. Beyond the system-reserved number of owners that can concurrently use queuing services resources, the administrator can configure the system to accommodate additional owners beyond the reserved number. An operation fails if a user attempts to open a handle when there currently are no open handles, and there are no owners available. Adjusting this value has no effect on Oracle Tuxedo applications other than unnecessarily consuming shared memory resources. Adjusting this value has no effect on Tuxedo applications other than unnecessarily consuming shared memory resources.
This object specifies the number of temporary queues that can be opened concurrently in the Queuing Services component of the Oracle Engine. Temporary queues are used by dynamic, self-configuring applications and reduce the need for administrators to configure each queue used by an application. Messages enqueued to temporary queues are not persistent. When all handles to a temporary queue are closed, the temporary queue resources are made available for subsequent temporary queue creation. When the temporary queues are used by an application, the administrator must configure the system to accommodate the maximum number of temporary queues that are active concurrently. An open operation fails if a user attempts to open a temporary queue and there are no temporary queue resources available. This object specifies the number of additional Oracle Engine authenticated users that can concurrently use Queuing Services
This object specifies the number of cursors that user of the Queuing Services component of the Oracle Engine can use concurrently. CUrsors are used to navigate a queue. When a cursor is destroyed, the cursor resources are made available for subsequent cursor creation operations. When the cursors are used by an application, the administrator must configure the system to accommodate the maximum number of cursors that are allocated concurrently. An operation fails if a user attempts to create a cursor and there are no cursor resources available. This object specifies the number of additional Oracle Engine authenticated users that can concurrently use Queuing Services.
This object specifies the size of the area reserved in shared memory to hold non-persistent messages for all queues in the queue space. The memory size can be specified in bytes (b
) or blocks (B
). (The size of a block in this context is equivalent to the size of a disk block.)
The [bB
]suffix is optional and, if not specified, the default is blocks. Note that the number of bytes requested can be rounded up to the next internal data size. When read, the value is always the actual amount of memory allocated in bytes (b
).
All non-persistent messages in the specified queue space are permanently lost when this variable is successfully changed.
If the variable for a queue space is zero (0), no queue space is reserved. for non-persistent messages. In this case, any attempt to enqueue a non-persistent message fails. This type of failure results, for example, when no delivery quality of service has been specified for a message and the tuxTAppQDefDeliverPolicy
object of the tuxTAppTbl
group for the target queue has been set to NONPERSIST
. For non-persistent delivery, if the memory area is exhausted or fragmented so that a message cannot be enqueued, the enqueuing operation fails, even if there is sufficient persistent storage for the message. Similarly, if the persistent storage area is exhausted or fragmented so that a message cannot be enqueued, the enqueuing operation fails, even if there is sufficient non-persistent storage for the message.
This object specifies the size of the memory area to reserve in shared memory to hold the compiled representation of user-defined filters. The memory size is specified in bytes. Filters are used by the Queuing Services component of the Oracle Engine for message selection in dequeuing and cursor operations. Filters can be specified using various grammars, but are compiled into an engine normal form and stored in shared memory. Filters are referenced by a handle that is returned when they are compiled. When a filter is destroyed, the memory used by the filter is made available for subsequent compiled filters. When the filters are defined by an application, the administrator must configure the system to accommodate the maximum number of filters that will be concurrently compiled. An operation fails if a user attempts to create a new filter and there is not enough memory allocated for the compiled version of the filter. Adjusting this value has no effect on Tuxedo applications other than unnecessarily consuming shared memory resources.
This object specifies the size of the memory area to reserve in shared memory to accommodate peak load situations where some or all of the allocated shared memory resources are exhausted. The memory size is specified in bytes. Additional objects are allocated from this additional memory on a first-come, first-served basis. When an object created in the additional memory is closed or destroyed, the memory is released for subsequent overflow situations. This additional memory space can yield more objects than the configured number, but there is no guarantee that additional memory is available for any particular object at any given point in time. Currently, only actions, handles, cursors, owners, temporary queues, timers, and filters use the overflow.
This object specifies the total amount of memory (in bytes) reserved from shared memory for queuing services system use.
This object specifies the total amount of memory (in bytes) allocated from shared memory for all queuing services objects.
This object specifies the current number of actions in use in the queue space. This number can be determined if the queue space is OPEn or ACTive, or if the queue space is newly created. If none of the conditions apply, the value -1
is returned.
This object specifies the current number of cursors in use in the queue space. This number can be determined if the queue space is OPEn or ACTive, or if the queue space is newly created. If none of the conditions apply, the value -1
is returned.
This object specifies the current number of owners in use in the queue space. This number can be determined if the queue space is OPEn or ACTive, or if the queue space is newly created. If none of the conditions apply, the value -1
is returned.
This object specifies the current number of temporary queues in use in the queue space. This number can be determined if the queue space is OPEn or ACTive, or if the queue space is newly created. If none of the conditions apply, the value -1
is returned.
This object specifies the current number of cursors in use in the queue space. This number can be determined if the queue space is OPEn or ACTive, or if the queue space is newly created. If none of the conditions apply, the value -1
is returned.
This object specifies the current amount of memory, in bytes, consumed by non-persistent messages in the queue space. This number can be determined if the queue space is OPEn or ACTive, or if the queue space is newly created. If none of the conditions apply, the value -1
is returned.
This object specifies the current number of bytes in use for filters in the queue space. This number can be determined if the queue space is OPEn or ACTive, or if the queue space is newly created. If none of the conditions apply, the value -1
is returned.
This object specifies the current number of bytes of overflow memory in use in the queue space. This number can be determined if the queue space is OPEn or ACTive, or if the queue space is newly created. If none of the conditions apply, the value -1
is returned.
This object specifies the highest number of concurrent actions reached in the queue space since the queue space was last opened. The number is reset to 0 when the queue space is set to CLEaning.
This object specifies the highest number of concurrent handles opened in the queue space since the queue space was last opened. The number is reset to 0 when the queue space is set to CLEaning.
This object specifies the highest number of concurrent owners reached in the queue space since the queue space was last opened. The number is reset to 0 when the queue space is set to CLEaning.
This object specifies the highest number of concurrent temporary queues opened in the queue space since the queue space was last opened. The number is reset to 0 when the queue space is set to CLEaning.
This object specifies the highest number of concurrent cursors created in the queue space since the queue space was last opened. The number is reset to 0 when the queue space is set to CLEaning.
This object specifies the largest amount of memory in bytes consumed by non-persistent messages since the queue space was last opened. The number is reset to 0 when the queue space is set to CLEaning.
This object specifies the highest number of bytes used for filters in the queue space since the queue space was last opened. The number is reset to 0 when the queue space is set to CLEaning.
This object specifies the highest number of bytes used in the overflow memory in the queue space since the queue space was last opened. The number is reset to 0 when the queue space is set to CLEaning.
The tuxTQtransTbl
group contains objects that represent run-time characteristics of transactions associated with application queue spaces. Objects in this table are only accessible through a Tuxedo SNMP agent installed on the local machine.
Transaction identifier as returned by tx_info
(3) and mapped to a string representation. The data in this field should not be interpreted directly by the user except for equality comparison.
An integer index for tuxTQtransTbl
. This should not be interpreted by the user. It is used only for uniquely identifying a particular row in this table by the combination of Indx1 through Indx5.
An integer index for tuxTQtransTbl
. This should not be interpreted by the user. It is used only for uniquely identifying a particular row in this table by the combination of Indx1 through Indx5.
An integer index for tuxTQtransTbl
. This should not be interpreted by the user. It is used only for uniquely identifying a particular row in this table by the combination of Indx1 through Indx5.
An integer index for tuxTQtransTbl
. This should not be interpreted by the user. It is used only for uniquely identifying a particular row in this table by the combination of Indx1 through Indx5.
An integer index for tuxTQtransTbl
. This should not be interpreted by the user. It is used only for uniquely identifying a particular row in this table by the combination of Indx1 through Indx5.
Group number of any server group for which the queue space concerning this transaction is a resource manager, in other words that group’s openinfo string tuxTgroupOpenInfo
contains the device name and queue space name for the queue space concerning this transaction.
Name of the application queue space associated with the transaction.
Absolute pathname of the file or device where the application queue space is located.
Identifier of the logical machine where the application queue space is located.
INTEGER { active(1), abort-only(2), aborted(3), com-called(4), ready(5), decided(6), suspended(7), habort(8), hcommit(9) }
The values for GET
and SET
operations are as follows:
GET: {actdive(1)|abort-only(2)|aborted(3)|com-called(4)|ready(5)| decided(6)|suspended(7)}
GET
operation retrieves run-time information about the selected transactions. The following list describes the meaning of the tuxTQtransState
object returned in response to a GET
request. States not listed are not returned.
active(1)
aborted(3)
com-called(4)
tpcommit
(3) and the first phase of two-phase commit has begun.
ready(5)
decided(6)
suspended(7)
The initiator of the transaction has suspended processing on the transaction.
SET: {habort(8)|hcommit(9)}
SET
operation updates the state of the selected transactions. The following list describes the meaning of the tuxTQtransState
object returned by a SET
request. States not listed cannot be set.
habort(8)
hcommit(9)
![]() ![]() ![]() |