Document control page

Use this information to track changes between versions of this guide.

Table 1. Document modification history
Document version Publication date Comments

SC23-7860-01

December 14, 2007

First IBM publication.

SC23-7860-02

August 22, 2008

Support for Linux® for zSeries added.

SC23-7860-03

June 04, 2010

Updates to the Summary table described in Summary.

Description for the Forgetpop3TopHeader property added to Properties and command line options.

SC23-7860-04

July 01, 2011

Information about operating system conventions added in Conventions used in this guide.

Package version information and requirements updated in Summary.

Installation section updated in Installing probes.

New configuration information added in Configuring the probe.

Backoff strategy information added in Backoff strategy.

Formatting of multi-line elements described in Formatting multi-line elements.

The following properties were added in Properties and command line options:
  • EmailSocketTimeOut
  • KeyStoreFile
  • KeyStorePassword
  • TrustStoreFile
  • TrustStorePassword

Error messages updated in Error messages.

New information about running the probe added in Running the probe.

SC23-7860-05

July 29, 2011

Failover configuration information updated in Peer-to-peer failover functionality.

SC23-7860-06

July 6, 2012

Summary updated.

The following property was added in Properties and command line options:
  • MimeContentType

ProbeWatch messages updated.

SC23-7860-07

November 24, 2016

Error messages updated in Error messages.

SC23-7860-08

July 20, 2017

Probe package version updated in Summary.

Fixes: This version of the guide addresses the following APAR:

  • IV95488: Remove reference to Email Probe version 6.0.

SC23-7860-09

June 28, 2023

Probe package version updated in Summary.

Descriptions for the following properties added to Properties and command line options: MaxBodyLength, MaxHeaderLength, MaxLineCount, MaxLineSize, and ParseTextAttachment.

Enhancement: Version 5.11 of the probe includes the following enhancement:

  • RFE 137470: Make attachment file names available as tokens, for example: $Attachments, $Attachment_1, $Attachment_2, and $Attachment_Count.

Fixes: This version of the probe also addresses the following APARs:

  • IJ28204: Introduced new property ParseTextAttachment to make probe parse text based attachments as part of the email body and revert changes made by APAR IJ20126.
  • IJ20126: Inline attachments with empty ContentID in the email MIME parts produced by some email clients preventing text based content of the inline attachments from being recognized as part of email body.
  • IJ33729: Probe may not run in Windows because the batch script used the system JRE to run javaw. The batch script now runs executables from the default JRE in the OMNIbus installation.
  • IJ26872: Introduced new properties MaxBodyLength, MaxHeaderLength, MaxLineCount and MaxLineSize to allow user-configurable lengths or limits to be set for the following elements: Body, Body_nn, Header and Header_nn.
  • IJ27933: Probe may stop reading email when issues arise within the API while accessing the INBOX folder. The probe now creates separate threads to connect and read emails while imposing the timeout based on the setting of the EmailSocketTimeOut property for each thread. This also resolves a previous known issue whereby the probe may time out its connection with the mail server when reading large emails.