![]() |
![]() |
|
|
T_SVCGRP CLASS
Overview
The T_SVCGRP class represents configuration and run-time attributes of services/groups within an application. These attribute values identify and characterize configured services/groups, and provide run-time tracking of statistics and resources associated with each object.
Both the T_SERVICE class and the T_SVCGRP class define activation time attribute settings for service names within the application. When a new service is activated (advertised), either due to initial activation of a server or due to a call to tpadvertise(3c), the following hierarchy exists for determining the attribute values to be used at service startup time.
The specification of configuration attributes for application services is completely optional, that is, services advertised by servers as they are activated will take on the established default service attribute values if configured values are not available (see above for description of how attribute values are identified at service activation time). Service names to be offered by a server are built in at run-time (see buildserver(1)) and may be overridden by the command-line options specified for a server object (see T_SERVER:TA_CLOPT and servopts(5)).
Once a T_SVCGRP object is active, it is represented solely by the T_SVCGRP class. A particular service name/group name combination may have more than one associated T_SVCGRP class at run-time if there are multiple servers within the group offering the service.
Attribute Table
Attribute |
Type |
Permissions |
Values |
Default |
---|---|---|---|---|
TA_SERVICENAME( r )( * ) |
string |
ru-r--r-- |
string[1...15] |
N/A |
TA_SRVGRP( r )( * ) |
string |
ru-r--r-- |
string[1...30] |
N/A |
TA_GRPNO( k ) |
long |
r--r--r-- |
1 <= num < 30,000 |
N/A |
TA_STATE( k ) |
string |
rwxr-xr-- |
GET:"{ACT|INA |SUS|PAR}" SET:"{NEW|INV |ACT|INA|SUS}" |
N/A N/A |
TA_AUTOTRAN |
string |
rwxr-xr-- |
"{Y|N}" |
"N" |
TA_LOAD |
long |
rwxr-xr-- |
1 <= num < 32K |
50 |
TA_PRIO |
long |
rwxr-xr-- |
1 <= num < 101 |
50 |
TA_SVCTIMEOUT |
long |
rwyr-yr-- |
0 <= num |
0 |
TA_TRANTIME |
long |
rwxr-xr-- |
0 <= num |
30 |
TA_LMID( k ) |
string |
R--R--R-- |
LMID |
N/A |
TA_RQADDR( * ) |
string |
R--R--R-- |
string[1...30] |
N/A |
TA_SRVID( * ) |
long |
R--R--R-- |
1 <= num < 30,001 |
N/A |
TA_SVCRNAM |
string |
R-XR-XR-- |
string[1...15] |
(2) |
TA_BUFTYPE |
string |
r--r--r-- |
string[1...256] |
N/A |
TA_ROUTINGNAME |
string |
r--r--r-- |
string[0...15] |
N/A |
TA_SVCTYPE( k ) |
string |
r--r--r-- |
"{APP|CALLABLE|SYSTEM}" |
"APP" |
T_SVCGRP Class: LOCAL Attributes |
||||
TA_NCOMPLETED |
long |
R-XR-XR-- |
0 <= num |
N/A |
TA_NQUEUED |
long |
R--R--R-- |
0 <= num < 32K |
N/A |
|
1SET operations on this class must specify sufficient key fields to uniquely identify the object being addressed. If the object is active, then it may be necessary to augment the TA_SERVICENAME and TA_SRVGRP key fields with either TA_RQADDR or TA_SRVID. Modifications to an active object will affect that object and the related configuration record but not other active objects that may have derived their run-time attributes from the same configuration record.
2If nothing is specified for this attribute, it defaults to TA_SERVICENAME.
Attribute Semantics
ACTive |
T_SVCGRP object is active within the server identified by the returned values for the TA_SRVGRP and TA_SRVID attributes. Attribute values returned indicate the current run-time instance of the service and may not be reflected in the configuration instance if temporary updates have been performed. |
INActive |
T_SVCGRP object is defined and inactive. |
SUSpended |
T_SVCGRP object defined, active, and currently suspended. This service is not available for access by the application in this state. This state is ACTive equivalent for the purpose of determining permissions. |
PARtitioned |
T_SVCGRP object defined, active, and currently partitioned from the master site of the application. This service is not available for access by the application in this state. This state is ACTive equivalent for the purpose of determining permissions. |
NEW |
Create T_SVCGRP object for application. State change allowed only when in the INValid state. Successful return leaves the object in the INActive state. Limitation: Unconfigured services may still be active by virtue of a server advertising them. In this case, the service class state is ACTive and cannot be updated. |
unset |
Modify an existing T_SVCGRP object. This combination is not allowed in the INValid state. Successful return leaves the object state unchanged. |
INValid |
Delete T_SVCGRP object for application. State change allowed only when in the INActive state. Successful return leaves the object in the INValid state. |
ACTive |
Activate (advertise) the T_SVCGRP object. State change allowed only when in the INActive, SUSpended or INValid states. Either TA_SRVID or TA_RQADDR must be specified with this state change. 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. Limitation: State change not permitted for service names (TA_SERVICENAME) beginning with the reserved string ".". |
INActive |
Deactivate the T_SVCGRP object. State change allowed only when in the SUSpended state. Successful return leaves the object in either the INActive (configured entries) or INValid (unconfigured entries) state. Limitation: State change not permitted for service names (TA_SERVICENAME) beginning with the reserved string "_". |
SUSpended |
Suspend the T_SVCGRP object. State change allowed only when in the ACTive state. Successful return leaves the object in the SUSpended state. Limitation: State change not permitted for service names (TA_SERVICENAME) beginning with the reserved string "_". |
Limitations
None.
![]() |
![]() |
![]() |
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|