Additional settings

The following table describes other settings that you might need to configure the run Master Template and create Master Template processes.

Settings	Default	Description
ITPRUNDATARETRIEVAL	N	If this setting is disabled, the Master Template loads the Data Backbone from an XML file or runs the Data Retrieval part of the Data Backbone. Set this option to Y to run the Data Retrieval part of the Data Backbone always, even if the Data Backbone is already loaded from an XML file.
ITPDIDCP	System code page of the AS/400	Code page of the ITP/SDK DID files.
ITPEURO	N	If this setting is set to Y, the amount_in_words function uses the euro as currency. If this setting is set to N or not present, the amount_in_words function uses the local currency. This setting can be overridden by the use of the euro function.
ITPALLOWMISSINGOSTINC	N	Controls whether a missing __INC document causes an error when executing the post-include on a result document. If this setting is set to Y, KCM silently removes the __INC() statement and continues. If this setting is set to N, KCM reports an error.
ITPLAZYPOSTINC	N	If this setting is set to Y (ITPLAZYPOSTINC=Y), it suppress the processing of post-includes if the result document contains no include instructions produced with the inc(...; ...) function. This feature is only implemented for Word Master Template documents.
ITPUNICODEEURO	N	Enable on a global level the functionality to translate single byte euro characters to Unicode euro characters. Only supported for Word.
ITPCURRENCYEURO	N	Enable on a global level the functionality to translate the International Currency Symbol to Unicode euro characters. Only supported for Word.

The next settings affect the amount of memory the KCM Core Word processor support uses and the way it handles temporary files.

The Word Support produces a large number of temporary files for administrative purposes. With the default settings only a few of these files should ever exceed the default ITPOUTPUTCACHE setting. Increasing either ITPOUTPUTCACHE and/or ITPMAXTMPOPEN can improve performance while producing large result documents.

Settings	Default	Description
ITPMAXINPUTCACHE	1024	Sets the maximum amount of memory in KB that the KCM Core Word processor support uses while reading a file. If files exceed this size, KCM reads only as much of the file as fits in this size and updates from the disk if it needs other parts of the file. This setting affects the amount of memory that the KCM Core Word processor support uses during translation and execution of a Master Template.
ITPOUTPUTCACHE	256	Sets the maximum amount of memory in KB that the KCM Core Word processor support can use while writing a file. If the file exceeds this size, KCM moves parts of the file to the disk. This setting affects the amount of memory that KCM Core Word processor support uses during execution of a Master Template.
ITPMAXTMPOPEN	1	Sets the number of temporary files kept open simultaneously. If the size of an output file exceeds the size indicated with ITPOUTPUTCACHE, this file is moved to the disk.

Settings

Default

Description

ITPMAXINPUTCACHE

1024

Sets the maximum amount of memory in KB that the KCM Core Word processor support uses while reading a file. If files exceed this size, KCM reads only as much of the file as fits in this size and updates from the disk if it needs other parts of the file.

This setting affects the amount of memory that the KCM Core Word processor support uses during translation and execution of a Master Template.

ITPOUTPUTCACHE

256

Sets the maximum amount of memory in KB that the KCM Core Word processor support can use while writing a file. If the file exceeds this size, KCM moves parts of the file to the disk.

This setting affects the amount of memory that KCM Core Word processor support uses during execution of a Master Template.

ITPMAXTMPOPEN

Sets the number of temporary files kept open simultaneously.

If the size of an output file exceeds the size indicated with ITPOUTPUTCACHE, this file is moved to the disk.

ITPMAXINPUTCACHE primarily affects performance during the post-include process.

ITPOUTPUTCACHE and ITPMAXTMPOPEN affect performance during the Master Template run process and post-include process.

The effect of assigning more memory with the ITPOUTPUTCACHE setting should be primarily noticeable while producing large result documents on a system that has sufficient hardware resources available

Settings	Default	Description
ITPEVALTIMEOUT	3 seconds	This setting determines the amount of time in seconds that the Master Template runs. If the Master Template does not finish running within this time, it returns the EXIT_TIMEOUT (11) return code. The active communications, such as database access, are subsequently stopped after 3 seconds by default. This time can be influenced with the ITPEVALGRACE setting.
ITPEVALGRACE	3 seconds	This setting determines the amount of time in seconds that KCM waits for active communications to complete before it terminates itself. Only useful in combination with the time restriction of running a Master Template set with the ITPEVALTIMEOUT setting.
ITPVALIDATEFIELDSET	N	KCM Core can be configured to validate at runtime that all fields in a FIELDSET variable are filled before using this FIELDSET. If a field is empty, the run Master Template process fails. This validation is disabled by default.

The following settings affect KCM Core runtime behavior when using dynamic content.

Settings	Default	Description
ITPREPRETRY	15,10,15,10	This setting determines whether or not KCM Core attempts to reconnect to an unavailable KCM Repository. The first pair of numbers is the number of connection attempts and the delay between connection attempts in seconds for interactive Master Template runs. The second pair of numbers is the same for non-interactive runs. Set the number of connection attempts to 0 to disable any recovery attempts. We recommend that you combine this setting with the job timeout feature of KCM Core.
ITPDISABLEPROJECTCONSTRAINT	N	This setting controls whether KCM Core is restricted to dynamic content from a single project or if it can retrieve dynamic content from multiple projects. Change this setting to Y for compatibility with KCM Repository 3.5 projects that use library projects.