File Formats, Data Descriptions, MIBs, and System Processes Reference
This section provides information on services used by the application. Lines within the SERVICES
section have the form:
where SVCNM
is the (string_value
) name of the service. SVCNM
must be 15 characters or fewer in length.
There are no required parameters. Services need not be listed if no optional parameters need to be set. Optional parameters are:
Specifies that SVCNM
imposes a load on the system of number
. number
can be between 1 and 32,767 inclusive. If not specified, the default is 50. A higher number indicates a greater load.
Specifies that SVCNM
has a dequeuing priority of the specified number. The value must be greater than 0 and less than or equal to 100, with 100 being the highest priority. The default is 50.
A lower priority message does not remain forever enqueued because every tenth message is retrieved on a FIFO basis. Response time should not be a concern of the lower priority interface or service.
This parameter says that any parameters specified apply to SVCNM
within server group string_value
. The use of SRVGRP
allows the same service to have different parameter settings within different server groups. It must be 30 characters or less.
BUFTYPE
=
"
type1
[:
subtype1
[,
subtype2
. . . ]][;
type2
[:s
ubtype3
[,
. . . ]]] . . . "
A list of types and subtypes of data buffers accepted by this service. This parameter can be up to 256 characters in length and a maximum of 32 type/subtype combinations are allowed. The BEA Tuxedo system provides the following types of data buffers: 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 TYPE
that has subtypes, "*" can be specified for the subtype to indicate that the service accepts all subtypes for the associated 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 BUFTYPE
parameter is set to ALL
, that service accepts all buffer types found in its buffer type switch. Omitting the BUFTYPE
parameter is equivalent to setting it to ALL
. If multiple entries exist for the same service name but with different SRVGRP
parameters, the BUFTYPE
parameter must be the same for all of these entries.
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 (this will make it hard to see where type and subtype values end).
BUFTYPE=FML implies that the service takes FML buffers.
BUFTYPE=VIEW:* implies that the service takes all subtypes
of FML views.
When you boot a server with this parameter, the input buffer is converted from an XML type buffer to an FML/FML32 type buffer before being delivered to the service. When the tpreturn(3c) function is called, the FML/FML32 buffer is converted to XML before being returned back to the client.
Specifies the name of the routing criteria used for this service when doing data-dependent routing. The string_value
, which is a ROUTING_CRITERIA_NAME
defined in the ROUTING
section, is the name of the routing criteria used for data-dependent routing for this service. If this parameter is not specified, data-dependent routing is not done for this service. string_value
must be 15 characters or less in length. If multiple entries exist for the same service name but with different SRVGRP
parameters, the ROUTING
parameter must be the same for all of these entries.
Specifies the nontransactional client blocking time value, in seconds, per service indicating the minimum amount of time a blocking API call will delay before timing out for a particular service.
This parameter 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.
numeric_value
can be between 0 and 32,767 inclusive. 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.
Specifies the amount of time, in seconds, that is allowed for processing of the indicated service. The value must be greater than or equal to 0. A value of 0 indicates that the service will not be timed out. A timed-out service will cause the server processing the service request to be terminated with a SIGKILL
signal. Note that this signal affects all threads in the server. The default for this parameter is 0.
Specifies whether or not every instance of this service requires a digital signature on its input message buffer. If not specified, the default is N
. This parameter applies only to applications running BEA Tuxedo 7.1 or later software.
SIGNATURE_REQUIRED
can be specified at any of the following four levels in the configuration hierarchy: RESOURCES
section, MACHINES
section, GROUPS
section, and SERVICES
section. Setting SIGNATURE_REQUIRED
to Y
at a particular level means that signatures are required for all processes running at that level or below.
Specifies whether or not every instance of this service requires an encrypted input message buffer. If not specified, the default is N
. This parameter applies only to applications running BEA Tuxedo 7.1 or later software.
ENCRYPTION_REQUIRED
can be specified at any of the following four levels in the configuration hierarchy: RESOURCES
section, MACHINES
section, GROUPS
section, and SERVICES
section. Setting ENCRYPTION_REQUIRED
to Y
at a particular level means that encryption is required for all processes running at that level or below.