How to Route Service Requests to Remote Domains


	BEA Home \| Events \| Solutions \| Partners \| Products \| Services \| Download \| Developer Center \| WebSUPPORT
	http://www.oracle.com/technology/documentation/index.html \| Site Map \| Search \| PDF Files \| Contact \| Glossary

Tuxedo Documentation \| Using the BEA Tuxedo Domains Component \| Local Topics \| Previous Topic \| Next Topic \| Contents

Data-dependent routing information used by gateways to send service requests to specific remote domains is provided in the DM_ROUTING section of the DMCONFIG file. The FML32, VIEW32, FML, VIEW, X_C_TYPE, and X_COMMON typed buffers are supported.

To create a routing table for a domain, specify the following:

Buffer type for which the routing entry is valid
Name of the routing entry and field
Ranges and associated remote domain names of the routing field.

The following table describes these fields.

Routing Table Field	Description
Buffer type	A list of types and subtypes of data buffers for which this routing entry is valid. The types may be included: FML32, VIEW32, FML, VIEW, X_C_TYPE, and X_COMMON. No subtype can be specified for type FML; subtypes are required for the other types. The * (or wildcard) value is not allowed. Duplicate type/subtype pairs cannot be specified for the same routing criteria name; one criteria name can be specified in multiple routing entries as long as the type/subtype pairs are unique. If multiple buffer types are specified for a single routing entry, the data types of the routing field for all buffer types must be the same. Valid values for type are: [:subtype1[,subtype2 . . .]] [;type2[:subtype3[,subtype4 . . . ]]] . . . The maximum total length of 32 type/subtype combinations is 256 characters. Valid values for subtype may not include semicolons, colons, commas, or asterisks. Example: FML
Domain routing criteria	The name (identifier) of the routing entry. A valid value is any string of 1-15 characters, inclusive. Example: ROUTTAB1
Routing field name	The name of the routing field. It is assumed that the value of this field is a name identified in an FML field table (for FML buffers) or an FML VIEW table (for VIEW, X_C_TYPE, or X_COMMON buffers). A valid value is an identifier string that is 1-30 characters, inclusive. Example: FIELD1
Ranges	A value comprised of a set of numbers (that must have numeric values) and an alphanumeric string (that must have string values) associated with remote domain names (RDOM) for the routing field. The routing field can be of any data type supported in FML. String range values for string, carray, and character field types must meet the following criteria: Placed inside a pair of single quotes and not preceded by a sign. Short and long integer values are a string of digits, optionally preceded by a plus or minus sign. Floating point numbers are of the form accepted by the C compiler or atof()as follows: 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. When a field value matches a range, the associated RDOM value specifies the remote domains to which the request should be routed. An RDOM value of * indicates that the request can go to any remote domain known by the gateway group. Valid values for this field are a comma-separated ordered list of range/RDOM pairs where a range is one of two types: (a) a single value (signed numeric value or character string in single quotes); or (b) 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. Within a range/RDOM pair, the range is separated from the RDOM by a colon ( : ). MIN can be used to indicate the minimum value for the data type of the associated FIELD: For strings and carrays, it is the null string For character fields, it is 0 For numeric values, it is the minimum numeric value that can be stored in the field. MAX can be used to indicate the maximum value for the data type of the associated FIELD: For strings and carrays, it is an unlimited string of octal-255 characters For a character field, it is a single octal-255 character For numeric values, it is the maximum numeric value that can be stored in the field. Thus, MIN - -5 is all numbers less than or equal to -5; and 6 - MAX is the set of all numbers greater than or equal to 6. The metacharacter * (wildcard) in the range position indicates any values not covered by other ranges previously seen in the entry; one wildcard range is allowed per entry, which should be listed last in the field (ranges following it are ignored). Example: 1-100:REMDOM3