Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary
WebLogic Enterprise Doc Home   |   Tuxedo ATMI Topics   |   Previous Topic   |   Next Topic   |   Contents   |   Index

The T_SERVER class represents configuration and run-time attributes of servers within an application. These attribute values identify and characterize configured servers as well as provide run-time tracking of statistics and resources associated with each server object. Information returned will always include fields that are common among all contexts of a server. In addition, for those servers that are not defined to the system as multicontexted (that is, those for which the value of TA_MAXDISPATCHTHREADS is 1), this class includes information about the server's context.

The TA_CLTLMID, TA_CLTPID, TA_CLTREPLY, TA_CMTRET, TA_CURCONV, TA_CURREQ, TA_CURRSERVICE, TA_LASTGRP, TA_SVCTIMEOUT, TA_TIMELEFT, and TA_TRANLEV attributes are specific to each server dispatch context. All other attributes are common to all server dispatch contexts.

TA_CLASSPATH, TA_JAVAHEAPSIZE, TA_JAVAHEAPUSE, TA_JAVAVERSION, and TA_JAVAVENDOR apply to Java servers only.

Table 0-39 T_SERVER Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_SRVGRP( r )( * )	string	ru-r--r--	string[1...30]	N/A
TA_SRVID( r )( * )	long	ru-r--r--	1 <= num < 30,001	N/A
TA_SERVERNAME( k )( r )	string	rw-r--r--	string[1...78]	N/A
TA_SRVTYPE	string	r--r--r--	JAVA	N/A
TA_GRPNO( k )	long	r--r--r--	1 <= num < 30,000	N/A
TA_STATE( k )	string	rwxr-xr--	GET:"{ACT|INA|MIG|CLE| RES|SUS|PAR|DEA}" SET:"{NEW|INV|ACT|INA |DEA}"	N/A N/A
TA_BASESRVID	long	r--r--r--	1 <= num < 30,001	N/A
TA_CLOPT	string	rwyr--r--	string[0...256]	"-A"
TA_ENVFILE	string	rwyr--r--	string[0...78]	""
TA_GRACE	long	rwyr--r--	0 <= num	86,400
TA_MAXGEN	long	rwyr--r--	1 <= num < 256	1
TA_MAX	long	rwxr--r--	1 <= num < 1,001	1
TA_MIN	long	rwyr--r--	1 <= num < 1,001	1
TA_RCMD	string	rwyr--r--	string[0...78]	""
TA_RESTART	string	rwyr--r--	"{Y|N}"	N
TA_SEQUENCE( k )	long	rwxr--r--	1 <= num < 10,000	>= 10,000
TA_SYSTEM_ACCESS	string	rwyr--r--	"{FASTPATH|PROTECTED}"	(1)
TA_CONV( k )	string	rw-r--r--	"{Y|N}"	N
TA_REPLYQ	string	rw-r--r--	"{Y|N}"	N
TA_RPPERM	long	rw-r--r--	0001 <= num <= 0777	(1)
TA_RQADDR( k )	string	rw-r--r--	string[0...30]	"GRPNO.SRVID"
TA_RQPERM	long	rw-r--r--	0001 <= num <= 0777	(1)
TA_LMID( k )	string	R--R--R--	LMID	N/A
TA_GENERATION	long	R--R--R--	1 <= num < 32K	N/A
TA_PID( k )	long	R--R--R--	1 <= num	N/A
TA_RPID	long	R--R--R--	1 <= num	N/A
TA_RQID	long	R--R--R--	1 <= num	N/A
TA_TIMERESTART	long	R--R--R--	1 <= num	N/A
TA_TIMESTART	long	R--R--R--	1 <= num	N/A
T_SERVER Class: LOCAL Attributes
TA_CLASSPATH	string	R--R--R--	string[0...2,047]	N/A
TA_JAVAHEAPSIZE	long	R--R--R--	0<num
TA_JAVAHEAPUSE	long	R--R--R--	1<=num<=100	N/A
TA_JAVAVENDOR	string	R--R--R--	string[0...30]	N/A
TA_JAVAVERSION	string	R--R--R--	string[0...30]	N/A
TA_MAXDISPATCHTHREADS	long	R--R--R--	0<num	N/A
TA_NUMCONV	long	R-XR-XR--	0 <= num	N/A
TA_NUMDEQUEUE	long	R-XR-XR--	0 <= num	N/A
TA_NUMENQUEUE	long	R-XR-XR--	0 <= num	N/A
TA_NUMPOST	long	R-XR-XR--	0 <= num	N/A
TA_NUMREQ	long	R-XR-XR--	0 <= num	N/A
TA_NUMSUBSCRIBE	long	R-XR-XR--	0 <= num	N/A
TA_NUMTRAN	long	R-XR-XR--	0 <= num	N/A
TA_NUMTRANABT	long	R-XR-XR--	0 <= num	N/A
TA_NUMTRANCMT	long	R-XR-XR--	0 <= num	N/A
TA_THREADSTACKSIZE	long	R--R--R--	0<num	N/A
TA_TOTREQC	long	R-XR-XR--	0 <= num	N/A
TA_TOTWORKL	long	R-XR-XR--	0 <= num	N/A
TA_CLTLMID	string	R--R--R--	LMID	N/A
TA_CLTPID	long	R--R--R--	1 <= num	N/A
TA_CLTREPLY	string	R--R--R--	"{Y|N}"	N/A
TA_CMTRET	string	R--R--R--	"{COMPLETE|LOGGED}"	N/A
TA_CURCONV	long	R--R--R--	0 <= num	N/A
TA_CURDISPATCHTHREADS	long	R--R--R--	0<num	N/A
TA_CUROBJECTS	long	R--R--R--	0 <= num	N/A
TA_CURINTERFACE	string	R--R--R--	string[0..128]	N/A
TA_CURREQ	long	R--R--R--	0 <= num	N/A
TA_CURRSERVICE	string	R--R--R--	string[0...15]	N/A
TA_CURTIME	long	R--R--R--	1 <= num	N/A
TA_HWDISPATCHTHREADS	long	R--R--R--	0<num	N/A
TA_LASTGRP	long	R--R--R--	1 <= num < 30,000	N/A
TA_SVCTIMEOUT	long	R--R--R--	0 <= num	N/A
TA_TIMELEFT	long	R--R--R--	0 <= num	N/A
TA_TRANLEV	long	R--R--R--	0 <= num	N/A
( k ) - GET key field ( r ) - Required field for object creation (SET TA_STATE NEW) ( * ) - GET/SET key, one or more required for SET operations

¹Defaults to value set for this attribute in Class T_DOMAIN.

TA_SRVGRP: string[1...30]

Logical name of the server group. Server group names cannot contain an asterisk (*), comma, or colon.

TA_SRVID: 1 <= num < 30,001

Unique (within the server group) server identification number.

TA_SERVERNAME: string[1...78]

Name of the server executable file. The server identified by TA_SERVERNAME will run on the machine(s) identified by the T_GROUP:TA_LMID attribute for this server's server group. If a relative pathname is given, then the search for the executable file is done first in TA_APPDIR, then in TA_TUXDIR/bin, then in /bin and /usr/bin, and then in <path>, where <path> is the value of the first PATH= line appearing in the machine environment file, if one exists. Note that the attribute value returned for an active server will always be a full pathname. The values for TA_APPDIR and TA_TUXDIR are taken from the appropriate T_MACHINE object. For a more detailed discussion of how environment variables are handled, see the T_MACHINE:TA_ENVFILE attribute.

TA_GRPNO: 1 <= num < 30,000

Group number associated with this server's group.

TA_STATE:

GET:{ACTive|INActive|MIGrating|CLEaning|REStarting|SUSpended|PARtitioned|DEAd}

A GET operation will retrieve configuration and run-time information for the selected T_SERVER object(s). 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_SERVER object defined and active. This is not an indication of whether the server is idle or busy. An active server with a non 0-length TA_CURRSERVICE attribute should be interpreted as a busy server, that is, one that is processing a service request.
INActive	T_SERVER object defined and inactive.
MIGrating	T_SERVER object defined and currently in a state of migration to the server group's secondary logical machine. The secondary logical machine is the one listed in T_GROUP:TA_LMID attribute that does not match the T_GROUP:TA_CURLMID attribute. This state is ACTive equivalent for the purpose of determining permissions.
CLEaning	T_SERVER object defined and currently being cleaned up by the system after an abnormal death. Note that restartable servers may enter this state if they exceed TA_MAXGEN starts/restarts within their TA_GRACE period. This state is ACTive equivalent for the purpose of determining permissions.
REStarting	T_SERVER object defined and currently being restarted by the system after an abnormal death. This state is ACTive equivalent for the purpose of determining permissions.
SUSpended	T_SERVER object defined and currently suspended pending shutdown. This state is ACTive equivalent for the purpose of determining permissions.
PARtitioned	T_SERVER object defined and active; however, the machine where the server is running is currently partitioned from the T_DOMAIN:TA_MASTER site. This state is ACTive equivalent for the purpose of determining permissions.
DEAd	T_SERVER object defined, identified as active in the Bulletin Board, but currently not running due to an abnormal death. This state will exist only until the BBL local to the server notices the death and takes action (REStarting|CLEaning). Note that this state will only be returned if the MIB_LOCAL TA_FLAGS value is specified and the machine where the server was running is reachable. This state is ACTive equivalent for the purpose of determining permissions.

SET: {NEW|INValid|ACTive|INActive|DEAd}

A SET operation will update configuration and run-time information for the selected T_SERVER object. The following states indicate the meaning of a TA_STATE set in a SET request. States not listed may not be set.

NEW	Create T_SERVER object for application. State change allowed only when in the INValid state. Successful return leaves the object in the INActive state.
unset	Modify an existing T_SERVER object. This combination is allowed only when in the ACTive or INActive state. Successful return leaves the object state unchanged.
INValid	Delete T_SERVER object for application. State change allowed only when in the INActive state. Successful return leaves the object in the INValid state.
ACTive	Activate the T_SERVER object. State change allowed only when in the INActive state. (Servers in the MIGrating state must be restarted by setting the T_GROUP:TA_STATE to ACTive.) For the purpose of determining permissions for this state transition, the active object permissions are considered (that is, --x--x--x). Successful return leaves the object in the ACTive state. The TMIB_NOTIFY TA_FLAG value should be used when activating a server if status on the individual server is required.
INActive	Deactivate the T_SERVER object. State change allowed only when in the ACTive state. Successful return leaves the object in the INActive state. The TMIB_NOTIFY TA_FLAG value should be used when deactivating a server if status on the individual server is required.
DEAd	Deactivate the T_SERVER object by sending the server a SIGTERM signal followed by a SIGKILL signal if the server is still running after the appropriate timeout interval (see TA_MIBTIMEOUT in MIB(5)). Note that by default, a SIGTERM signal will cause the server to initiate orderly shutdown and the server will become inactive even if it is restartable. If a server is processing a long running service or has chosen to disable the SIGTERM signal, then SIGKILL may be used and will be treated by the system as an abnormal termination. State change allowed only when in the ACTive or SUSpended state. Successful return leaves the object in the INActive, CLEaning or REStarting state.

TA_BASESRVID: 1 <= num < 30,001

Base server identifier. For servers with a TA_MAX attribute value of 1, this attribute will always be the same as TA_SRVID. However, for servers with a TA_MAX value greater than 1, this attribute indicates the base server identifier for the set of servers configured identically.

TA_CLASSPATH string[0...2,047]

The current CLASSPATH for the runtime.

TA_CLOPT: string[0...256]

Command-line options to be passed to server when it is activated. See the servopts(5) reference page for details. Limitation: Run-time modifications to this attribute will not affect a running server.

TA_ENVFILE: string[0...78]

Server specific environment file. See T_MACHINE:TA_ENVFILE for a complete discussion of how this file is used to modify the environment. Limitation: Run-time modifications to this attribute will not affect a running server.

TA_GRACE: 0 <= num

The period of time, in seconds, over which the T_SERVER:TA_MAXGEN limit applies. This attribute is meaningful only for restartable servers, that is, if the T_SERVER:TA_RESTART attribute is set to "Y". When a restarting server would exceed the TA_MAXGEN limit but the TA_GRACE period has expired, the system resets the current generation (T_SERVER:TA_GENERATION) to 1 and resets the initial boot time (T_SERVER:TA_TIMESTART) to the current time. A value of 0 for this attribute indicates that a server should always be restarted.

Note that servers sharing a request queue (that is, equal values for T_SERVER:TA_RQADDR) should have equal values for this attribute. If they do not, then the first server activated will establish the run-time value associated with all servers on the queue.

Limitation: Run-time modifications to this attribute will affect a running server and all other active servers with which it is sharing a request queue. However, only the selected server's configuration parameter is modified. Thus, the behavior of the application depends on the order of boot in subsequent activations unless the administrator ensures that all servers sharing a queue have the same value for this attribute.

TA_JAVAHEAPSIZE 0<num

The heap size as specified in the run-time options.

TA_JAVAHEAPUSE 1<=num<=100

The percentage of heap space used.

TA_MAXGEN: 1 <= num < 256

Number of generations allowed for a restartable server (T_SERVER:TA_RESTART == "Y") over the specified grace period (T_SERVER:TA_GRACE). The initial activation of the server counts as one generation and each restart also counts as one. Processing after the maximum generations is exceeded is discussed above with respect to TA_GRACE.

Note that servers sharing a request queue (that is, equal values for T_SERVER:TA_RQADDR) should have equal values for this attribute. If they do not, then the first server activated will establish the run-time value associated with all servers on the queue.

Limitation: Run-time modifications to this attribute will affect a running server and all other active servers with which it is sharing a request queue. However, only the selected server's configuration parameter is modified. Thus, the behavior of the application depends on the order of boot in subsequent activations unless the administrator ensures that all servers sharing a queue have the same value for this attribute.

TA_MAXDISPATCHTHREADS 0<num

The maximum number of threads, as specified with -M in the CLOPT.

TA_MAX: 1 <= num < 1,001

Maximum number of occurrences of the server to be booted. Initially, tmboot(3c) boots T_SERVER:TA_MIN objects of the server, and additional objects may be started individually (by starting a particular server ID) or through automatic spawning (conversational servers only). Run-time modifications to this attribute will affect all running servers in the set of identically configured servers (see TA_BASESRVID above) as well as the configuration definition of the server.

TA_MIN: 1 <= num < 1,001

Minimum number of occurrences of the server to be booted by. If a T_SERVER:TA_RQADDR is specified and TA_MIN is greater than 1, then the servers will form an MSSQ set. The server identifiers for the servers will be T_SERVER:TA_SRVID up to TA_SRVID + T_SERVER:TA_MAX - 1. All occurrences of the server will have the same sequence number, as well as any other server parameters.

Limitation: Run-time modifications to this attribute will not affect a running server.

TA_RCMD: string[0...78]

Application specified command to be executed in parallel with the system restart of an application server. This command must be an executable UNIX system file.

Note that servers sharing a request queue (that is, equal values for T_SERVER:TA_RQADDR) should have equal values for this attribute. If they do not, then the first server activated will establish the run-time value associated with all servers on the queue.

Limitation: Run-time modifications to this attribute will affect a running server and all other active servers with which it is sharing a request queue. However, only the selected server's configuration parameter is modified. Thus, the behavior of the application depends on the order of boot in subsequent activations unless the administrator ensures that all servers sharing a queue have the same value for this attribute.

TA_RESTART: {Y|N}

Restartable ("Y") or non-restartable ("N") server. If server migration is specified for this server group (T_DOMAIN:TA_OPTIONS/MIGRATE and T_GROUP:TA_LMID with alternate site), then this attribute must be set to "Y".

Note that servers sharing a request queue (that is, equal values for T_SERVER:TA_RQADDR) should have equal values for this attribute. If they do not, then the first server activated will establish the run-time value associated with all servers on the queue.

Limitation: Run-time modifications to this attribute will affect a running server and all other active servers with which it is sharing a request queue. However, only the selected server's configuration parameter is modified. Thus, the behavior of the application depends on the order of boot in subsequent activations unless the administrator ensures that all servers sharing a queue have the same value for this attribute.

TA_SEQUENCE: 1 <= num < 10,000

Specifies when this server should be booted (tmboot(1) ) or shutdown (tmshutdown(1)) relative to other servers. T_SERVER objects added without a TA_SEQUENCE attribute specified or with an invalid value will have one generated for them that is 10,000 or more and is higher than any other automatically selected default. Servers are booted by tmboot(1) in increasing order of sequence number and shut down by tmshutdown(1) in decreasing order. Run-time modifications to this attribute affect onlytmboot(1) and tmshutdown(1) and will affect the order in which running servers may be shut down by a subsequent invocation of tmshutdown(1).

TA_SYSTEM_ACCESS: {FASTPATH|PROTECTED}

Mode used by BEA Tuxedo system libraries within this server process to gain access to BEA Tuxedo system's internal tables. See T_DOMAIN:TA_SYSTEM_ACCESS for a complete discussion of this attribute.

Limitation: Run-time modifications to this attribute will not affect a running server.

TA_CONV: {Y|N}

Conversational server ("Y") or request/response server ("N").

TA_HWDISPATCHTHREADS

The high water mark for the number of threads in the server.

TA_REPLYQ: {Y|N}

Allocate a separate reply queue for the server (TA_REPLYQ == "Y"). MSSQ servers that expect to receive replies should set this attribute to "Y".

TA_RPPERM: 0001 <= num <= 0777

UNIX system permissions for the server's reply queue. If a separate reply queue is not allocated (T_SERVER:TA_REPLYQ == "N"), then this attribute is ignored. Limitation: This is a UNIX system specific attribute that may not be returned if the platform on which the application is being run is not UNIX-based.

TA_RQADDR: string[0...30]

Symbolic address of the request queue for the server. Specifying the same TA_RQADDR attribute value for more than one server is the way multiple server, single queue (MSSQ) sets are defined. Servers with the same TA_RQADDR attribute value must be in the same server group.

TA_RQPERM: 0001 <= num <= 0777

UNIX system permissions for the server's request queue.

Limitation: This is a UNIX system specific attribute that may not be returned if the platform on which the application is being run is not UNIX-based.

TA_LMID: LMID

Current logical machine on which the server is running.

TA_GENERATION: 1 <= num < 32K

Generation of the server. When a server is initially booted via tmboot(1) or activated through the TM_MIB(5), its generation is set to 1. Each time the server dies abnormally and is restarted, its generation is incremented. Note that when T_SERVER:TA_MAXGEN is exceeded and T_SERVER:TA_GRACE has expired, the server will be restarted with the generation reset to 1.

TA_PID: 1 <= num

UNIX system process identifier for the server. Note that this may not be a unique attribute since servers may be located on different machines allowing for duplication of process identifiers.

Limitation: This is a UNIX system specific attribute that may not be returned if the platform on which the application is being run is not UNIX-based.

TA_RPID: 1 <= num

UNIX system message queue identifier for the server's reply queue. If a separate reply queue is not allocated (T_SERVER:TA_REPLYQ == "N"), then this attribute value will be the same as T_SERVER:TA_RQID.

Limitation: This is a UNIX system specific attribute that may not be returned if the platform on which the application is being run is not UNIX-based.

TA_RQID: 1 <= num

UNIX system message queue identifier for the server's request queue. If a separate reply queue is not allocated (T_SERVER:TA_REPLYQ == "N"), then this attribute value will be the same as T_SERVER:TA_RPID.

Limitation: This is a UNIX system specific attribute that may not be returned if the platform on which the application is being run is not UNIX-based.

TA_THREADSTACKSIZE 0<num

The stack size per thread as specified in the run-time options.

TA_TIMERESTART: 1 <= num

Time, in seconds, since 00:00:00 UTC, January 1, 1970, as returned by the time(2) system call on T_SERVER:TA_LMID, when the server was last started or restarted.

TA_TIMESTART: 1 <= num

Time, in seconds, since 00:00:00 UTC, January 1, 1970, as returned by the time(2) system call on T_SERVER:TA_LMID, when the server was first started. Restarts of the server do not reset this value; however, if T_SERVER:TA_MAXGEN is exceeded and T_SERVER:TA_GRACE is expired, this attribute will be reset to the time of the restart.

TA_NUMCONV: 0 <= num

Number of conversations initiated by this server via tpconnect(3c).

TA_NUMDEQUEUE: 0 <= num

Number of dequeue operations initiated by this server via tpdequeue(3c).

TA_NUMENQUEUE: 0 <= num

Number of enqueue operations initiated by this server via tpenqueue(3c).

TA_NUMPOST: 0 <= num

Number of postings initiated by this server via tppost(3c).

TA_NUMREQ: 0 <= num

Number of requests made by this server via tpcall(3c) or tpacall(3c).

TA_NUMSUBSCRIBE: 0 <= num

Number of subscriptions made by this server via tpsubscribe(3c).

TA_NUMTRAN: 0 <= num

Number of transactions begun by this server since its last (re)start.

TA_NUMTRANABT: 0 <= num

Number of transactions aborted by this server since its last (re)start.

TA_NUMTRANCMT: 0 <= num

Number of transactions committed by this server since its last (re)start.

TA_TOTREQC: 0 <= num

Total number of requests completed by this server. For conversational servers (T_SERVER:TA_CONV == "Y"), this attribute value indicates the number of completed incoming conversations. This is a run-time attribute that is kept across server restart but is lost at server shutdown.

TA_TOTWORKL: 0 <= num

Total workload completed by this server. For conversational servers (T_SERVER:TA_CONV == "Y"), this attribute value indicates the workload of completed incoming conversations. This is a run-time attribute that is kept across server restart but is lost at server shutdown.

TA_CLTLMID: LMID

Logical machine for the initiating client or server. The initiating client or server is the process that made the service request on which the server is currently working. The value in this field has meaning only for single-context servers. In multicontext servers, the null string is returned as a placeholder.

TA_CLTPID: 1 <= num

UNIX system process identifier for the initiating client or server. The value in this field has meaning only for single-context servers. In multicontext servers, -1 is returned as a placeholder.

Limitation: This is a UNIX system-specific attribute that may not be returned if the platform on which the application is being run is not UNIX-based.

TA_CLTREPLY: {Y|N}

The initiating client or server is expecting a reply ("Y") or is not expecting a reply ("N"). The value in this field has meaning only for single-context servers. In multicontext servers, the null string is returned as a placeholder.

TA_CMTRET: {COMPLETE|LOGGED}

Setting of the TP_COMMIT_CONTROL characteristic for this server. See the description of the ATMI function call tpscmt(3c) for details on this characteristic. The value in this field has meaning only for single-context servers. In multicontext servers, the null string is returned as a placeholder.

TA_CURCONV: 0 <= num

Number of conversations initiated by this server via tpconnect(3c) that are still active. For multicontext servers, this field represents the total for all server contexts.

TA_CURDISPATCHTHREADS

The current number of threads in the server.

TA_CUROBJECTS

The number of entries in use in the Bulletin Board object table for this server. Scope is local.

TA_CURINTERFACE

The interface name of the interface currently active in this server. Scope is local.

TA_CURREQ: 0 <= num

Number of requests initiated by this server via tpcall(3c) or tpacall(3c) that are still active. For multicontext servers, this field represents the total for all server contexts.

TA_CURRSERVICE: string[0 . . . 15]

Service name that the server is currently working on, if any. The value in this field has meaning only for single-context servers. In multicontext servers, the null string is returned as a placeholder.

TA_CURTIME: 1 <= num

Current time, in seconds, since 00:00:00 UTC, January 1, 1970, as returned by the time(2) system call on T_SERVER:TA_LMID. This attribute can be used to compute elapsed time from the T_SERVER:TA_TIMESTART and T_SERVER:TA_TIMERESTART attribute values.

TA_LASTGRP: 1 <= num < 30,000

Server group number (T_GROUP:TA_GRPNO) of the last service request made or conversation initiated from this server outward. The value in this field has meaning only for single-context servers. In multicontext servers, -1 is returned as a placeholder.

TA_SVCTIMEOUT: 0 <= num

Time left, in seconds, for this server to process the current service request, if any. A value of 0 for an active service indicates that no timeout processing is being done. See T_SERVICE:TA_SVCTIMEOUT for more information. The value in this field has meaning only for single-context servers. In multicontext servers, -1 is returned as a placeholder.

TA_TIMELEFT: 0 <= num

Time left, in seconds, for this server to receive the reply for which it is currently waiting before it will timeout. This timeout may be a transactional timeout or a blocking timeout. The value in this field has meaning only for single-context servers. In multicontext servers, -1 is returned as a placeholder.

TA_TRANLEV: 0 <= num

Current transaction level for this server. 0 indicates that the server is not currently involved in a transaction. The value in this field has meaning only for single-context servers. In multicontext servers, -1 is returned as a placeholder.

None.