SMTP Probe
==========

SMTP probe does a connection to SMTP server and sends the HELLO command. The 
HELLO command is automatically constructed by MonitorWare Agent on startup by 
using the fully qualified DNS (Domain name server) name. SMTP server sends 
response in reply to SMTP probe. On getting the response fom SMTP server, SMTP 
probe sends the QUIT command to terminate the connection.

The connection status is saved in the property **smtpstatus** and the response 
in the property **smtprespmsg**. 


.. image:: ../images/smtpprobe.png
   :width: 100%

*Service - SMTP Probe*

Probe Interval
^^^^^^^^^^^^^^

**File Configuration field:**
  nSleepTime

**Description:**
  This is the interval of the probe. After each probe, the Service will sleep 
  for the configured probe interval. This period is specified in milliseconds.


Timeout Limit
^^^^^^^^^^^^^

**File Configuration field:**
  nTimeOutLimit

**Description:**
  The amount of time (in :doc:`milliseconds <../glossaryofterms/millisecond>`) the remote system is expected to answer 
  in. If no response is received within this period, the probe fails and an 
  event is generated. The default value of 1000 milliseconds is a proper value
  for most well connected networks. If the probe runs against a heavily loaded
  system and/or slow network link, the amount must be adjusted accordingly.


Generate an event if SMTP Probe was successful
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

**File Configuration field:**
  nGenerateOnSuccess

**Description:**
  When checked, an event is generated every time. If unchecked, it is generated 
  only when the SMTP probe fails. The most common option is to leave it 
  unchecked to catch events upon a failed SMTP probe.


SMTP Server
^^^^^^^^^^^

**File Configuration field:**
  szMailServer

**Description:**
  Either the IP address or resolvable host name of the SMTP server, the SMTP 
  probe is to be run against. You can either use an IPv4, an IPv6 Address, or a 
  Hostname that resolves to an IPv4 or IPv6 Address. This system has been 
  called "remote host" in the description above. Please note that specifying a
  host name can cause the SMTP probe to fail if DNS name resolution fails (for
  example due to a failing DNS server). To avoid this, specify an IP address.


SMTP Port
^^^^^^^^^

**File Configuration field:**
  nSMTPPort

**Description:**
  This port is to be probed. Please see your server's reference for the actual 
  value to use. For example, mail servers typically listen to port 25.

 
General Values (Common settings for most services)
-------------------------------------------------- 

Syslog Facility
^^^^^^^^^^^^^^^

**File Configuration field:**
  nSyslogFacility

**Description:**
  The :doc:`Syslog facility <../glossaryofterms/syslogfacility>` to be assigned to events created by this service. Most 
  useful if the message is to forward to a Syslog server.


Syslog Priority
^^^^^^^^^^^^^^^

**File Configuration field:**
  nSyslogPriority

**Description:**
  The Syslog priority to be assigned to events created by this service. Most 
  useful if the message is to forward to a Syslog server.


Syslog Tag Value
^^^^^^^^^^^^^^^^

**File Configuration field:**
  szSyslogTagValue

**Description:**
  The Syslog tag value to be assigned to events created by this service. Most 
  useful if the message is to forward to a Syslog server.


Resource ID
^^^^^^^^^^^

**File Configuration field:**
  szResource

**Description:**
  The :doc:`Resource ID <../glossaryofterms/resourceid>` to be assigned to events created by this service. Most useful 
  if the message is to forward to a Syslog server.


Rule Set to Use
^^^^^^^^^^^^^^^

**File Configuration field:**
  szRuleSetName

**Description:**
  Name of the rule set to be used for this service. The Rule Set name must be a 
  valid Rule Set.