File Formats, Data Descriptions, MIBs, and System Processes Reference
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. For those servers that are defined to the system as multicontexted, placeholder values are reported for per-context attributes. Per-context attributes can always be found as part of the T_SERVERCTXT
class. The T_SERVERCTXT
class is defined even for single-contexted servers.
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.
(k)— |
T_DOMAIN
class.Logical name of the server group. Server group names cannot contain an asterisk (*), comma, or colon.
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, 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. See the discussion of the T_MACHINE
:TA_ENVFILE
attribute for a more detailed discussion of how environment variables are handled.
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.
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.
Create |
|
Modify an existing |
|
Delete |
|
Activate the |
|
Deactivate the |
|
Deactivate the |
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.
Command line options to be passed to server when it is activated. See reference page servopts(5)
for details. Limitation: Run-time modifications to this attribute will not affect a running server.
TA_ENVFILE
: string
[0..256] (up to 78 bytes for BEA Tuxedo 8.0 or earlier)
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.
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, 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.
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, 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.
Maximum number of occurrences of the server to be booted. Initially, tmboot()
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.
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, 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.
Specifies the number of server dispatch threads started on initial server boot. This attribute is effective only if the server has been built with the buildserver -t
command.
The separate dispatcher thread that is used when TA_MAXDISPATCHTHREADS
> 1 is not counted as part of the TA_MINDISPATCHTHREADS
value. It is required that TA_MINDISPATCHTHREADS
<= TA_MAXDISPATCHTHREADS
. If TA_MINDISPATCHTHREADS
is not specified, the default is 0.
Limitation: Run-time modifications to this attribute will not affect a running server.
Specifies the maximum number of concurrently dispatched threads which each server process may spawn. This attribute is effective only if the server has been built with the buildserver -t
command.
If TA_MAXDISPATCHTHREADS
> 1, a separate dispatcher thread is used and does not count against this limit. It is required that TA_MINDISPATCHTHREADS
<= TA_MAXDISPATCHTHREADS
. If TA_MAXDISPATCHTHREADS
is not specified, the default is 1.
Limitation: Run-time modifications to this attribute will not affect a running server.
Size of the stack created for each dispatch thread in a multithreaded server. This option has an effect on the server only when a value greater than 1 is specified for TA_MAXDISPATCHTHREADS
.
If this attribute is not specified or if the value specified is 0, a default thread stack size is used. If the value specified is bigger than 0 and less than a minimum thread stack size, the minimum thread stack size is used. If the value specified is bigger than that minimum thread stack size, value specified is used.
The default size used is the operating system default size unless that value is known to be insufficient for a multithreaded BEA Tuxedo application, in which case the BEA Tuxedo default size is used. The purpose of the minimum thread stack size is to allow customer to specify less thread stack size than Tuxedo default thread stack size. Currently, the BEA Tuxedo default thread stack size is 1,024,000, and minimum thread stack size is 100,000.
Note that if the thread stack size is exceeded, the server will core dump.
Limitation: Run-time modifications to this attribute will not affect a running server.
Highest number of active service dispatch threads created for this server since its last restart. This number may differ from the number of service calls, since an administrator may specify parameters that control the caching of idle service threads.
TA_RCMD
: string
[0..256] (up to 78 bytes for BEA Tuxedo 8.0 or earlier)
Application specified command to be executed in parallel with the system restart of an application server.
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, 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.
Note: If you choose to do redirection or piping on a Windows 2003 system, you must use one of the following methods:
cmd
. For example:cmd /c ipconfig > out.txt
AllocConsole()
API functionRestartable ("Y"
) or non-restartable ("N"
) server. If server migration is specified for this server group (T_DOMAIN
:TA_OPTIONS/MIGRATE
attribute and T_GROUP
:TA_LMID
attribute with alternate site), TA_RESTART
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, 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.
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()
in increasing order of sequence number and shutdown by tmshutdown()
in decreasing order. Run-time modifications to this attribute affect only tmboot()
and tmshutdown()
and will affect the order in which running servers may be shutdown by a subsequent invocation of tmshutdown()
.
Mode used by BEA Tuxedo system libraries within this server process to gain access to BEA Tuxedo system's internal tables. See the T_DOMAIN
:TA_SYSTEM_ACCESS
attribute for a complete discussion of this attribute.
Limitations: (1) Run-time modifications to this attribute will not affect a running server. (2) Setting TA_SYSTEM_ACCESS
to PROTECTED
may not be effective for multithreaded servers because it is possible that while one thread is executing BEA Tuxedo code, which means it is attached to the bulletin board, another thread might be executing user code. The BEA Tuxedo system cannot prevent such situations.
Allocate a separate reply queue for the server (TA_REPLYQ == "Y"
). MSSQ servers that expect to receive replies should set this attribute to "Y"
.
Note: If you choose to do redirection or piping on a Windows 2003 system, you must use one of the methods listed in the description of the TA_RCMD
attribute.
UNIX system permissions for the server's reply queue. If a separate reply queue is not allocated (T_SERVER
:TA_REPLYQ == "N"
), TA_RPPERM
is ignored.
Note: If you choose to do redirection or piping on a Windows 2003 system, you must use one of the methods listed in the description of the TA_RCMD
attribute.
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.
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.
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.
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.
UNIX system message queue identifier for the server's reply queue. If a separate reply queue is not allocated (T_SERVER
:TA_REPLYQ == "N"
), the TA_RPID
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.
UNIX system message queue identifier for the server's request queue. If a separate reply queue is not allocated (T_SERVER
:TA_REPLYQ == "N"
) the TA_RQID
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.
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.
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.
The number of service and interface cache entries kept on this machine. A value of "
0"
implies that service caching is not used on this machine. If the value is "DEFAULT"
, the value for this server will come from the corresponding T_MACHINE
class entry.
Security principal name identification string to be used for authentication purposes by an application running BEA Tuxedo 7.1 or later software. This attribute may contain a maximum of 511 characters (excluding the terminating NULL character). The principal name specified for this attribute becomes the identity of the system processes running on this server.
TA_SEC_PRINCIPAL_NAME
can be specified at any of the following four levels in the configuration hierarchy: T_DOMAIN
class, T_MACHINE
class, T_GROUP
class, and T_SERVER
class. A principal name at a particular configuration level can be overridden at a lower level. If TA_SEC_PRINCIPAL_NAME
is not specified at any of these levels, the principal name for the application defaults to the TA_DOMAINID
string for this domain.
Note that TA_SEC_PRINCIPAL_NAME
is one of a trio of attributes, the other two being TA_SEC_PRINCIPAL_LOCATION
and TA_SEC_PRINCIPAL_PASSVAR
. The latter two attributes pertain to opening decryption keys during application booting for the system processes running in a BEA Tuxedo 7.1 or later application. When only TA_SEC_PRINCIPAL_NAME
is specified at a particular level, the system sets each of the other two attributes to a NULL
(zero length) string.
Location of the file or device where the decryption (private) key for the principal specified in TA_SEC_PRINCIPAL_NAME
resides. This attribute may contain a maximum of 511 characters (excluding the terminating NULL character).
TA_SEC_PRINCIPAL_LOCATION
can be specified at any of the following four levels in the configuration hierarchy: T_DOMAIN
class, T_MACHINE
class, T_GROUP
class, and T_SERVER
class. When specified at any of these levels, this attribute must be paired with the TA_SEC_PRINCIPAL_NAME
attribute; otherwise, its value is ignored. (TA_SEC_PRINCIPAL_PASSVAR
is optional; if not specified, the system sets it to a NULL
—zero length—string.)
Variable in which the password for the principal specified in TA_SEC_PRINCIPAL_NAME
is stored. This attribute may contain a maximum of 511 characters (excluding the terminating NULL character).
TA_SEC_PRINCIPAL_PASSVAR
can be specified at any of the following four levels in the configuration hierarchy: T_DOMAIN
class, T_MACHINE
class, T_GROUP
class, and T_SERVER
class. When specified at any of these levels, this attribute must be paired with the TA_SEC_PRINCIPAL_NAME
attribute; otherwise, its value is ignored. (TA_SEC_PRINCIPAL_LOCATION
is optional; if not specified, the system sets it to a NULL
—zero length—string.)
During initialization, the administrator must provide the password for each of the decryption keys configured with TA_SEC_PRINCIPAL_PASSVAR
. The system automatically encrypts the password entered by the administrator and assigns each encrypted password to the associated password variable.
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.
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.
This field element is also contained in the T_SERVERCTXT
class, both for single-context servers and for multicontext servers.
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, a NULL string is returned as a placeholder.
UNIX system process identifier for the initiating client or server.
This field element is also contained in the T_SERVERCTXT
class, both for single-context servers and for multicontext servers.
The value in this field has meaning only for single-context servers; in multicontexted servers 0 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.
The initiating client or server is expecting a reply ("Y"
) or is not expecting a reply ("N"
).
This field element is also contained in the T_SERVERCTXT
class, both for single-context servers and for multi-context servers.
The value in this field has meaning only for single-context servers; in multicontexted servers a NULL string is returned as a placeholder.
Setting of the TP_COMMIT_CONTROL
characteristic for this server.
This field element is also contained in the T_SERVERCTXT
class, both for single-context servers and for multi-context servers.
See the description of the ATMI function call tpscmt()
for details on this characteristic. The value in this field has meaning only for single-context servers; in multicontext servers a NULL string is returned as a placeholder.
Number of conversations initiated by this server via tpconnect()
that are still active. For multicontext servers, this field represents the total for all server contexts. Values for individual server contexts can be found in the T_SERVERCTXT
class.
Number of requests initiated by this server via tpcall()
or tpacall()
that are still active. For multicontext servers, this field represents the total for all server contexts. Values for individual server contexts can be found in the T_SERVERCTXT
class.
Service name that the server is currently working on, if any.
This field element is also contained in the T_SERVERCTXT
class, both for single-context servers and for multicontext servers.
The value in this field has meaning only for single-context servers; in multicontext servers 0 is returned as a placeholder.
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.
Server group number (T_GROUP
:TA_GRPNO
) of the last service request made or conversation initiated from this server outward.
This field element is also contained in the T_SERVERCTXT
class, both for single-context servers and for multicontext servers.
The value in this field has meaning only for single-context servers; in multicontexted servers 0 is returned as a placeholder.
Time left, in seconds, for this server to process the current service request, if any.
This field element is also contained in the T_SERVERCTXT
class, both for single-context servers and for multicontext servers.
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 a multicontext server 0 is returned as a placeholder.
Time left, in seconds, for this server to receive the reply for which it is currently waiting before it will time out.
This field element is also contained in the T_SERVERCTXT
class, both for single-context servers and for multicontext servers.
This timeout may be a transactional timeout or a blocking timeout.
The value in this field has meaning only for single-context servers; in a multicontext server 0 is returned as a placeholder.
This field element is also contained in the T_SERVERCTXT
class, both for single-context servers and for multicontext servers.
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 0 is returned as a placeholder.