Section 5 - File Formats, Data Descriptions, MIBs, and System Processes Reference

File Formats, Data Descriptions, MIBs, and System Processes Reference

T_IFQUEUE Class

Overview

The T_IFQUEUE MIB class represents run-time attributes of an interface as it pertains to a particular server queue (T_QUEUE) in a CORBA environment. This is primarily a read-only class providing access to the inherited configuration attributes of an interface as well as statistics relating to the interface on the queue. Additionally, this class gives administrators finer granularity in suspending and activating interfaces. This class provides the link between an interface name and the server processes capable of processing method invocations on the interface, that is, TA_RQADDR can be used as a key search field on the T_SERVER class.

Attribute Table

Table 49 TM_MIB(5): T_IFQUEUE Class Definition Attribute Table

Attribute	Usage	Type	Permissions	Values	Default
`TA_INTERFACENAME`	*	string	`R--R--R--`	`string`[1..128]	N/A
`TA_SRVGRP`	*	string	`R--R--R--`	`string`[1..30]	N/A
`TA_RQADDR`	*	string	`R--R--R--`	`string`[1..30]	N/A
`TA_STATE`	k	string	`R-XR-XR--`	`GET:` `"`{`ACT` \| `SUS` \| `PAR`}`" SET:` `"`{`ACT` \| `SUS`}`"`	N/A
`TA_AUTOTRAN`		string	`R--R--R--`	`"`{`Y` \| `N`}`"`	N/A
`TA_LOAD`		long	`R--R--R--`	1 <= `num` < 32K	N/A
`TA_PRIO`		long	`R--R--R--`	1 <= `num` < 101	N/A
`TA_TIMEOUT`		long	`R--R--R--`	0 <= `num`	N/A
`TA_TRANTIME`		long	`R--R--R--`	0 <= `num`	N/A
`TA_FBROUTINGNAME`		string	`R--R--R--`	`string`[1..15]	N/A
`TA_LMID`	k	string	`R--R--R--`	`LMID`	N/A
`TA_NUMSERVERS`		long	`R--R--R--`	0 <= `num`	N/A
`TA_RTPOLICY`		string	`R--R--R--`	`"`{`always` \| `never`}`"`	`never`
`TA_TPPOLICY`		string	`R--R--R--`	`"`{`method` \| `transaction` \| `process`}`"`	N/A
`TA_TXPOLICY`		string	`R--R--R--`	`"`{`always` \| `never` \| `optional` \| `ignore`}`"`	N/A
`TA_NCOMPLETED`	l	long	`R-XR-XR--`	0 <= `num`	N/A
`TA_NQUEUED`	l	long	`R--R--R--`	0 <= `num`	N/A
`TA_CUROBJECTS`	l	long	`R--R--R--`	0 <= `num`	N/A
`TA_CURTRANSACTIONS`	l	long	`R--R--R--`	0 <= `num`	N/A
( k ) - `GET` key field ( l ) - local Field ( * ) - `GET`/`SET` key, one or more required for SET operations

Attribute Semantics

TA_INTERFACENAME: string[1..128]

The fully qualified interface name. The interface repository id for the interface. The format of this name is dependent on the options specified in the IDL which generates the interface implementation. See CORBA 2.1 Specification Section 7.6 for details.

TA_SRVGRP: string[0..30]

Server group name. Server group names cannot contain an asterisk, comma or colon.

TA_RQADDR: string[1..30]

Symbolic address of the request queue for an active server offering this interface. See T_SERVER:TA_RQADDR for more information on this attribute.

TA_STATE:

GET: "{ACTive | SUSpended | PARtitioned}"

A GET operation will retrieve configuration information for the selected T_IFQUEUE objects. The following states indicate the meaning of a TA_STATE returned in response to a GET request. States not listed will not be returned.

`ACTive`	`T_IFQUEUE` object represents an available interface in the running system.
`SUSpended`	`T_IFQUEUE` object represents a currently suspended interface in the running system.
`PARtitioned`	`T_IFQUEUE` object represents a currently partitioned interface in the running system.

SET: "{ACTive | SUSpended}"

The following states indicate the meaning of a TA_STATE set in a SET request. States not listed may not be set.

`ACTive`	Activate the `T_IFQUEUE` object. State change only allowed when in the `SUSpended` state. Successful return leaves object in `ACTive` state.
`SUSpended`	Suspend the `T_IFQUEUE` object. State change only allowed when in the `ACTive` state. Successful return leaves object in `SUSpended` state.

Limitation: Dynamic advertisement of interfaces (i.e., state change from INActive or INValid to ACTive) is not supported, nor is unadvertisement (i.e., state change from ACTive to INActive).

TA_AUTOTRAN: "{Y | N}"

Signifies whether a transaction will be automatically started for invocations made outside a transaction context. See T_INTERFACE description of this attribute for discussion of limitations regarding this attribute.

TA_LOAD: 1 <= num <= 32K

This T_INTERFACE object imposes the indicated load on the system. Interface loads are used for load balancing purposes, that is, queues with higher enqueued workloads are less likely to be chosen for a new request.

TA_PRIO: 1 <= num <= 101

This T_INTERFACE object has the indicated dequeuing priority. If multiple interface requests are waiting on a queue for servicing, the higher priority requests will be handled first.

TA_TIMEOUT: 0 <= num

Time limit (in seconds) for processing individual method invocations for this interface. Servers processing method invocations for this interface will be abortively terminated if they exceed the specified time limit in processing the request. A value of 0 for this attribute indicates that the server should not be abortively terminated.

TA_TRANTIME: 0 <= num

Transaction timeout value in seconds for transactions automatically started for this T_INTERFACE object. Transactions are started automatically when a requests not in transaction mode is received and the T_INTERFACE:TA_AUTOTRAN attribute value for the interface is "Y".

TA_FBROUTINGNAME: string[1..15]

The factory-based routing criteria associated with this interface.

TA_LMID: LMID

Current logical machine on which the queue offering this interface is located.

TA_NUMSERVERS: 0 <= num

Number of corresponding servers offering this interface on this queue.

TA_RTPOLICY: "{always | never |}"

Used to mark an interface implementation as idempotent in the implementation configuration file (ICF). An idempotent implementation can be repeated without any negative side-effects. For example, SET BALANCE.

TA_TPPOLICY: "{method | transaction | process}"

The TP framework deactivation policy. This reflects the policy registered with the framework at server startup. The first server to register the interface sets the value in T_INTERFACE. This value cannot be changed.

TA_TXPOLICY: "{optional | always | never | ignore}"

The transaction policy for the interface. The setting in this attribute affects the effect of the TA_AUTOTRAN attribute. See TA_AUTOTRAN for further explanation. This attribute is always read-only. It is set by the developer when the server is built and registered at server startup.

TA_NCOMPLETED:—>0 <= num

Number of interface method invocations completed since the interface was initially offered.

TA_NQUEUED: 0 <= num

Number of requests currently enqueued for this interface.

TA_CUROBJECTS: 0 <= num

Number of active objects for this interface for associated queue. This number represents the number of entries in the active object table for this queue on the associated machine. This includes objects that are not in memory but that were invoked within an active transaction.

TA_CURTRANSACTIONS: 0 <= num

Number of active global transactions associated with this interface for its associated queue.