Error Logging

Error logging records any errors or warnings that are encountered when data is exchanged between the Manufacturing Hub and DPM. This information is stored in a text file, named in the following format:

    ClientLog_V5R<XX>SP<YY>_<MachineId>_YYYYMMDD_hhmmss.log

One log file is created for each V5 session, and is saved in a directory named "ClientLog" that is created under the directory specified by the CATTemp environment variable.

Errors for a specific document are identified based on unique identifiers such as the document name, the Manufacturing Hub transaction ID, etc. in the log file.

File format

Each log file begins with a header having the format as shown in the following example:
 

Start MHI Data Exchange Log: 17.May.2006 16:45:37 DELMIA V5 Release: 17 Service Pack: 00 Build Date: 05-03-2006.22.22

Each new load of the selected process (or resource) begins with a block that consists of the tags in the log file:
 

Begin Load: 17.May.2006 16:54:18
ProjectId: $id$(0:0-186763#0, 168)
PTSId: $id$(0:0-175826#0, 136)
SelectedObjectId: $id$(0:0-196434#0, 231)

Each individual error and warning is indicated with a unique tag, and ends with a description of the error or warning:
 

Time: 5/17/2006 4:56:13 PM, Machine: MyMachineName
MHI_Transaction Id: 13 Document Name: MHILoad.CATProcess
FATAL Error: ENOVIA_ConnectionFailure: Unable to connect to ENOVIA LCA

Time: 5/17/2006 4:57:17 PM, Machine: MyMachineName
MHI_Transaction Id: 0 Document Name: 'Unavailable'
CRITICAL Error: 'JAVA_HOME' environment not set

Time: 5/17/2006 4:58:13 PM, Machine: MyMachineName
MHI_Transaction Id: 15 Document Name: 'Unavailable'
FATAL Error: DetailingRetrievalFailed: Could not retrieve detailing 'Detailing Name'

Time: 5/17/2006 4:59:13 PM, Machine: MyMachineName
MHI_Transaction Id: 14 Document Name: MHILoad.CATProcess
Warning: NoGraphicFile: Could not find the graphic file “G:\product\demo3.CATProduct”

The entry for each load ends with a footer, such as:
 

End Load: 17.May.2006 16:54:18


Finally, the log file itself ends as follows if the V5 session has a normal exit:
 

End MHI Data Exchange Log: Completed successfully 17.May.2006 17:45:37

Notes

  • The logging service assumes that user has sufficient privileges to create and modify the log file in the specified directory.
  • If the directory specified by the CATTemp environment variable is deleted during a V5 session, the Manufacturing Hub session log file may also be deleted.
  • If the DELMIA V5 session is terminated abnormally, the creation of the log file may fail or the file may be truncated.