FATAL ERROR DMN0043 error occurs when generating a document that uses an iSeries DID

Issue

You are running a document template or master template that uses an iSeries DID. Even though the iSeries DID is properly configured in KCM Core Administrator, you receive either the error:

ITPLOG: WARNING BSD0011: Datamanager shut down.
ITPLOGDM: FATAL ERROR DMN0043: The datamanager cannot interact with the user to retrieve userid, password or host in a Server environment.
ITP failed to run. Error code 13 (Datamanager shut down unexpectedly.).

or

ITP on ITPDP [core_01_5.1.1] #1: FATAL ERROR IAT0100: The datamanager cannot interact with the user. You cannot use EXTRA/INTERACT and keyselections in a Server environment.
more information can be found in "C:\CCM\Work\5.1.1\Instance_01\core\Log\CCMDEV\ITPDP [core_01_5.1.1] #1\RepJob1077253445"
Throwing error message "Mar 19 12:10:46.267[0] [RepJob1077253445]: ITP failed to run. Error code 1 (Fatal error.).
ITP on ITPDP [core_01_5.1.1] #1: FATAL ERROR IAT0100: The datamanager cannot interact with the user. You cannot use EXTRA/INTERACT and keyselections in a Server environment

Cause

In some situations KCM does not detect that the master template uses an iSeries DID. In these situations the data manager cannot properly initialize and you'll receive a "FATAL ERROR DMN0043" error or "FATAL ERROR IAT0100" error.

Solution

Add a dummy DID retrieval entry of the iSeries DID to the data retrieval of the data backbone.

1. In Designer for Windows, open the data retrieval of the databackbone (right click data backbone -> Edit data retrieval)
2. Enter a dummy DID entry in IF FALSE FI. E.g.

IF FALSE THEN
    FORALL X0 in ITP.Entry
    DO
    OD
FI

Note. You can use the DID tool to add an DID entry. 

3. Save and close the Data retrieval of the data backbone.
4. Create the data backbone and unlock it.
5. If required, then recompile the master templates.

Level of Complexity 

Moderate

Applies to