Connection Configuration

Whenever an entry is executed in the ITP Model, the XML MQSeries Connection will either extract data from an earlier collected XML structure or the DataManager will send an MQSeries request. You can configure the XML MQSeries connection in the connection configuration file.

The name and location of the connection configuration file is specified at the setting ITPDMINIFILE= in the ITP configuration file. The value of this setting is the name of a file. The connection configuration file is called the DataManager ini file or Dm.ini file. You can change the contents of the Dm.ini file with the ITP Administration Program by selecting Connection configuration.

Templates

For MQSeries there is only a request template.

Error information

The XML MQSeries Connection can easily include error information by means of an error tag that can be specified in the connection configuration file.

Absent and optional fields

Normally the XML MQSeries Connection complains about fields that are defined in the DID, but are not present in the XML record. The main reason to do so is to avoid errors. It is less error-prone to explicitly incorporate empty fields in an XML file, than allowing them to be absent, as this increases the risk that a field gets ignored just because one has used the wrong tag name in the DID. If you set the AllowMissingFields option, ITP ignores fields that have been specified in the DID but do not occur in the selected XML file. Use the special DATABASE_FIELD specification *PRESENT to make a distinction in a model between missing elements and elements that are present in the XML file, but empty.

Namespace support

The XML File connection will resolve namespace prefixes from tags and attributes and validate them against the namespace declarations in the active scope. This support is required to be able to match fields and entries based on namespaces. If this option is disabled namespace prefixes are ignored and considered to be part of the xml tag.

Thousand separator and decimal point

The format of numerical data that is stored in the XML file may vary for different countries. Several settings in the DataManager ini file allow you to determine the layout of the thousand separator and the decimal point.

Encoding

By default, XML files use an UTF-8 encoding. If another encoding is used, the file should normally contain a prologue that specifies this encoding. The XML MQSeries Connection allows a default encoding to be specified via a DefaultResponseEncoding. setting. In this way files without a prologue can use a encoding different than UTF-8. Note that such a file may not be readable by ordinary XML processors, so this setting must be used with care.