File Formats, Data Descriptions, MIBs, and System Processes Reference
The T_SERVICE
class represents configuration attributes of services within an application. These attribute values identify and characterize configured services. A T_SERVICE
object provides activation time configuration attributes for services not specifically configured as part of the T_SVCGRP
class. Run-time information about services active in the application is provided solely through the T_SVCGRP
class. Run-time updates to the T_SERVICE
class are usually not reflected in active T_SVCGRP
objects (TA_ROUTINGNAME
is the exception).
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()
, the following hierarchy exists for determining the attribute values to be used at service startup time.
T_SVCGRP
object exists (matching service name and server group), the attributes defined in that object are used to initially configure the advertised service.T_SERVICE
object exists (matching service name), the attributes defined in that object are used to initially configure the advertised service.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 a 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)
).
(k)— |
A GET
operation will retrieve configuration information for the selected T_SERVICE
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 information for the selected T_SERVICE
object. The following states indicate the meaning of a TA_STATE
set in a SET
request. States not listed may not be set.
Automatically begin a transaction ("
Y"
) when a service request message is received for this service if the request is not already in transaction mode. Limitation: Run-time updates to this attribute are not reflected in active T_SVCGRP
objects.
This T_SERVICE
object imposes the indicated load on the system. Service loads are used for load balancing purposes, that is, queues with higher enqueued workloads are less likely to be chosen for a new request. Service loads have meaning only if the T_DOMAIN
:TA_LDBAL
attribute value is set to "Y"
.
Limitation: Run-time updates to this attribute are not reflected in active T_SVCGRP
objects.
This T_SERVICE
object has the indicated dequeuing priority. If multiple service requests are waiting on a queue for servicing, the higher priority requests will be serviced first.
Limitation: Run-time updates to this attribute are not reflected in active T_SVCGRP
objects.
Blocktime limit, in seconds, indicating the minimum amount of time a blocking API call will delay before timing out for a particular service. This attribute lets the client know that (after a specified time in seconds), no reply has been received by the server while the service request is still processing.
If not specified, the default is 0 which indicates that the system-wide BLOCKTIME
value specified in the UBBCONFIG RESOURCES
section is used for the service.
Limitations: Run-time updates to this attribute are not reflected in active T_SVCGRP
objects.
Time limit (in seconds) for processing requests for this service name. Servers processing service requests for this service will be abortively terminated (kill -9) if they exceed the specified time limit in processing the request. A value of 0 for this attribute indicates that the service should not be abortively terminated.
Limitations: Run-time updates to this attribute are not reflected in active T_SVCGRP
objects. This attribute value is not enforced on BEA Tuxedo release 4.2.2 sites or earlier.
Transaction timeout value in seconds for transactions automatically started for this T_SERVICE
object. Transactions are started automatically when a request not in transaction mode is received and the T_SERVICE
:TA_AUTOTRAN
attribute value for the service is "Y
".
Limitation: Run-time updates to this attribute are not reflected in active T_SVCGRP
objects.
TA_BUFTYPE
: "
type1
[:subtype1
[,subtype2 . . .
]][;type2
[:subtype3
[, . . . ]]] . . . "
List of types and subtypes of data buffers accepted by this service. Up to 32 type/subtype combinations are allowed. Types of data buffers provided with the BEA Tuxedo system are FML
and FML32
(for FML buffers), XML
(for XML buffers), VIEW
, VIEW32
, X_C_TYPE
, or X_COMMON
(for FML views), STRING
(for NULL
terminated character arrays), and CARRAY
or X_OCTET
(for a character array that is neither encoded nor decoded during transmission). Of these types, only VIEW
, VIEW32
, X_C_TYPE
, and X_COMMON
have subtypes. A VIEW
subtype gives the name of the particular VIEW
expected by the service. Application types and subtypes can also be added (see tuxtypes(5)
). For a buffer type that has subtypes, "*" can be specified for the subtype to indicate that the service accepts all subtypes for the associated buffer type.
A single service can only interpret a fixed number of buffer types, namely those found in its buffer type switch (see tuxtypes(5)
). If the TA_BUFTYPE
attribute value is set to ALL
, that service accepts all buffer types found in its buffer type switch.
A type name can be 8 characters or less in length and a subtype name can be 16 characters or less in length. Note that type and subtype names should not contain semicolon, colon, comma, or asterisk characters.
Limitation: This attribute value represents the buffer types that must be supported by each and every instance of an application service with this service name. Since this attribute value is processed at service activation time, updates to this attribute are allowed only when there are no active T_SVCGRP
objects with matching service names.
This T_SERVICE
object has the indicated routing criteria name. Active updates to this attribute will be reflected in all associated T_SVCGRP
objects.
If set to "Y"
, every instance of this service requires a digital signature on its input message buffer. If not specified, the default is "N"
. This attribute applies only to applications running BEA Tuxedo 7.1 or later software.
TA_SIGNATURE_REQUIRED
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_SERVICE
class. Setting SIGNATURE_REQUIRED
to "Y"
at a particular level means that signatures are required for all processes running at that level or below.
If set to "Y"
, every instance of this service requires an encrypted input message buffer. If not specified, the default is "N"
. This attribute applies only to applications running BEA Tuxedo 7.1 or later software.
TA_ENCRYPTION_REQUIRED
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_SERVICE
class. Setting TA_ENCRYPTION_REQUIRED
to Y
at a particular level means that encryption is required for all processes running at that level or below.
Converts an input XML buffer to an FML/FML32 buffer before being delivered to the service and converts the output FML/FML32 buffer to an XML buffer before being returned.
The XML2FML32
value initiates XML to FML32 conversion. The XML2FML
value initiates XML to FML conversion. The NOCONVERT
value indicates no conversion takes place.
Limitation: Run-time updates to this attribute are not reflected in active T_SVCGRP
objects.