The XML MQSeries Connection can be configured with global settings as well as with DID as with DID Module specific settings. The following listing describes the available settings.
The following settings are available:
Setting |
Default |
Description |
Expiry |
60 |
The time-out (in seconds) that is used for requests. If the request is not put on the MQSeries queue within this interval, the request is terminated and the request message expires from the request queue. |
Type |
Server |
Type of client connection that is used to connect to MQSeries. The setting 'Server' configures the XML MQSeries Connection to attach to the local MQSeries installation. The setting 'Client' configures the XML MQSeries Connection to attach to a remote MQSeries server. |
Client.HostName |
Empty |
The hostname or IP number of the MQSeries server. For example: myserver.com. This setting is ignored if the Type is set to 'Server'. |
Client.Port |
Empty |
The port that is used. If this setting is left empty, the default MQSeries TCP/IP port is used. This setting is ignored if the Type is set to 'Server'. |
Client.Channel |
Empty |
The channel that is used to connect to the MQSeries server. If this setting is left empty the default Channel is used. This setting is ignored if the Type is set to 'Server'. |
QueueManager |
Empty |
The Queue Manager that hosts the Request and Reply queues. If this setting is left empty the XML MQSeries Connection will attach to the default Queue Manager on the MQSeries server. |
RequestQueue |
Epmty |
Required. The MQSeries queue that the XML MQSeries Connection will post requests on. |
ReplyQueue |
Empty |
Required. The MQSeries queue that the XML MQSeries Connection will read requests from |
TransmissionEncoding |
UTF-8 |
The encoding that is used to post requests on the RequestQueue. This setting is checked against the contents of the request XML structure. If this structure contains an encoding, it must match this setting. Supported values are UTF-8, ISO-8859-1 and Binary. If this setting is set to Binary, the request will be put on the queue with the MQFMT_NONE. For other encodings the request is posted with MQFMT_STRING and a matching CodedCharSetId. |
DefaultResponseEncoding |
UTF-8 |
Default encoding, which will be used if the response XML structure does not specify an encoding in its prologue. Supported encodings are: UTF-8, ISO-8859-1 (or one of its aliases, see below), ISO-8859-15 (or one of its aliases, see below) and ASCII. |
ResetConnectionsAfterModel |
N |
If this setting is enabled, the XML MQSeries Connection will disconnect from the RequestQueue and AnswerQueue after each model. If this setting is disabled, the XML MQSeries Connection will keep at least one set of queues open to improve performance. |
AllowMissingFields |
N |
If this setting is enabled, the XML MQSeries Connection will not report an error when fields are missing from the XML response. These fields will receive the default value for their ITP type. |
LOCALE |
ENG |
With this setting you determine the style of the thousand separator and the decimal point. See the table below for the possible language codes. |
LOCALE:LC_NUMERIC:thousands_sep |
Special |
With this setting you can overwrite the default style of the decimal point. See the table below. |
LOCALE:LC_NUMERIC:decimal_point |
Special |
With this setting you can overwrite the default style of the decimal point. See the table below. |
Content-Template |
Empty |
Required. It specifies the file name of the content template used to construct the body of the request message. |
ResultPath |
Empty |
The XML path to the requested XML data. This path is prepended to the RESULT_PATH defined in the DID. |
ErrorTag |
Empty |
If this setting is specified and the returned XML file contains an element with this tag, the XML MQSeries Connection will handle the result as an error notification and report the contents of this element as an error message. The element must be located in the RESULT_PATH of the entry. |
CacheOpenConnections |
0 |
This setting configures the number of Request and Answer queues that the XML MQSeries Connection will cache in addition to the current open connection. This setting can be used to improve performance but can keep queues open longer. |
The following language codes are supported for the LOCALE setting:
Language Code |
Thousands Separator |
Decimal Point |
|---|---|---|
DES |
dot |
comma |
DEU |
dot |
comma |
ENG |
comma |
dot |
ENU |
comma |
dot |
FRA |
dot |
comma |
FRB |
dot |
comma |
FRS |
dot |
comma |
ITS |
dot |
comma |
NLB |
dot |
comma |
NLD |
dot |
comma |
DAN |
dot |
comma |
ESP |
dot |
comma |
PTG |
dot |
comma |
SVE |
space |
comma |
Instead of a symbol, you can also specify a number (from 0 up to 9) at the LOCALE setting for the thousands separator and decimal point. If you specify a number for the thousands separator, no thousands separator point will be recognized. If you specify a number for the decimal point, no decimal point will be recognized.
windows-1252 |
IBM819 |
windows latin 1 |
CP819 |
ISO_8859-1 |
ISO8859-1 |
windows-1252 |
latin9 |
windows latin 1 |
ISO_8859-15 |
ISO_8859-15 |
ISO8859-15 |
latin1 |
ISO 8859-15 |