MAP COMMAND SERVER NOTES

These notes are for the Map Command Server component on Linux platforms.

Set the location of temporary files (DTX_TMP_DIR)

During map execution, the Map Command Server creates temporary files for resource handling and for retaining debug information. The default directory for these temporary files is /tmp. To specify a different directory for temporary files, set the DTX_TMP_DIR environment variable. For example:

DTX_TMP_DIR=install_dir/tmp 
export DTX_TMP_DIR

If multiple users or groups are to access the Map Command Server, define DTX_TMP_DIR instead of using the default /tmp directory. Define and export the DTX_TMP_DIR variable manually or with the setup script. The directory specified for DTX_TMP_DIR must have permission 777 to provide permission to the user, the group, and all others. Define and export the DTX_TMP_DIR variable before you set the directory permission. To set the permission, run the chmod command:

chmod 777 $DTX_TMP_DIR

Enabling environmental debug information (DTX_DEBUG)

When the DTX_DEBUG environment variable is defined, the Map Command Server can produce environmental diagnostic information that can be helpful when a problem occurs during map execution. By default, the DTX_DEBUG environment variable is not defined, and environmental diagnostic information is not recorded.

When you define the DTX_DEBUG environment variable, environmental diagnostic information is recorded in a file named dtxinfo.log located in the directory defined by the DTX_TMP_DIR environment variable (or in the /tmp directory, if DTX_TMP_DIR is not defined).

To enable the environmental debug facility, set the DTX_DEBUG environment variable to TRUE. For example:

DTX_DEBUG=TRUE 
export DTX_DEBUG

To disable the environmental debug facility, set the DTX_DEBUG environment variable to FALSE. For example:

DTX_DEBUG=FALSE 
export DTX_DEBUG

The following is a sample of the information contained in the environmental debug file:

PROCESS_ID: 2309, API_REF: 1 
Date/Time: Fri Jul 25 14:30:09.279783 2017 
FILE: mercmain.c, line: 714 
info: [Integration Platform Product 
Version: 0.0]

PROCESS_ID: 2309, API_REF: 1 
Date/Time: Fri Jul 25 14:30:09.280252 2017 
FILE: mercmain.c, line: 744 
info: [Integration Platform RUNNING: 
Fri Jul 25 14:30:09 2017]

PROCESS_ID: 2309, API_REF: 1 
Date/Time: Fri Jul 25 14:30:09.470357 2017 
FILE: mercrun.c, line: 1951 
New Map File - Fri Jul 25 14:30:09 2017 
[/install_dir/examples/general/map/sinkmap/sinkmap.mmc]

Tracing I/O problems (DebugName and DebugAppend)

You can enable the DebugName and DebugAppend options in the [Connections Manager] section of the dtx.ini file to enable the Map Command Server to trace I/O-related problems.