T_MACHINE CLASS

Overview

The T_MACHINE class represents application attributes pertaining to a particular machine. These attribute values represent machine characteristics, per-machine sizing, statistics, customization options, and UNIX System filenames.

Attribute Table

T_MACHINE Class Definition Attribute Table

Attribute Type Permissions Values Default

TA_LMID( r )( * )1

string

rU-r--r--

string[1...30]

N/A

TA_PMID( r )( * )1

string

rU-r--r--

string[1...30]

N/A

TA_TUXCONFIG( r )

string

rw-r--r--

string[2...64]

N/A

TA_TUXDIR( r )

string

rw-r--r--

string[2...78]

N/A

TA_APPDIR( r )

string

rw-r--r--

string[2...78]

N/A

TA_STATE( k )

string

rwyr-yr--

GET:"{ACT|INA|PAR}"
SET:"{NEW|INV|ACT|RAC|INA|FIN|CLE}"

N/A
N/A

TA_UID

long

rw-r--r--

0 <= num

(²)

TA_GID

long

rw-r--r--

0 <= num

(²)

TA_ENVFILE

string

rwyr--r--

string[0...78]

""

TA_PERM

long

rwyr--r--

0001 <= num <= 0777

(²)

TA_ULOGPFX

string

rwyr--r--

string[0...78]

(³)

TA_TYPE

string

rw-r--r--

string[0...15]

""

TA_MAXACCESSERS

long

rw-r--r--

1 <= num < 32K

(²)

TA_MAXCONV

long

rw-r--r--

0 <= num < 32K

(²)

TA_MAXGTT

long

rw-r--r--

0 <= num < 32K

(²)

TA_MAXWSCLIENTS

long

rw-r--r--

0 <= num < 32K

0

TA_MAXACLCACHE

long

rw-r--r--

10 <= num <= 32000

100

TA_TLOGDEVICE

string

rw-r--r--

string[0...64]

""

TA_TLOGNAME

string

rw-r--r--

string[0...30]

TLOG

TA_TLOGSIZE

long

rw-r--r--

1 <= num < 2K+1

100

TA_BRIDGE

string

rw-r--r--

string[0...78]

N/A

TA_NADDR

string

rw-r--r--

string[0...78]

N/A

TA_NLSADDR

string

rw-r--r--

string[0...78]

N/A

TA_CMPLIMIT

string

rwyr-yr--

"remote[,local]"

MAXLONG,MAXLONG

TA_TMNETLOAD

long

rwyr-yr--

0 <= num < 32K

0

TA_SPINCOUNT

long

rwyr-yr--

0 <= num

0

TA_ROLE

string

r--r--r--

"{MASTER|BACKUP|OTHER}"

N/A

TA_MINOR

long

R--R--R--

1 <= num

N/A

TA_RELEASE

long

R--R--R--

1 <= num

N/A

TA_MINENCRYPTBIT

string

rwxrwx---

{ 0 | 40 | 128 }

0

TA_MAXENCRYPTBIT

string

rwxrwx---

{ 0 | 40 | 128 }

128

TA_MAXPENDINGBYTES

long

rw-r--r--

100000 <= num <= MAXLONG

2147483647

( k ) - GET key field
( r ) - Required field for object creation (SET TA_STATE NEW)
( * ) - GET/SET key, one or more required for SET operations

**T_MACHINE Class Definition Attribute Table**
Attribute	Type	Permissions	Values	Default
`TA_LMID( r )( * )1`	string	rU-r--r--	string[1...30]	N/A
`TA_PMID( r )( * )1`	string	rU-r--r--	string[1...30]	N/A
`TA_TUXCONFIG( r )`	string	rw-r--r--	string[2...64]	N/A
`TA_TUXDIR( r )`	string	rw-r--r--	string[2...78]	N/A
`TA_APPDIR( r )`	string	rw-r--r--	string[2...78]	N/A
`TA_STATE( k )`	string	rwyr-yr--	`GET`:"{`ACT\|INA\|PAR`}" `SET`:"`{NEW\|INV\|ACT\|RAC\|INA\|FIN\|CLE}`"	N/A N/A
`TA_UID`	long	rw-r--r--	0 <= num	(²)
`TA_GID`	long	rw-r--r--	0 <= num	(²)
`TA_ENVFILE`	string	rwyr--r--	string[0...78]	""
`TA_PERM`	long	rwyr--r--	0001 <= num <= 0777	(²)
`TA_ULOGPFX`	string	rwyr--r--	string[0...78]	(³)
`TA_TYPE`	string	rw-r--r--	string[0...15]	""
`TA_MAXACCESSERS`	long	rw-r--r--	1 <= num < 32K	(²)
`TA_MAXCONV`	long	rw-r--r--	0 <= num < 32K	(²)
`TA_MAXGTT`	long	rw-r--r--	0 <= num < 32K	(²)
`TA_MAXWSCLIENTS`	long	rw-r--r--	0 <= num < 32K	`0`
`TA_MAXACLCACHE`	long	rw-r--r--	10 <= num <= 32000	`100`
`TA_TLOGDEVICE`	string	rw-r--r--	string[0...64]	""
`TA_TLOGNAME`	string	rw-r--r--	string[0...30]	`TLOG`
`TA_TLOGSIZE`	long	rw-r--r--	1 <= num < 2K+1	`100`
`TA_BRIDGE`	string	rw-r--r--	string[0...78]	N/A
`TA_NADDR`	string	rw-r--r--	string[0...78]	N/A
`TA_NLSADDR`	string	rw-r--r--	string[0...78]	N/A
`TA_CMPLIMIT`	string	rwyr-yr--	"remote[,local]"	`MAXLONG,MAXLONG`
`TA_TMNETLOAD`	long	rwyr-yr--	0 <= num < 32K	`0`
`TA_SPINCOUNT`	long	rwyr-yr--	0 <= num	`0`
`TA_ROLE`	string	r--r--r--	"{`MASTER\|BACKUP\|OTHER`}"	N/A
`TA_MINOR`	long	R--R--R--	1 <= num	N/A
`TA_RELEASE`	long	R--R--R--	1 <= num	N/A
`TA_MINENCRYPTBIT`	string	rwxrwx---	{ 0 \| 40 \| 128 }	0
`TA_MAXENCRYPTBIT`	string	rwxrwx---	{ 0 \| 40 \| 128 }	128
`TA_MAXPENDINGBYTES`	long	rw-r--r--	`100000 <=` `num` `<= MAXLONG`	2147483647
( k ) - `GET` key field ( r ) - Required field for object creation (`SET TA_STATE NEW`) ( * ) - `GET/SET` key, one or more required for `SET` operations

**T_MACHINE Class: Local Attributes**
Attribute	Type	Permissions	Values	Default
`TA_CURACCESSERS`	long	R--R--R--	0 <= num < 32K	N/A
`TA_CURCLIENTS`	long	R--R--R--	0 <= num < 32K	N/A
`TA_CURCONV`	long	R--R--R--	0 <= num < 32K	N/A
`TA_CURGTT`	long	R--R--R--	0 <= num < 32K	N/A
`TA_CURRLOAD`	long	R--R--R--	0 <= num	N/A
`TA_CURWSCLIENTS`	long	R--R--R--	0 <= num < 32K	N/A
`TA_HWACCESSERS`	long	R--R--R--	0 <= num < 32K	N/A
`TA_HWCLIENTS`	long	R--R--R--	0 <= num < 32K	N/A
`TA_HWCONV`	long	R--R--R--	0 <= num < 32K	N/A
`TA_HWGTT`	long	R--R--R--	0 <= num < 32K	N/A
`TA_HWWSCLIENTS`	long	R--R--R--	0 <= num < 32K	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_PAGESIZE`	long	R--R--R--	1 <= num	N/A
`TA_SWRELEASE`	string	R--R--R--	string[0...78]	N/A
`TA_HWACLCACHE`	long	R--R--R--	0 <= num	N/A
`TA_ACLCACHEHITS`	long	R--R--R--	0 <= num	N/A
`TA_ACLCACHEACCESS`	long	R--R--R--	0 <= num	N/A
`TA_ACLFAIL`	long	R--R--R--	0 <= num	N/A
`TA_WKCOMPLETED`	long	R--R--R--	0 <= num	N/A
`TA_WKINITIATED`	long	R--R--R--	0 <= num	N/A

¹TA_LMID and TA_PMID must each be unique within this class. Only one of these fields is required as a key field for a SET operation. If both are specified, then they must match the same object.

²Default is same as value set for this attribute in Class T_DOMAIN.

³Default is TA_APPDIR for this machine followed by /ULOG.

Attribute Semantics

TA_LMID: string[1...30]

Logical machine identifier. This identifier is used within the rest of the TM_MIB definition as the sole means of mapping application resources to T_MACHINE objects.

TA_PMID: string[1...30]

Physical machine identifier. This identifier should match the UNIX System nodename as returned by the \Q\Quname -n'' command when run on the identified system.

TA_TUXCONFIG: string[2...64]

Absolute pathname of the file or device where the binary BEA TUXEDO system configuration file is found on this machine. The administrator need only maintain one such file, namely the one identified by the TA_TUXCONFIG attribute value on the master machine. The information contained in this file is automatically propagated to all other T_MACHINE objects as they are activated. See TA_ENVFILE in this class for a discussion of how this attribute value is used in the environment.

TA_TUXDIR: string[2...78]

Absolute pathname of the directory where the BEA TUXEDO system software is found on this machine. See TA_ENVFILE in this class for a discussion of how this attribute value is used in the environment.

TA_APPDIR: string[2...78]

Colon separated list of application directory absolute pathnames. The first directory serves as the current directory for all application and administrative servers booted on this machine. All directories in the list are searched when starting application servers. See TA_ENVFILE in this class for a discussion of how this attribute value is used in the environment.

TA_STATE: GET: {ACTive|INActive|PARtitioned} A GET operation will retrieve configuration and run-time information for the selected T_MACHINE 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_MACHINE object defined and active (administrative servers, that is, DBBL, BBL, and BRIDGE). INActive T_MACHINE object defined and inactive. PARtitioned T_MACHINE object defined, listed in accessible bulletin boards as active, but currently unreachable. This state is ACTive equivalent for the purpose of determining permissions. SET:{NEW|INValid|ACTive|ReACtivate|INActive|ForceINactive|CLEaning} A SET operation will update configuration and run-time information for the selected T_MACHINE 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_MACHINE 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_MACHINE object. This combination is allowed only when in the ACTive or INActive state. Successful return leaves the object state unchanged. INValid Delete T_MACHINE 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_MACHINE object. Necessary administrative servers such as the DBBL, BBL, and BRIDGE are started on the indicated site as well as application servers configured to run on that site (subject to restriction by TA_FLAGS settings). For the purpose of determining permissions for this state transition, the active object permissions are considered (that is, --x--x--x). State change allowed only when in the INActive state. Successful return leaves the object in the ACTive state. The TMIB_NOTIFY TA_FLAG value should be used when activating a machine if status on individual servers is required. ReACtivate Activate the T_MACHINE object. Necessary administrative servers such as the DBBL, BBL, and BRIDGE are started on the indicated site as well as application servers configured to run on that site (subject to restriction by TA_FLAGS settings). For the purpose of determining permissions for this state transition, the active object permissions are considered (that is, --x--x--x). State change allowed only when in either the ACTive or INActive state. Successful return leaves the object in the ACTive state. The TMIB_NOTIFY TA_FLAG value should be used when reactivating a machine if status on individual servers is required. INActive Deactivate the T_MACHINE object. Necessary administrative servers such as the BBL and BRIDGE are stopped on the indicated site as well as application servers running on that site (subject to restriction by TA_FLAGS settings). State change allowed only when in the ACTive state and when no other application resources are active on the indicated machine. Successful return leaves the object in the INActive state. The TMIB_NOTIFY TA_FLAG value should be used when deactivating a machine if status on individual servers is required. ForceINactive Deactivate the T_MACHINE object without regard to attached clients. Necessary administrative servers such as the BBL and BRIDGE are stopped on the indicated site as well as application servers running on that site (subject to restriction by TA_FLAGS settings). 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 machine if status on individual servers is required. CLEaning Initiate cleanup/scanning activities on and relating to the indicated machine. If there are dead clients or servers on the machine, they will be detected at this time. If the machine has been partitioned from the application MASTER site, then global bulletin board entries for that machine will be removed. This combination is allowed when the application is in the ACTive state and the T_MACHINE object is in either the ACTive or PARtitioned state. Successful return for a non-partitioned machine leaves the state unchanged. Successful return for a partitioned machine leaves the object in the INActive state. Limitation: State change to ForceINactive or INActive allowed only for non-master machines. The master site administrative processes are deactivated via the T_DOMAIN class.

TA_UID: 0 <= num

`ACTive`	`T_MACHINE` object defined and active (administrative servers, that is, DBBL, BBL, and `BRIDGE`).
`INActive`	`T_MACHINE` object defined and inactive.
`PARtitioned`	`T_MACHINE` object defined, listed in accessible bulletin boards as active, but currently unreachable. This state is `ACTive` equivalent for the purpose of determining permissions.

`NEW`	Create `T_MACHINE` 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_MACHINE` object. This combination is allowed only when in the `ACTive` or `INActive` state. Successful return leaves the object state unchanged.
`INValid`	Delete `T_MACHINE` 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_MACHINE` object. Necessary administrative servers such as the DBBL, BBL, and `BRIDGE` are started on the indicated site as well as application servers configured to run on that site (subject to restriction by `TA_FLAGS` settings). For the purpose of determining permissions for this state transition, the active object permissions are considered (that is, --x--x--x). State change allowed only when in the `INActive` state. Successful return leaves the object in the `ACTive` state. The `TMIB_NOTIFY TA_FLAG` value should be used when activating a machine if status on individual servers is required.
`ReACtivate`	Activate the `T_MACHINE` object. Necessary administrative servers such as the DBBL, BBL, and `BRIDGE` are started on the indicated site as well as application servers configured to run on that site (subject to restriction by `TA_FLAGS` settings). For the purpose of determining permissions for this state transition, the active object permissions are considered (that is, --x--x--x). State change allowed only when in either the `ACTive` or `INActive` state. Successful return leaves the object in the `ACTive` state. The `TMIB_NOTIFY TA_FLAG` value should be used when reactivating a machine if status on individual servers is required.
`INActive`	Deactivate the `T_MACHINE` object. Necessary administrative servers such as the BBL and `BRIDGE` are stopped on the indicated site as well as application servers running on that site (subject to restriction by `TA_FLAGS` settings). State change allowed only when in the `ACTive` state and when no other application resources are active on the indicated machine. Successful return leaves the object in the `INActive` state. The `TMIB_NOTIFY TA_FLAG` value should be used when deactivating a machine if status on individual servers is required.
`ForceINactive`	Deactivate the `T_MACHINE` object without regard to attached clients. Necessary administrative servers such as the BBL and `BRIDGE` are stopped on the indicated site as well as application servers running on that site (subject to restriction by `TA_FLAGS` settings). 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 machine if status on individual servers is required.
`CLE`aning	Initiate cleanup/scanning activities on and relating to the indicated machine. If there are dead clients or servers on the machine, they will be detected at this time. If the machine has been partitioned from the application `MASTER` site, then global bulletin board entries for that machine will be removed. This combination is allowed when the application is in the `ACTive` state and the `T_MACHINE` object is in either the `ACTive` or `PARtitioned` state. Successful return for a non-partitioned machine leaves the state unchanged. Successful return for a partitioned machine leaves the object in the `INActive` state.

UNIX System user identifier for the BEA TUXEDO system application administrator on this machine. Administrative commands such as tmboot(1), tmshutdown(1), and tmadmin(1) must run as the indicated user on this machine. Application and administrative servers on this machine will be started as this user.

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

UNIX System group identifier for the BEA TUXEDO system application administrator on this machine. Administrative commands such as tmboot(1), tmshutdown(1), and tmadmin(1) must run as part of the indicated group on this machine. Application and administrative servers on this machine will be started as part of this 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.

TA_ENVFILE: string[0...78]

Environment file for clients and servers running on this machine. If the value specifies an invalid file name, no values are added to the environment. the value of string is placed into the environment.

When booting servers, local servers inherit the environment of tmboot(1) and remote servers (not on the MASTER) inherit the environment of tlisten(1). TUXCONFIG, TUXDIR, and APPDIR are also put into the environment when a server is booted based on the information in the associated T_MACHINE object. PATH will be set in the environment to

   APPDIR:TUXDIR/bin:/bin:/usr/bin:<path>

where <path> is the value of the first PATH= line appearing in the machine environment file, if one exists (subsequent PATH= lines will be ignored). This PATH will be used as a search path for servers that are specified with a simple or relative pathname (i.e., that doesn't begin with slash). LD_LIBRARY_PATH will be set in the environment to

   APPDIR:TUXDIR/lib:/lib:/usr/lib:<lib>

where <lib> is the value of the first LD_LIBRARY_PATH= line appearing in the machine environment file, if one exists (subsequent LD_LIBRARY_PATH= lines will be ignored).

As part of server initialization (before tpsvrinit (3c) is called), a server will read and export variables from both the machine and server ENVFILE files. If a variable is set in both the machine and server ENVFILE, the value in the server ENVFILE will override the value in the machine ENVFILE with the exception of PATH which is appended. A client will process only the machine ENVFILE file. When the machine and server ENVFILE files are processed, lines that are not of the form <ident>= will be ignored, where <ident> begins with an underscore or alphabetic character, and contains only underscore or alphanumeric characters. If a PATH= line is encountered, PATH will be set to

APPDIR:TUXDIR/bin:/bin:/usr/bin:<path>

where <path> is the value of the first PATH= line appearing in the environment file (subsequent PATH= lines are ignored). If PATH appears in both the machine and server files, then <path> is <path1>:<path2> where <path1> is from the machine ENVFILE and <path2> is from the server ENVFILE. If a LD_LIBRARY_PATH= line is encountered, LD_LIBRARY_PATH will be set to

APPDIR:TUXDIR/lib:/lib:/usr/lib:<lib>

where <lib> is the value of the first LD_LIBRARY_PATH= line appearing in the environment file (subsequent LD_LIBRARY_PATH= lines are ignored). Attempts to reset TUXDIR, APPDIR, or TUXCONFIG will be ignored and a warning will be printed if the value does not match the corresponding T_MACHINE attribute value. Limitation: Modifications to this attribute for an active object will not affect running servers or clients.

TA_PERM: 0001 <= num <= 0777

UNIX System permissions associated with the shared memory bulletin board created on this machine. Default UNIX System permissions for system and application message queues.

Limitations: Modifications to this attribute for an active object will not affect running servers or clients.

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_ULOGPFX: string[0...78]

Absolute pathname prefix of the path for the userlog (3c) file on this machine. The userlog (3c) file name is formed by appending the string .mmddyy to the TA_ULOGPFX attribute value. mmddyy represents the month, day, and year that the messages were generated. All application and system userlog (3c) messages generated by clients and servers running on this machine are directed to this file.

Limitation: Modifications to this attribute for an active object will not affect running servers or clients.

TA_TYPE: string[0...15]

Machine type. Used to group machines into classes of like data representations. Data encoding is not performed when communicating between machines of identical types. This attribute can be given any string value; values are used only for comparison. Distinct TA_TYPE attributes should be set when the application spans a heterogeneous network of machines or when compilers generate dissimilar structure representations. The default for this attribute, a 0-length string, matches any other machine with a 0-length string as its TA_TYPE attribute value.

TA_MAXACCESSERS: 1 <= num < 32K

Maximum number of clients and servers that can have access to the bulletin board on this machine at one time. System administration processes such as the BBL and tmadmin need not be accounted for in this figure, but all application servers and clients and TMS servers should be counted. If the application is booting workstation listeners on this site, then both the listeners and the potential number of workstation handlers that may be booted should be counted.

TA_MAXCONV: 0 <= num < 32K

Maximum number of simultaneous conversations in which clients and servers on this machine can be involved.

TA_MAXGTT: 0 <= num < 32K

Maximum number of simultaneous global transactions in which this machine can be involved.

TA_MAXWSCLIENTS: 0 <= num < 32K

Number of accesser entries on this machine to be reserved for workstation clients. The number specified here takes a portion of the total accesser slots specified with the TA_MAXACCESSERS attribute. The appropriate setting of this parameter helps to conserve IPC resources since workstation client access to the system is multiplexed through a BEA TUXEDO system supplied surrogate, the workstation handler. It is an error to set this number greater than TA_MAXACCESSERS.

TA_MAXACLCACHE: 10 <= num <= 32000

Number of entries in the cache used for ACL entries when TA_SECURITY is set to ACL or MANDATORY_ACL. The appropriate setting of this parameter helps to conserve on shared memory resources and yet reduce the number of disk access to do ACL checking.

TA_TLOGDEVICE: string[0...64]

The device (raw slice) or UNIX System file containing the BEA TUXEDO filesystem that holds the DTP transaction log for this machine. The DTP transaction log is stored as a BEA TUXEDO system VTOC table on the device. This device or file may be the same as that specified for the TA_TUXCONFIG attribute for this machine.

TA_TLOGNAME: string[0...30]

The name of the DTP transaction log for this machine. If more than one DTP transaction log exists on the same TA_TLOGDEVICE, they must have unique names. TA_TLOGNAME must be different from the name of any other table on the TA_TLOGDEVICE where the DTP transaction log table is created.

TA_TLOGSIZE: 1 <= num 2K+1

The numeric size, in pages, of the DTP transaction log for this machine. The TA_TLOGSIZE attribute value is subject to limits based on available space in the BEA TUXEDO filesystem identified by the TA_TLOGDEVICE attribute.

TA_BRIDGE: string[0...78]

Device name to be used by the BRIDGE process placed on this logical machine to access the network. This is a required value for participation in a networked application via a TLI-based BEA TUXEDO system binary. This attribute is not needed for sockets-based BEA TUXEDO system binaries.

TA_NADDR: string[0...78]

Specifies the complete network address to be used by the BRIDGE process placed on the logical machine as its listening address. The listening address for a BRIDGE is the means by which it is contacted by other BRIDGE processes participating in the application. This attribute must be set if the logical machine is to participate in a networked application, that is, if the LAN option is set in the T_DOMAIN:TA_OPTIONS attribute value.

If string has the form "0xhex-digits" or "\\xhex-digits", it must contain an even number of valid hex digits. These forms are translated internally into a character array containing the hexadecimal representations of the string specified. For TCP/IP addresses either the

"//hostname:port"

"//#.#.#.#:port"

format is used.

TA_NLSADDR: string[0...78]

Network address used by the tlisten(1) process servicing the network on the node identified by this logical machine. This network address is of the same format as that specified for the TA_NADDR attribute above.

This attribute must be set if the logical machine is to participate in a networked application, that is, if the LAN option is set in the T_DOMAIN:TA_OPTIONS attribute value.

TA_CMPLIMIT: remote[,local]

Threshold message size at which compression will occur for remote traffic and optionally local traffic. remote and local may be either non-negative numeric values or the string "MAXLONG", which is dynamically translated to the maximum long setting for the machine. Setting only the remote value will default local to MAXLONG.

Limitation: This attribute value is not part of the T_MACHINE object for active sites running BEA TUXEDO system Release 4.2.2 or earlier. However, site release identification is not determined until run-time, so this attribute may be set and accessed for any inactive object. When a BEA TUXEDO system Release 4.2.2 or earlier site is activated, the configured value is not used.

TA_TMNETLOAD: 0 <= num < 32K

Service load added to any remote service evaluated during load balancing on this machine.

Limitation: This attribute value is not part of the T_MACHINE object for active sites running BEA TUXEDO System Release 4.2.2 or earlier. However, site release identification is not determined until runtime, so this attribute may be set and accessed for any inactive object. When a BEA TUXEDO System Release 4.2.2 or earlier site is activated, the configured value is not used.

TA_SPINCOUNT: 0 <= num

Spincount used on this machine for pre-ticket user level semaphore access. Defaults are built into the BEA TUXEDO system binaries on each machine. These defaults may be overridden at runtime for tuning purposes using this attribute. The spincount may be reset to the default built-in value for the site by resetting this attribute value to 0. There is also a TMSPINCOUNT environment variable, which the system uses if the value is not set here or in the ubbconfig file.

Limitation: This attribute value is not part of the T_MACHINE object for active sites running BEA TUXEDO System Release 4.2.2 or earlier. However, site release identification is not determined until runtime, so this attribute may be set and accessed for any inactive object. When a BEA TUXEDO system Release 4.2.2 or earlier site is activated, the configured value is not used.

TA_ROLE: {MASTER|BACKUP|OTHER}

The role of this machine in the application. MASTER indicates that this machine is the master machine, BACKUP indicates that it is the backup master machine, and OTHER indicates that the machine is neither the master nor backup master machine.

TA_MINOR: 1 <= num

The BEA TUXEDO system minor protocol release number for this machine.

TA_RELEASE: 1 <= num

The BEA TUXEDO system major protocol release number for this machine. This may be different from the TA_SWRELEASE for the same machine.

MINENCRYPTBITS={0|40|128}

When establishing a network link to this machine, require at least this minimum level of encryption. "0" means no encryption, while "40" and "128" specify the encryption key length (in bits). If this minimum level of encryption cannot be met, link establishment will fail. The default is "0".

Limitation: Modifications to this attribute will not effect established network links.

MAXENCRYPTBITS={0|40|128}

When establishing a network link, negotiate encryption up to this level. "0" means no encryption, whilc "40" and "128" specify the encryption length (in bits). The default is "128".

Limitation: Modifications to this attribute will not effect established network links.

TA_MAXPENDINGBYTES: 100000 <= num <= MAXLONG

specifies a limit for the amount of space that can be allocated for messages waiting to be transmitted by the BRIDGE process.

TA_CURACCESSERS: 0 <= num < 32K

Number of clients and servers currently accessing the application either directly on this machine or through a workstation handler on this machine.

TA_CURCLIENTS: 0 <= num < 32K

Number of clients, both native and workstation, currently logged in to this machine.

TA_CURCONV: 0 <= num < 32K

Number of active conversations with participants on this machine.

TA_CURGTT: 0 <= num < 32K

Number of in use transaction table entries on this machine.

TA_CURRLOAD: 0 <= num

Current service load enqueued on this machine. Limitation: If the T_DOMAIN:TA_LDBAL attribute is "N" or the T_DOMAIN:TA_MODEL attribute is "MP", then an FML32 NULL value is returned (0).

TA_CURWSCLIENTS: 0 <= num < 32K

Number of workstation clients currently logged in to this machine.

TA_HWACCESSERS: 0 <= num < 32K

High water number of clients and servers accessing the application either directly on this machine or through a workstation handler on this machine.

TA_HWCLIENTS: 0 <= num < 32K

High water number of clients, both native and workstation, logged in to this machine.

TA_HWCONV: 0 <= num < 32K

High water number of active conversations with participants on this machine.

TA_HWGTT: 0 <= num < 32K

High water number of in use transaction table entries on this machine.

TA_HWWSCLIENTS: 0 <= num < 32K

High water number of workstation clients currently logged in to this machine.

TA_NUMCONV: 0 <= num

Number of tpconnect (3c) operations performed from this machine.

TA_NUMDEQUEUE: 0 <= num

Number of tpdequeue (3c) operations performed from this machine.

TA_NUMENQUEUE: 0 <= num

Number of tpenqueue (3c) operations performed from this machine.

TA_NUMPOST: 0 <= num

Number of tppost (3c) operations performed from this machine.

TA_NUMREQ: 0 <= num

Number of tpacall (3c) or tpcall (3c) operations performed from this machine.

TA_NUMSUBSCRIBE: 0 <= num

Number of tpsubscribe (3c) operations performed from this machine.

TA_NUMTRAN: 0 <= num

Number of transactions initiated ( tpbegin (3c)) from this machine.

TA_NUMTRANABT: 0 <= num

Number of transactions aborted ( tpabort (3c)) from this machine.

TA_NUMTRANCMT: 0 <= num

Number of transactions committed ( tpcommit (3c)) from this machine.

TA_PAGESIZE: 1 <= num

Disk pagesize used on this machine.

TA_SWRELEASE: string[0...78]

Software release for binary on that machine or a 0-length string if binary is not a BEA TUXEDO system master binary.

TA_HWACLCACHE: 0 <= num

High water number of entries used in the ACL cache.

TA_ACLCACHEHITS: 0 <= num

Number of accesses to the ACL cache that resulted in a "hit" (that is, the entry was already in the cache).

TA_ACLCACHEACCESS: 0 <= num

Number of accesses to the ACL cache.

TA_ACLFAIL: 0 <= num

Number of accesses to the ACL cache that resulted in a access control violation.

TA_WKCOMPLETED: 0 <= num

Total service load dequeued and processed successfully by servers running on this machine. Note that for long running applications this attribute may wraparound, that is, exceed the maximum value for a long, and start back at 0 again.

TA_WKINITIATED: 0 <= num

Total service load enqueued by clients/servers running on this machine. Note that for long running applications this attribute may wraparound, that is, exceed the maximum value for a long, and start back at 0 again.

Limitations

SHM mode (see T_DOMAIN:TA_MODEL) applications can have only one T_MACHINE object. MP mode (see T_DOMAIN:TA_MODEL) applications with the LAN option set (see T_DOMAIN:TA_OPTIONS) may have up to the maximum number of configurable T_MACHINE objects as defined by the T_DOMAIN:TA_MAXMACHINES attribute. Many attributes of this class are tunable only when the application is inactive on the site. Since the master machine at least must be active in a minimumly active application, the use of the ATMI interface routines to administer the application is not possible with respect to the master machine object. The function tpadmcall (3c) is being provided as a means configuring an unbooted application and may be used to set these attributes for the master machine.

[Top] [Prev] [Next] [Bottom]