Log Files


The PDF Processor has the ability to generate log files during its operation. By supplying the LogIdentifer parameter to the various script functions, a log file is automatically created or appended to. The LogIdentifier determines the filename of the resulting log file. Typically these would by based on the current activity or transaction, thereby creating separate log files for each event. 


The log files are useful when trying to determine why a particular function might have failed. The WriteLog function provides the ability to include custom log entries to help debug script related issues. 


The log files are created on the M-Files server in the following location:


C:\ProgramData\PentagonDocs Assistant\Server Logs\<Vault Name> <Vault GUID>

 

Each vault with the PDF Processor installed will have its own Server Logs sub folder based on the display name of the vault and its globally unique identifier (GUID).


Example Log File


Filename: {8056887D-1C6E-413C-994C-48AAB14219A3}.log


01/01/2019 09:00:00:5562 - Vault Extension Method: ExDOCS_WriteAttributes_DWG

01/01/2019 09:00:00:5862 - Checking Out...

01/01/2019 09:00:00:6482 - DWG File Count: 1

01/01/2019 09:00:00:6492 - Creating RealDWG COM Object. (dllhost.exe)

01/01/2019 09:00:01:2083 - Call SyncPropertiesFromMFiles COM method.

01/01/2019 09:00:01:3183 - Processing Object: ID 1 Version 2

01/01/2019 09:00:01:3353 - FileVer: ID 1 Version 2

01/01/2019 09:00:01:3353 - Download DWG to temp file: C:\ProgramData\PentagonDocs Assistant\DWG Processor\Temp\4yx2uhha.dwg

01/01/2019 09:00:01:3973 - Download failed: The file has not been committed yet.

01/01/2019 09:00:01:3973 - Attempting to Download previous File Version

01/01/2019 09:00:01:4093 - FileVer: ID 1 Version 1

01/01/2019 09:00:01:4093 - Download DWG to temp file: C:\ProgramData\PentagonDocs Assistant\DWG Processor\Temp\4yx2uhha.dwg

01/01/2019 09:00:01:4453 - Open DWG file

01/01/2019 09:00:01:5483 - Update attribute values of matching Titleblocks

01/01/2019 09:00:01:6333 - Save DWG file

01/01/2019 09:00:02:1063 - Upload updated DWG file

01/01/2019 09:00:02:1443 - Delete temp files from server

01/01/2019 09:00:02:1453 - Releasing COM object.

01/01/2019 09:00:02:1453 - Set Modifying User

01/01/2019 09:00:02:1783 - Checking In...


Automatic Removal of Log Files


Because the creation of log files can be based on an activity or transaction, the number of log files can quickly accumulate. The PDF Processor will automatically remove log files older than 24 hours.


This setting can be increased or decreased by changing the following registry entry:


Registry Key

HKEY_LOCAL_MACHINE\SOFTWARE\PentagonDOCS\Server


Value Name

DeleteLogFilesAfterHours


Type

REG_DWORD


Default 

0x00000018 (24)

24 Hours



NOTE: Changing this value does not require the vault to be restarted.