![]() |
![]() |
|
|
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
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 |
(2) |
TA_GID |
long |
rw-r--r-- |
0 <= num |
(2) |
TA_ENVFILE |
string |
rwyr--r-- |
string[0...78] |
"" |
TA_PERM |
long |
rwyr--r-- |
0001 <= num <= 0777 |
(2) |
TA_ULOGPFX |
string |
rwyr--r-- |
string[0...78] |
(3) |
TA_TYPE |
string |
rw-r--r-- |
string[0...15] |
"" |
TA_MAXACCESSERS |
long |
rw-r--r-- |
1 <= num < 32K |
(2) |
TA_MAXCONV |
long |
rw-r--r-- |
0 <= num < 32K |
(2) |
TA_MAXGTT |
long |
rw-r--r-- |
0 <= num < 32K |
(2) |
TA_MAXWSCLIENTS |
long |
rw-r--r-- |
0 <= num < 32K |
0 |
TA_MAXACLCACHE |
long |
rw-r--r-- |
10 <= num <= 32000 |
100 |
TA_MAXOBJECTS |
long |
rw-r--r-- |
0<=num |
1000 |
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 |
TA_CUROBJECTS |
long |
R--R--R-- |
0 <= num |
NA |
|
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_CUROBJECTS |
long |
R--R--R-- |
0 <= num |
NA |
TA_HWOBJECTS |
long |
R--R--R-- |
0 <= num |
NA |
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 |
1TA_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.
2Default is same as value set for this attribute in Class T_DOMAIN.
3Default is TA_APPDIR for this machine followed by /ULOG.
Attribute Semantics
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. |
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. |
APPDIR:TUXDIR/bin:/bin:/usr/bin:<path>
APPDIR:TUXDIR/lib:/lib:/usr/lib:<lib>
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.
![]() |
![]() |
![]() |
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|