Mail Agent Error Codes

Below is a legend for all error codes in the Mail Agent. Refer to this lookup table when analyzing log files etc.

Log level

The numeric error code and optional message is written to the log file.

Example log entry
13:04:11,459 [11] ERROR [Scanner,ScanWorkflow] - 'timesheet_1_5_feb.pdf', Result: (0x00001106)

Error Codes

images/download/attachments/20220984/image2016-5-23_14_9_18.png

Component code (01 - FFFFF)
Error type (1 = Error, 2 = Warning)
Error code (0-FF)


Component name

Component code

Metadefender.Scanner.dll

1

Metadefender.Email.Engine.Processor.dll

2

Metadefender.Email.Engine.ExchangeNNNN/Generic.Agent.dll

3

Metadefender.Email.Engine.Service.exe

4

Metadefender.Engine.Common.dll

5


Error code

Numeric

Description

ERR_MAILAGENT_MDCORE
_READ_EMAIL_SCAN_SETTINGS

0x00001100

Failed to read Emai Scanner settings from database

ERR_MAILAGENT_MDCORE
_UPDATE_EMAIL_SCAN_SETTINGS

0x00001101

Failed to update Emai Scanner settings in database

ERR_MAILAGENT_MDCORE
_READ_EMAIL_DISCLAIMER_SETTINGS

0x00001102

Failed to read Emai Disclaimer settings from database

ERR_MAILAGENT_MDCORE
_UPDATE_EMAIL_DISCALIMER_SETTINGS

0x00001103

Failed to update Emai Disclaimer settings in database

ERR_MAILAGENT_MDCORE
_ADD_EMAIL_DISCALIMER

0x00001104

Failed to add disclaimer to email message

ERR_MAILAGENT_MDCORE
_SCAN

0x00001105

Failed to scan email

ERR_MAILAGENT_MDCORE
_SCAN_ATTACHMENT

0x00001106

Failed to scan email attachment

ERR_MAILAGENT_MDCORE
_SCAN_REQUEST

0x00001107

Failed to receieve a response from a scan request/MD Core not respodning

ERR_MAILAGENT_MDCORE
_SCAN_UNEXPECTED_JSON

0x00001108

Unexpected JSON in MD Core response

ERR_MAILAGENT_MDCORE
_SCAN_TIMEOUT

0x00001109

Timeout while waiting for MD Core response

ERR_MAILAGENT_MDCORE
_LOOKUP_HASH

0x0000110A

Failed to lookup has in MD Core/MD Core not respodning

ERR_MAILAGENT_MDCORE
_SANITIZE_ATTACHMENT

0x0000110B

Failed to sanitize an attachment

ERR_MAILAGENT_MDCORE_SANITIZE
_ATTACHMENT_SERVER_RESPONSE

0x0000110C

Failed to sanitize an attachment (unexpected server response)

ERR_MAILAGENT_MDCORE
_REPLACE_SANITIZED_ATTACHMENT

0x0000110D

Failed to replace an attachment in email (during sanitization)

ERR_MAILAGENT_MDCORE
_REMOVE_BLOCKED_ATTACHMENT

0x0000110E

Failed to remove an attachment in the email (during sanitization/filtering)

ERR_MAILAGENT_MDCORE
_SANITIZE_BODY

0x0000110F

Failed to sanitize message body

ERR_MAILAGENT_MDCORE
_UNKNOWN_BODY

0x00001110

Email has an unknown body type

ERR_MAILAGENT_MODCORE
_SANITIZE_BODY_SERVER

0x00001111

Metadefender Core server has failed to sanitize the body.

ERR_MAILAGENT_MDCORE
_SCAN_BODY

0x00001112

Failed to scan a email body

ERR_MAILAGENT_MDCORE
_ADD_EMAIL_SUBJECT_TAG

0x00001113

Failed to add a tag to the email subject

 

 

 

WARN_MAILAGENT_MDCORE
_CREATE_PERFORMANCE_COUNTERS

0x00001200

Could not create performance counters at startup

WARN_MAILAGENT_MDCORE
_READ_EMAIL_SCAN_SETTINGS

0x00001201

Failed to read Emai Scanner settings from database (attempting to use default settings)

WARN_MAILAGENT_MDCORE
_READ_EMAIL_DISCLAIMER_SETTINGS

0x00001202

Failed to read Emai Disclaimer settings from database (attempting to use default settings)

WARN_MAILAGENT_MDCORE
_SCAN_TIMEOUT

0x00001203

A scan timeout has occured. Attempting next MD Core scanner (if available)

WARN_MAILAGENT_MDCORE
_SANITIZE_ATTACHMENT

0x00001204

Failed to replace an attachment in email (during sanitization), will attempt to remove the attachment instead

WARN_MAILAGENT_MDCORE
_NO_BODY

0x00001205

Email message has no body to be scanned

 

 

 

ERR_MAILAGENT_PROCESSOR
_PROCESS_REST_REQUEST

0x00002100

An error occurred while processing an email request (REST)

ERR_MAILAGENT_PROCESSOR
_PROCESS_REQUEST

0x00002101

An error occurred while processing an email request

ERR_MAILAGENT_PROCESSOR
_AGENT_REST_REQUEST

0x00002102

An error occurred while processing an agent request (REST)

ERR_MAILAGENT_PROCESSOR
_AGENT_REQUEST

0x00002103

An error occurred while processing an agent request

ERR_MAILAGENT_PROCESSOR
_AGENT_REST_EXISTS

0x00002104

An error occurred while processing an agent exists request (REST)

ERR_MAILAGENT_PROCESSOR
_AGENT_REST_ENABLED

0x00002105

An error occurred while processing an agent enabled query request (REST)

ERR_MAILAGENT_PROCESSOR
_AGENT_REST_ENABLE

0x00002106

An error occurred while processing an agent enable request (REST)

ERR_MAILAGENT_PROCESSOR
_AGENT_REST_DISABLE

0x00002107

An error occurred while processing an agent disable request (REST)

ERR_MAILAGENT_PROCESSOR
_AGENT_REST_REGISTERED

0x00002108

An error occurred while processing an agent registration query request (REST)

ERR_MAILAGENT_PROCESSOR
_AGENT_REST_ADD

0x00002109

An error occurred while processing an agent add request (REST)

ERR_MAILAGENT_PROCESSOR
_AGENT_REST_REMOVE

0x0000210A

An error occurred while processing an agent remove request (REST)

ERR_MAILAGENT_PROCESSOR
_AGENT_REGISTER

0x0000210B

An error occured while attempting to register an agent

ERR_MAILAGENT_PROCESSOR
_AGENT_UNREGISTER

0x0000210C

An error occured while attempting to unregister an agent

ERR_MAILAGENT_PROCESSOR
_AGENT_SERVICE_STATUS

0x0000210D

An error occured while attempting to change the agent service status

ERR_MAILAGENT_PROCESSOR
_AGENT_STATUS

0x0000210E

An error occured while attempting to change the agent status

ERR_MAILAGENT_PROCESSOR
_CONFIG_REST_EXPORT

0x0000210F

An error occurred while processing an configuration export request

ERR_MAILAGENT_PROCESSOR
_CONFIG_REST_IMPORT

0x00002110

An error occurred while processing an configuration import request

ERR_MAILAGENT_PROCESSOR
_PERFORM_ACTION

0x00002111

An error occurred while performing an action

ERR_MAILAGENT_PROCESSOR
_HANDLE_REQUEST

0x00002112

An error occurred while processing a request (email)

ERR_MAILAGENT_PROCESSOR
_SPF_LOOKUP

0x00002113

An error occurred while performing an SPF lookup

ERR_MAILAGENT_PROCESSOR
_QUARANTINE

0x00002114

An error occurred while moving an email to quarantine

ERR_MAILAGENT_PROCESSOR
_QUARANTINE_COPY

0x00002115

An error occurred while moving a original copy of an email to quarantine

ERR_MAILAGENT_PROCESSOR
_QUARANTINE_DUPLICATE_LIST

0x00002116

An error occurred while attempting to add the quarantine id to the processing duplicate list.

ERR_MAILAGENT_PROCESSOR
_NOTIFICATIONS_VERIFY

0x00002117

An error occured while attempting to check the status of a notification/alert.

 

 

 

WARN_MAILAGENT_PROCESSOR
_AGENT_READ_REGISTRATIONS

0x00002200

Failed to read agent registrations from MD Core. Using configuration files.

WARN_MAILAGENT_PROCESSOR
_INVALID_XHEADER_NAME

0x00002201

The custom x-header contains one or more invalid characters and cannot be added.

 

 

 

ERR_MAILAGENT_AGENT
_PROCESS_REST_REQUEST

0x00003100

An error occurred while sending a process request (REST)

ERR_MAILAGENT_AGENT
_AGENT_REST_REQUEST

0x00003101

An error occurred while sending an agent request (REST)

ERR_MAILAGENT_AGENT
_AGENT_REST_STATUS

0x00003102

An error occurred while sending an agent status request (REST)

ERR_MAILAGENT_AGENT
_AGENT_PROCESS

0x00003103

An error occurred while sending an agent request

ERR_MAILAGENT_AGENT
_AGENT_PROCESS_RESULT

0x00003104

An error occurred while processing an agent request response

ERR_MAILAGENT_AGENT
_AGENT_RESULT

0x00003105

An error occurred while processing a process request response

ERR_MAILAGENT_AGENT
_DELETE_ENVELOPE_FILE

0x00003106

An error occurred while attempting to delete a processed .envelope file

ERR_MAILAGENT_AGENT
_PARSE_RETRY_DATE

0x00003107

An error occurred while attempting to parse the retry date in an .envelope file

ERR_MAILAGENT_AGENT
_FAST_PROCESSING

0x00003108

An error occurred while attempting to fast process an email

ERR_MAILAGENT_AGENT
_MONITOR_INIT

0x00003109

An error occurred while initializing the generic agent file monitor

ERR_MAILAGENT_AGENT
_MONITOR_STOP

0x0000310A

An error occurred while stopping the generic agent file monitor

ERR_MAILAGENT_AGENT
_MONITOR_ERROR

0x0000310B

An error in the generic agent file monitor thread

ERR_MAILAGENT_AGENT
_MONITOR_DELETE_OBSOLETE_FILE

0x0000310C

An error occurred while attempting to delete an obsolete file

ERR_MAILAGENT_AGENT
_MONITOR_RETRY_PROCESS_BAD_FILE

0x0000310D

An error occurred while attempting to read a .bad file

ERR_MAILAGENT_AGENT
_MONITOR_RETRY_ERROR

0x0000310E

An error in the generic agent file monitor retry thread

ERR_MAILAGENT_AGENT
_MONITOR_REST_SETTINGS

0x0000310F

An error occurred while reading/writing generic mail agent settings (REST)

ERR_MAILAGENT_AGENT
_EMAILRELAY_START

0x00003110

An error occurred when attempting to start an emailrelay process

ERR_MAILAGENT_AGENT
_EMAILRELAY_DELETE_ORPHAN_FILE

0x00003111

An error occurred while attempting to delete an orphaned file

ERR_MAILAGENT_AGENT
_PROCESS_PREPARE

0x00003112

An error occured while preparing a email processing request

ERR_MAILAGENT_AGENT
_TASK_ERROR

0x00003113

An error occurred in a task

ERR_MAILAGENT_AGENT
_WORKER_THREAD_ERROR

0x00003114

An error occurred in a agent worker thread

ERR_MAILAGENT_AGENT
_WORKER_THREAD_DELETE_FILE

0x00003115

An error occurred while attempting to delete a file

ERR_MAILAGENT_AGENT
_WORKER_THREAD_CREATE_FILE

0x00003116

An error occurred while attempting to create a file

 

 

 

WARN_MAILAGENT_AGENT
_MONITOR_JOIN_THREAD

0x00003200

Timeout while joining threads when shutting down

WARN_MAILAGENT_AGENT
_CREATE_PERFORMANCE_COUNTERS

0x00003201

Failed to create performance counters

WARN_MAILAGENT_AGENT
_EMAILRELAY_KILL

0x00003202

Failed to kill an emailrelay process

 

 

 

ERR_MAILAGENT_SERVICE_START

0x00004100

Failed to start service

 

 

 

ERR_MAILAGENT_ENGINESERVICE_START

0x00005100

The mail agent service failed to start

ERR_MAILAGENT_ENGINESERVICE_STOP

0x00005101

The mail agent service failed to stop

ERR_MAILAGENT_ENGINESERVICE
_MDCORE_UNRESPONSIVE

0x00005102

Metadefender Core is not responding and mail agent cannot start

ERR_MAILAGENT_ENGINESERVICE
_COMPONENT_LOAD

0x00005103

An error occurred while loading a Mail Agent component

ERR_MAILAGENT_ENGINESERVICE
_COMPONENT_CREATE

0x00005104

An error occurred while creating a Mail Agent component

 

 

 

WARN_MAILAGENT_ENGINESERVICE
_MDCORE_UNRESPONSIVE_REST

0x00005200

Metadefender Core REST is not responding (continuing to wait)

WARN_MAILAGENT_ENGINESERVICE
_MDCORE_UNRESPONSIVE_UPDATE

0x00005201

Metadefender Core is updating (continuing to wait)

WARN_MAILAGENT_ENGINESERVICE
_STATUS_CHECK

0x00005202

An unhandled error occured while performing status checks