Tuxedo
0

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

 Previous Next Contents View as PDF  

T_SERVER Class Definition

Overview

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.

Attribute Table

Table 57 TM_MIB(5): 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_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}"

N/A

SET: "{NEW | INV | ACT | INA | DEA}"

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..256] 2

""

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_MINDISPATCHTHREADS

long

rwyr--r--

1 <= num < 1,000

1

TA_MAXDISPATCHTHREADS

long

rwyr--r--

0 <= num < 1,000

0

TA_THREADSTACKSIZE

long

rwyr--r--

0 <= num <= 2147483647

0

TA_CURDISPATCHTHREADS

long

R-XR-XR--

0 <= num

N/A

TA_HWDISPATCHTHREADS

long

R-XR-XR--

0 <= num

N/A

TA_NUMDISPATCHTHREADS

long

R-XR-XR--

0 <= num

N/A

TA_RCMD

string

rwyr--r--

string[0..256] 2

""

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 < 32,768

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

TA_SEC_PRINCIPAL_NAME

TA_SEC_PRINCIPAL_LOCATION

TA_SEC_PRINCIPAL_PASSVAR

string

string

string

rwxr--r--

rwxr--r--

rwxr--r--

string[0..511]

string[0..511]

string[0..511]

""

""

""

TA_SICACHEENTRIESMAX

string

rw-r--r--

{"0"-"32767" | "DEFAULT"}

"DEFAULT"

T_SERVER Class: LOCAL Attributes

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_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_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_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


  1 Defaults to value set for this attribute in the T_DOMAIN class.
2 Maximum string length for this attribute is 78 bytes for BEA Tuxedo 8.0 or earlier.

Attribute Semantics

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, 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.

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.

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, 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_CLOPT: string[0..256]

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.

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, 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_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, 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_MAX: 1 <= num < 1,001

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.

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, 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_MINDISPATCHTHREADS: 1 <= num < 1,000

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.

TA_MAXDISPATCHTHREADS: 0 <= num < 1,000

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.

TA_THREADSTACKSIZE: 0 <= num <= 2147483647

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 is set to 0, a default thread stack size 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. Currently, the BEA Tuxedo default thread stack size is 1,024,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.

TA_CURDISPATCHTHREADS: 0 <= num

Current number of active service dispatch threads for this server.

TA_HWDISPATCHTHREADS: 0 <= num

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_NUMDISPATCHTHREADS: 0 <= num

Total number of active service dispatch threads for this server since its last restart.

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 2000 system, you must use one of the following methods:

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 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.

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() 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().

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 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.

TA_CONV: "{Y|N}"

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

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".

Note: If you choose to do redirection or piping on a Windows 2000 system, you must use one of the methods listed in the description of the TA_RCMD attribute.

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"), TA_RPPERM is ignored.

Note: If you choose to do redirection or piping on a Windows 2000 system, you must use one of the methods listed in the description of the TA_RCMD attribute.

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 < 32,768

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"), 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.

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") 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.

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_SICACHEENTRIESMAX: {"0"-"32767" | "DEFAULT"}

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.

TA_SEC_PRINCIPAL_NAME: string[0..511]

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.

TA_SEC_PRINCIPAL_LOCATION: string[0..511]

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.)

TA_SEC_PRINCIPAL_PASSVAR: string[0..511]

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.

TA_NUMCONV: 0 <= num

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

TA_NUMDEQUEUE: 0 <= num

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

TA_NUMENQUEUE: 0 <= num

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

TA_NUMPOST: 0 <= num

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

TA_NUMREQ: 0 <= num

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

TA_NUMSUBSCRIBE: 0 <= num

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

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.

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.

TA_CLTPID: 1 <= num

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.

TA_CLTREPLY: "{Y | N}"

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.

TA_CMTRET: "{COMPLETE | LOGGED}"

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.

TA_CURCONV: 0 <= num

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.

TA_CUROBJECTS: 0 <= num

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

TA_CURINTERFACE: string[0..128]

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() 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.

TA_CURRSERVICE: string[0. .15]

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.

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.

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.

TA_SVCTIMEOUT: 0 <= num

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.

TA_TIMELEFT: 0 <= num

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.

TA_TRANLEV: 0 <= num

Current transaction level for this server.

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.

Limitations

None.

 

Back to Top Previous Next
Contact e-docsContact BEAwebmasterprivacy