分类:
2009-08-22 13:16:46
BEA TUXEDO System ASCII configuration file
A binary configuration file, called the TUXCONFIG
file, contains information used by tmboot
(1) to start the servers and initialize the bulletin board of a BEA TUXEDO system bulletin board instantiation in an orderly sequence. The binary TUXCONFIG
file cannot be created directly (although an existing TUXCONFIG
file can be dynamically modified through tmconfig
(1)). Initially, a UBBCONFIG
file of the format described on this reference page must be created. That file is parsed and loaded into the TUXCONFIG
file using tmloadcf
(1). tmadmin
(1) uses the configuration file (or a copy of it) in its monitoring activity. tmshutdown
(1) references the configuration file for information needed to shut the application down.
The format of a UBBCONFIG
file is as follows:
The file is made up of up to none specification sections. Lines beginning with an asterisk (*
) indicate the beginning of a specification section. Each such line contains the name of the section immediately following the *
. Allowable section names are: RESOURCES
, MACHINES
, GROUPS
, NETGROUPS
, NETWORK
, SERVERS
, SERVICES
, INTERFACES
, and ROUTING
. The RESOURCES
and MACHINES
sections must be the first two sections in that order; the GROUPS
section must be ahead of SERVERS
, SERVICES
, and ROUTING
. The NETGROUPS
section must ber ahead of the NETWORK
section.
"#
" (pound sign) introduces a comment. A newline ends a comment.
Blank lines and comments are ignored.
Comments can be freely attached to the end of any line.
Lines are continued by placing at least one tab after the newline. Comments can not be continued.
This section provides for user specification of the system-wide resources, such as the number of servers, and services which can exist within a service area. Lines in the RESOURCES
section are of the form: KEYWORD value
where KEYWORD
is the name of the parameter, and value
its associated value. Valid KEYWORDs
are as follows:
IPCKEY
numeric_value
specifies the numeric key for the well-known address in a BEA TUXEDO system bulletin board. In a single processor environment, this key "names" the bulletin board. In a multiple processor environment, this key names the message queue of the DBBL. In addition, this key is used as a basis for deriving the names of resources other than the well-known address, such as the names for bulletin boards throughout a multiprocessor. IPCKEY
must be greater than 32,768 and less than 262,143. This parameter is required.
MASTER
string_value1[,string_value2]
specifies the machine on which the master copy of the TUXCONFIG
is found. Also, if the application is being run in MP
mode, MASTER
names the machine on which the DBBL should be run. string_value2
names an alternate LMID
location used during process relocation and booting. If the primary location is not available, the DBBL is booted at the alternate location and the alternate TUXCONFIG
file found there is used. Both LMID
values must name machines found in the MACHINES
section and must be less than or equal to 30 characters in length. This parameter is required (even in SHM
mode).
In an application that supports multiple release levels of the BEA TUXEDO system on different machines, MASTER
and BACKUP
must always have a release with a number greater than or equal to all other machines in the application. This rule is not enforced during a "Hot Upgrade."
DOMAINID
string_value1
specifies the domain identification string. If not specified, the value "" is used. If the value of DOMAINID
is a character string, it may contain a maximum of 30 characters (including the trailing null). If the value of DOMAINID
is a string of hexadecimal digits, it may contain a maximum of 30 octets. If DOMAINID
is specified, its value is included, as a parameter (-C
dom
=domainid
), in any command output that reports on the processes associated with a particular domain, such as the output of the ps
command. This comment is useful for an administrator managing multiple domains, who may have some difficulty, without this comment, in interpreting a single output stream that refers to several domains.
UID
numeric_value
specifies the numeric user id to be associated with the IPC structures created for the bulletin board. This value should be a UNIX System user id on the local system. If not specified, the value is taken to be the effective user id of the user executing tmloadcf
(1). The RESOURCES
value for this parameter can be overridden in the MACHINES
section on a per-processor basis.
GID
numeric_value
specifies the numeric group id to be associated with the IPC structures created for the bulletin board. This value should be a valid UNIX System group id on the local system. If GID
is not specified, the effective group id of the user executing tmloadcf
(1) is used. The RESOURCES
value for this parameter can be overridden in the MACHINES
section on a per-processor basis.
MAXACCESSERS
numeric_value
specifies the default maximum number of processes that can have access to a bulletin board on a particular processor at any one time. System administration processes, such as the BBL and tmadmin
, need not be accounted for in this figure. This value must be greater than 0 and less than 32,768. If not specified, the default is 50. The RESOURCES
value for this parameter can be overridden in the MACHINES
section on a per-processor basis.
MAXSERVERS
numeric_value
specifies the maximum number of servers to be accommodated in the server table of the bulletin board. This value must be greater than 0 and less than 8192. If not specified, the default is 50.
MAXSERVICES
numeric_value
specifies the maximum total number of services to be accommodated in the services table of the bulletin board. This value must be greater than 0 and less than 32,768. If not specified, the default is 100.
MODEL
{ SHM | MP }
specifies the configuration type. This parameter is required and only one of the two settings can be specified. SHM
specifies a single machine configuration; only one machine may be specified in the MACHINES
section. MP
specifies a multi-machine configuration; MP
must be specified if a networked application is being defined. Note: to change value
without relinking, servers must be built to support the models needed (see buildserver
(1)).
LDBAL
{ Y | N }
specifies whether or not load balancing should be performed. If LDBAL
is not specified, the default is Y
. It is recommended that if each service maps to one and only one queue, then LDBAL
should be set to N
, since load balancing is automatic.
OPTIONS
identifier[,identifier . . . ]
specifies options that are used. If more than one option is given, they are separated by commas. The following are the options that can be specified. The identifier LAN
indicates that this is a networked application. The identifier MIGRATE
indicates that server group migration can be done. If MIGRATE
is specified, LAN
should also be specified, (except for the case where the configuration runs on a single multiprocessor computer). This parameter is optional and the default is no options.
The MACHINES
section specifies the logical names for physical machines for the configuration. It also specifies parameters specific to a given machine. The MACHINES
section must contain an entry for each physical processor used by the application. Entries have the form:
ADDRESS
required parameters
[optional parameters]
where ADDRESS
is the physical name of a processor, for example, the value produced by the UNIX system uname -n
command. The length of the entire ADDRESS
must be 30 characters or less. If the name is not an identifier, it must be enclosed in double quotes. If the LAN
option is not specified, only one machine name can appear in this section. One of the required KEYWORDs is LMID
, which is the logical machine string_value assigned to the physical machine. An LMID
string_value must be unique within the MACHINES
section of the configuration file.
LMID
= string_value
specifies that string_value
is to be used in other sections as the symbolic name for ADDRESS
. This name cannot contain a comma, and must be 30 characters or less. This parameter is required. There must be an LMID
line for every machine used in a configuration.
These parameters are required:
TUXCONFIG
= string_value
This is the absolute pathname of the file or device where the binary TUXCONFIG
file is found on this machine. The maximum string value length is 64 characters. The administrator need only maintain one TUXCONFIG
file, namely the one that is pointed to by the TUXCONFIG
environment variable on the MASTER
machine. Copies on other machines of this master TUXCONFIG
file are synchronized with the MASTER
machine automatically when the system is booted. This parameter must be specified for each machine. If TUXOFFSET
is specified, then the BEA TUXEDO file system starts at that number of blocks from the beginning of the TUXCONFIG
device (see TUXOFFSET
below). See ENVFILE
in the MACHINES
section for a discussion of how this value is used in the environment.
TUXDIR
= string_value
This is the absolute pathname of the directory where the BEA TUXEDO system software is found on this machine. This parameter must be specified for each machine and the pathname should be local to each machine; in other words, TUXDIR
should not be on a remote file system. If the machines of a multiprocessor application have different BEA TUXEDO system releases installed, check the discussion of "Interoperability" in the BEA TUXEDO Release Notes for the higher level release to make sure you will get the functionality you expect. See ENVFILE
in the MACHINES
section for a discussion of how this value is used in the environment.
APPDIR
= string_value
The value specified for this parameter is the absolute pathname of the application directory and is the current directory for all application and administrative servers booted on this machine. The absolute pathname can optionally be followed by a colon-separated list of other pathnames. In a configuration where SECURITY
is set, each application must have its own distinct APPDIR
. See ENVFILE
in the MACHINES
section for a discussion of how this value is used in the environment.
Optional parameters are:
UID
= number
specifies the numeric user id to be associated with the IPC structures created for the bulletin board. The valid range is 0-RESOURCES
section.
GID
= number
specifies the numeric group id to be associated with the IPC structures created for the bulletin board. The valid range is 0-RESOURCES
section.
MAXWSCLIENTS
= number
specifies the number of accesser entries on this processor to be reserved for workstation clients only. The parameter is only used when the BEA TUXEDO system Workstation feature is used. The number specified here takes a portion of the total accesser slots specified with MAXACCESSERS
. 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. This value must be greater than or equal to 0 and less than 32,768. The default is 0. It is an error to set this number greater than MAXACCESSERS
.
TYPE
= string_value
is used for grouping machines into classes. TYPE
can be set to any string value that is 15 characters or less. If two machines have the same TYPE
value, data encoding/decoding is bypassed when sending data between the machines. TYPE
can be given any string value. It is used simply for comparison. The TYPE
parameter should be used when the application involves a heterogeneous network of machines or when different compilers are used on the machines in the network. If not specified, the default is the null string, which matches any other entry that does not have a value specified.
ULOGPFX
= string_value
specifies the absolute pathname prefix of the path for the userlog
(ULOGPFX
for a given machine is used to create the userlog
($APPDIR/ULOG
is used. "mmddyy
" (month, day, year) is appended to the prefix to get the actual log file name.
ENVFILE
= string_value
specifies that all clients and servers on the machine are to be executed with the environment specified in the named file. If the value specifies an invalid file name, no values are added to the environment. Lines must be of the form ident=value where ident begins with an underscore or alphabetic character, and contains only underscore or alphanumeric characters. Within the value, strings of the form ${env} are expanded when the file is processed using variables already in the environment. (Forward referencing is not supported and if a value is not set, the variable is replaced with the empty string). Backslash (\) may be used to escape the dollar sign and itself. All other shell quoting and escape mechanisms are ignored and the expanded value is placed into the environment.
Client programs process only the MACHINES ENVFILE
during tpinit()
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 MACHINES
entry. An attempt to reset these three variables to another value will not be allowed and will result in a warning. tmboot
and tlisten
process the machine ENVFILE
before starting the server, allowing for the environment to indicate necessary pathnames for finding executable and dynamically loaded files. Once the server is running,as part of server initialization (before the application gets control in tpsvrinit
), 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
.
PATH
and LD_LIBRARY_PATH
are treated specially. Before a server is activated, the machine ENVFILE
is scanned to find the first occurrence of a PATH
or LD_LIBRARY_PATH
variable; embedded environment variables within either PATH variable are not expanded. PATH
and LD_LIBRARY_PATH
are used to find pathnames for executable and dynamically loaded files. PATH
will always be prefixed with
${APPDIR}:${TUXDIR}/bin:/bin:
if the value doesn't already begin with this string. This PATH
will be used as a search path for servers that are specified with a simple or relative pathname. LD_LIBRARY_PATH
will always be prefixed with
${APPDIR}:${TUXDIR}/lib:/lib:/usr/lib:
if the value doesn't already begin with this string. SHLIB_PATH
is set on HPUX and LIBPATH
is set on AIX instead of LD_LIBRARY_PATH
.
This section provides information about server groups. This section must have at least one server group defined in it (which can be added via tmconfig
(1) after the TUXCONFIG
file has been created). A server group entry provides a logical name for a collection of servers and/or services on a machine. The logical name is used as the value of the SRVGRP
parameter in the SERVERS
section to identify a server as part of this group. SRVGRP
is also used in the SERVICES
section to identify a particular instance of a service with its occurrences in the group. Other GROUPS
parameters associate this group with a specific resource manager instance (for example, the employee database). Lines within the GROUPS
section have the form:
GROUPNAME required parameters [optional parameters]
where GROUPNAME specifies the logical name (string_value
) of the group. The group name must be unique within all group names in the GROUPS
section and LMID
values in the MACHINES
section and cannot contain an asterisk (*), comma, or colon. It must be 30 characters or less.
Required parameters are:
LMID
= string_value1 [, string_value2]
specifies that this group of servers resides on the machine symbolically named by string_valueMACHINES
section (or the default in SHM
mode). Each LMID value must be 30 characters or less. Up to two logical machine names can be specified. The second logical name, if given and if server group migration is enabled, indicates the machine to which the server group can be migrated.
GRPNO
= number
specifies the numeric group number associated with this server group. This number must be greater than 0 and less than 30000, and must be unique among all entries in the GROUPS
section.
Optional parameters are:
OPENINFO
= "string
"
specifies the resource manager instance-dependent information needed when opening the resource manager. The value must be enclosed in double quotes and must be less than or equal to 256 characters in length. This value is ignored if TMSNAME
is not set or is set to TMS
. The format of the OPENINFO
string is dependent on the requirements of the vendor providing the underlying resource manager. The information required by the vendor must be prefixed with "rm_name
:," which is the published name of the vendor's transaction (XA) interface followed immediately by a colon (:).
For BEA TUXEDO system databases, the format is:
OPENINFO="TUXEDO/D:
fsconfig:dbname:openmode"
where "TUXEDO/D
" is the published name of the BEA TUXEDO XA interface, fsconfig is the name of the FSCONFIG
on which the database resides, dbname is the name of the database, and openmode is one of "readonly
" or "readwrite
". For NT and NetWare, the colon separator after fsconfig and dbname must be a semi-colon.
For BEA TUXEDO system/SQL databases, the format is:
OPENINFO="TUXEDO/SQL:
fsconfig:dbname:openmode"
where "TUXEDO/SQL" is the published name of the BEA TUXEDO system/SQL XA interface, fsconfig is the name of the FSCONFIG
on which the database resides, dbname is the name of the database, and openmode is one of "readonly
" or "readwrite
". For NT and NetWare, the colon separator after fsconfig and dbname must be a semi-colon.
For BEA TUXEDO /Q databases, the format is:
OPENINFO="TUXEDO/QM:
qmconfig:qspace"
where "TUXEDO/QM" is the published name of the BEA TUXEDO /Q XA interface, qmconfig is the name of the QMCONFIG
on which the queue space resides and qspace is the name of the queue space. For NT and NetWare, the colon separator after qmconfig must be a semi-colon.
If TMSNAME
is set but the OPENINFO
string is set to the null string (""
) or this parameter does not appear on the entry, it means that a resource manager exists for the group but does not require any information for executing an open
operation.
CLOSEINFO
= "string"
specifies the resource manager instance-dependent information needed when closing the resource manager. The value must be enclosed in double quotes and must be less than or equal to 256 characters in length. This value is ignored if TMSNAME
is not set or is set to TMS
. The format of the CLOSEINFO
string is dependent on the requirements of the vendor providing the underlying resource manager. The information required by the vendor must be prefixed with "rm_name:," which is the published name of the vendor's transaction (XA) interface followed immediately by a colon (:). For BEA TUXEDO system/SQL databases, a CLOSEINFO
string is not used. If TMSNAME
is set but the CLOSEINFO
string is set to the null string (""
) or this parameter does not appear on the entry, it means that a resource manager exists for the group but does not require any information for executing a close operation.
The NETWORK
section describes the network configuration for a LAN environment. For each processor on which a bridge server is located, an entry must be placed in the NETWORK
section giving the network address of the bridge process. An error is generated if this section exists and LAN
is not specified for the OPTIONS
parameter of the RESOURCES
section.
The general format for entries in this section is:
LMID required parameters [optional parameters]
where LMID is the logical machine where the bridge process is placed. LMID must have direct access to the network device to be used (as given in the BRIDGE
parameter).
Required parameters are:
NADDR
= string_value
Specifies the complete network address to be used by the bridge process placed on the LMID 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. If string_value 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 TCP/IP addresses may also be in either of the following two forms:
"//host.name:port_number""//#.#.#.#:port_number"
In the first of these formats, hostname is resolved to a TCP/IP host address at the time the address is bound using the locally configured name resolution facilities accessed via an operating system command. The "#.#.#.#" is the dotted decimal format where each # represents a decimal number in the range 0 to 255. Port_number is a decimal number in the range 0 to 65535. the hexadecimal representations of the string specified.
Optional parameters are:
BRIDGE
= string_value
specifies the device name to be used by the bridge process placed on that LMID to access the network. The BRIDGE
parameter is not required. In prior releases, for networks that were TLI-based, an absolute pathname for a device was required as the value of BRIDGE
. The network transport endpoint file path has the form: /dev/provider_name
. For StarLAN this is: /dev/starlan
.
NLSADDR
= string_value
specifies the network address used by the tlisten
(1) process servicing the network on the node identified by the LMID. The network address used for NLSADDR
is of the same format as that specified for the NADDR
parameter above. If the address has the form "0xhex-digits"
or "\\xhex-digits"
, it must contain an even number of valid hex digits. TCP/IP addresses may be in the "//#.#.#.#:port" format. tmloadcf
(1) prints an error if NLSADDR
is missing on any entry but the MASTER LMID
, for which it prints a warning. However, if NLSADDR
is missing on the MASTER LMID
, tmadmin
(1) will not be able to run in administrator mode on remote machines; it will be limited to read-only operations. This also means that the backup site will be unable to to reboot the master site after failure.
This section provides information on the initial conditions for servers started in the system. The notion of a server as a process that continually runs and waits for a server group's service requests to process, may or may not apply to a particular remote environment. For many environments, the operating system or perhaps a remote gateway will be the sole dispatcher of services; when either of these is the case, only SERVICE
table entries (see next section) and no SERVER
table entries need be specified for remote program entry points; BEA TUXEDO system gateway servers would advertise and queue remote domain service requests. Host-specific reference pages must indicate whether or not UBBCONFIG
server table entries apply in their particular environments, and if so, the corresponding semantics. Lines within the SERVERS
section have the form:
AOUT required parameters [optional parameters]
where AOUT specifies the file (string_value) to be executed by tmboot
(1). tmboot
executes AOUT on the machine specified for the server group to which the server belongs. tmboot
searches for the AOUT file on its target machine. Thus, AOUT must exist in a filesystem on that machine. (Of course, the path to AOUT can include RFS connections to filesystems on other machines.) If a relative pathname for a server is given, the search for AOUT is done first in APPDIR
, then in TUXDIR/bin
, then in /bin, and then in path> where path> is the value of the last PATH
= line appearing in the machine environment file, if one exists. The values for APPDIR
and TUXDIR
are taken from the appropriate machine entry in the TUXCONFIG
file. See ENVFILE
in the MACHINES
section for a more detailed discussion.
Required parameters are:
SRVGRP
= string_value
specifies the group name for the group in which the server is to run. string_value must be the logical name associated with a server group in the GROUPS
section. It must be 30 characters or less. This association with an entry in the GROUPS
section means that AOUT is executed on the machine with the LMID
specified for the server group. It also specifies the GRPNO
for the server group and parameters to pass when the associated resource manager is opened. All server entries must have a server group parameter specified.
SRVID
= number
specifies an integer that uniquely identifies a server within a group. Identifiers must be between 1 and 30,000 inclusive. This parameter must be present on every server entry.
The optional parameters are divided into two categories: boot options and run-time options. Boot options are used by tmboot
(1) when it executes a server. Once running, a server reads its entry from the configuration file to determine its run-time options. The unique server id is used to find the right entry.
Optional boot parameters are:
CLOPT
= string_value
specifies servopts
(5) options to be passed to AOUT when booted. If none is specified, the default is -A
. string_value can be up to 256 characters in length.
MIN
= number
specifies the minimum number of occurrences of the server to boot by tmboot
. If an RQADDR
is specified and MIN
is greater than 1, then the servers will form an MSSQ set. The server identifiers for the servers will be SRVID
up to SRVID + MAX - 1
. All occurrences of the server will have the same sequence number, as well as any other server parameters. The value range for MIN
is 0 to 1000. If not specified, the default is 1.
MAX
= number
specifies the maximum number of occurrences of the server that can be booted. Initially, tmboot
boots MIN
servers, and additional servers can be booted up to MAX
occurrences using the -i
option of tmboot
to specify the associated server identifier. The value range for MAX
is 0 to 1000. If not specified, the default is the same value as MIN
.
This section provides information on services used by the application. Lines within the SERVICES
section have the form:
SVCNM [optional parameters]
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:
ROUTING
= string_value
specifies the name of the routing criteria used for this service when doing data dependent routing. If 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.
This section provides information for data dependent routing of service requests using FML
buffers and views. The routing criteria specified here are used only if the default routing functions, _froute
and _vroute
, are being used (see tuxtypes
(5)). Lines within the ROUTING
section have the form:
CRITERION_NAME required parameters
where CRITERION_NAME is the (string_value) name of the routing entry that was specified on the services entry. CRITERION_NAME must be 15 characters or less in length.
Required parameters are:
FIELD
= string_value
specifies the name of the routing field. It must be 30 characters or less. This field is assumed to be an FML
buffer or view field name that is identified in an FML
field table (using the FLDTBLDIR
and FIELDTBLS
environment variables) or an FML
view table (using the VIEWDIR
and VIEWFILES
environment variables), respectively. This information is used to get the associated field value for data-dependent routing during the sending of a message. If a field in an FML32
buffer will be used for routing, it must have a field number less than or equal to 8191.
RANGES
= "string"
specifies the ranges and associated server groups for the routing field. string must be enclosed in double quotes. string can be up to string
can be up to 1024 characters). The format of string is a comma-separated ordered list of range/group_name pairs (see "EXAMPLE
" below).
A range is either a single value (signed numeric value or character string in single quotes), or a range of the form "lower - upper" (where lower and upper are both signed numeric values or character strings in single quotes). Note that "lower" must be less than or equal to "upper". To embed a single quote in a character string value (as in O'Brien
, for example), it must be preceded by two backslashes ('O\\'Brien'
). The value MIN
can be used to indicate the minimum value for the data type of the associated FIELD
on the machine. The value MAX
can be used to indicate the maximum value for the data type of the associated FIELD
on the machine. Thus, "MIN - -5
" is all numbers less than or equal to -5 and "6 - MAX
" is all numbers greater than or equal to 6. The meta-character "*
" (wild-card) in the position of a range indicates any values not covered by the other ranges previously seen in the entry; only one wild-card range is allowed per entry and it should be last (ranges following it will be ignored).
The routing field can be of any data type supported in FML
. A numeric routing field must have numeric range values, and a string routing field must have string range values.
String range values for string, carray, and character field types must be placed inside a pair of single quotes and can not be preceded by a sign. Short and long integer values are strings of digits, optionally preceded by a plus or minus sign. Floating point numbers are of the form accepted by the C compiler or atof
: an optional sign, then a string of digits optionally containing a decimal point, then an optional e or E followed by an optional sign or space, followed by an integer.
The group name indicates the associated group to which the request is routed if the field matches the range. A group name of "*
" indicates that the request can go to any group where a server offers the desired service.
Within a range/group pair, range is separated from the group name by a ":
".
BUFTYPE
= "type1[
:subtype1[,subtype2 . . . ]][
;type2[:subtype3[, . . . ]]] . . .
"
is a list of types and subtypes of data buffers for which this routing entry is valid. This parameter can be up to 256 characters in length and a maximum of 32 type/subtype combinations are allowed. The types are restricted to be either FML
, VIEW
, X_C_TYPE
, or X_COMMON
. No subtype can be specified for type FML
, and subtypes are required for type VIEW
, X_C_TYPE
, and X_COMMON
("*" is not allowed). Note that subtype names should not contain semicolon, colon, comma, or asterisk characters. Duplicate type/subtype pairs can not be specified for the same routing criteria name; more than one routing entry can have the same criteria name as long as the type/subtype pairs are unique. This parameter is required. If multiple buffer types are specified for a single routing entry, the data types of the routing field for each buffer type must be the same.
An example of a routing entry is:
BRNCH FIELD=B_FLD RANGES="0-2:DBG1,3-5:DBG2,6-9:DBG3" BUFTYPE="FML"
which sends buffers with field B_FLD
values 0-2 to server group DBG1
, values 3-5 to server group DBG2
, and values 6-9 to DBG3
; no other values are allowed.
If the field value is not set (for FML
buffers), or does not match any specific range and a wild-card range has not been specified, an error is returned to the application.