IBM WebSphere Adapter for Email(V6.0.2)
(C) Copyright International Business Machines Corporation 2006. All rights
reserved. US Government Users Restricted Rights - Use, duplication or disclosure
restricted by GSA ADP Schedule Contract with IBM Corp.
发行说明
本文档包含 Adapter for Email V6.0.2 的发行说明。
描述
支持的硬件和软件
重要的安装信息
更新、局限性和已知问题
IBM 软件支持机构
描述
IBM(R) WebSphere(R) Adapter for Email 通过在电子邮件系统内交换电子邮件消息对系统提供双向集成。该适配器将在 WebSphere Process Server 或 WebSphere Enterprise Service Bus 上运行的 Java 2 Platform, Enterprise Edition(J2EE)组件与一个或多个邮件服务器相连接。它提供了一种供 J2EE 组件和邮件服务器进行交互的方法。
此 JCA 适配器包含以下功能:
- 轮询邮箱中的轮询文件夹以便将新的电子邮件消息传递到配置的端点。
- 支持 IMAP 和 POP3 协议以进行入站处理(轮询)。
- 能够创建新的电子邮件消息并将它发送到指定的接收方,并为 SMTP 协议提供出站支持。
- 在入站和出站处理期间为邮件内容和附件提供数据变换支持,并为结构化定义和非结构化定义提供该支持。
- 支持同时轮询多个邮箱。
- 适配器支持使用搜索条件来过滤电子邮件事件。
- 支持在本地系统上将邮件归档。可以配置归档文件的名称以提供电子邮件消息内容的上下文信息。
- 适配器支持将同一事件传递到多个端点应用程序。
- 资源适配器监视功能允许监视适配器实例的执行情况。
- 首次故障数据捕获(FFDC)在发生意外内部错误时自动提供系统环境的快照。
- 可以下载适配器跟踪解析器插件并将它安装在 WebSphere Integration Developer 中,以便对专用格式的跟踪文件进行语法分析,并将其格式转换为公共基本事件(CBE)格式。解析器可以用来使适配器的日志文件和跟踪文件相关联。
- 缺省情况下,适配器支持不间断轮询,如果已将它配置为支持不间断轮询,则它可以在发生事件处理异常时停止轮询。
- 适配器在集群环境中受支持以确保高可用性。
- 适配器可以根据事件时间戳记来过滤事件。
- 当发生与入站 EIS 连接相关的特定于连接的错误时,适配器会尝试重新建立 EIS 连接。
- 适配器支持公共事件持久性。
- 支持数据变换。
- 使用 EventStoreWithXid 接口实现了事件持久性机制。
有关完整 WebSphere Adapter 产品服务组合的更多信息,请访问:http://www.ibm.com/software/integration/wbiadapters
声明函
请参阅 WebSphere Adapters V6.0.2 声明函以获取以下类型的信息:
- 详细的产品描述,包括新功能的描述
- 产品定位声明
- 打包和订购详细信息
- 国际兼容性信息
支持的硬件和软件
有关软件要求的信息,请参阅 WebSphere Adapters 软件要求。
有关硬件要求的信息,请参阅 WebSphere Adapters 硬件要求。
重要的安装信息
请访问以下 Web 站点以获取 WebSphere Adapter for Email 的安装和配置信息:
更新、局限性和已知问题
IBM 软件支持机构 Web 站点上以技术说明的形式记录了关于 Adapter for Email V6.0.2 的更新、局限性和已知问题,该站点的网址为:http://www.ibm.com/software/integration/wbiadapters/support。
当发现并解决了局限性和问题后,IBM 软件支持机构团队会更新知识库。通过搜索知识库,可以快速找到所遇到问题的变通方法或解决方案。以下链接启动在线支持知识库的定制查询。要创建自己的查询,请转至
IBM 软件支持机构 Web 站点上的高级搜索页面:
查看 Adapter for Email 的技术说明
IBM 软件支持机构
IBM 软件支持机构以在线方式或电话方式提供对 WebSphere Adapters 的支持。执行以下步骤,可以更快地获得 IBM 支持机构的响应。安装或升级 IBM Support Assistant
IBM Support Assistant(ISA)是免费的本地软件可维护性工作台,用于帮助您解决
IBM 软件产品问题。为已安装的产品安装插件。此工具使您能够快速访问有关支持的信息以及用于确定问题的可维护性工具。安装和升级此工具的方法简单明了。
IBM Support Assistant 提供下列服务:
- 基于症状的数据收集
- 通过使用联合搜索界面(即一次搜索多个资源)访问 IBM 支持信息、IBM 新闻组和其他资源
- 轻松访问 IBM 培训材料
- 通过便捷的链接轻松访问 IBM 产品主页、产品支持页面和产品论坛或新闻组
- 通过使用工具框架和更新管理器来轻松更新和安装 ISA 插件和工具
- 通过以电子方式将关键的系统数据提交给 IBM,以快速解析问题管理记录
建议您安装 IBM Support Assistant V3.0.1 以支持各种各样的 IBM 解决方案。
要安装和升级 IBM Support Assistant,请使用以下过程。
- 转至 IBM Support Assistant Web 页面,网址为:
http://www.ibm.com/software/support/isa/
- 遵循该 Web 页面上的指示信息来下载 ISA V3.0,然后解压缩、安装和使用该工具。
- 启动 ISA。
- 打开 Updater 组件。
- 在 Upgrades 选项卡上,将 ISA 升级到版本 3.0.1 或更高版本。
- 在 New Products and Tools 选项卡上,安装适配器的插件。从列表中为适配器选择
WebSphere(R) 品牌的插件。每个适配器都有一个可选的语言包插件,它使您能够以非英语的语言查看特定于适配器的信息。
使用 IBM Support Assistant 提交问题报告
可以使用 ISA V.3.0.x 中提供的 Service 选项从系统中收集数据并向 IBM 提交问题报告。请执行下列步骤:
- 确保您已使用 Updater 选项为适配器安装了与 ISA V3.0 兼容的插件和功能部件。
- 单击 Service > Collect Data > adapter_name
- 提供创建了适配器日志的安装文件夹。
- 单击 Collect。此工具从步骤 3 中指定的文件夹收集所有以 .cfg、.log、.txt 和 .trc 结尾的文件并创建一个归档。
- 使用 Log into ESR 选项来提交问题报告并生成服务请求(SR)。生成 SR 时,您可以连接日志归档。
与 IBM 软件支持机构联系
如果您认为问题与软件缺陷有关,则 IBM 软件支持机构会提供帮助。与 IBM 软件支持机构联系之前,贵公司必须具有有效的 IBM 软件维护合同,并且您必须已被授权向 IBM 提交问题。您需要的软件维护合同类型取决于您具有的产品类型:
如果您不能确定需要哪种类型的软件维护合同,在美国请致电 1-800-IBMSERV(1-800-426-7378);如果是在其他国家或地区,请访问 Web 上的 IBM Software Support Handbook 的联系人页面(http://techsupport.services.ibm.com/guides/contacts.html),然后单击您所在地理区域的名称,以获得您所在地区的支持人员的电话号码。
IBM Software Support Handbook 包含关于 IBM 产品的服务和支持的详细信息。请在以下网址处阅读此手册:http://techsupport.services.ibm.com/guides/handbook.html。
要与 IBM 软件支持机构联系,请执行下列过程:
- 描述问题并收集背景信息。当向 IBM 支持专家说明问题时,请尽量详细一些。请包括所有相关的背景信息,以便 IBM 专家能够更有效地帮助您解决问题。为了节省时间,请明确下列问题的答案:
- 发生问题时您运行的软件版本是什么?请包括操作系统和相关产品的版本。
- 此问题以前是否发生过,或者它是否是一个孤立问题?
- 执行哪些步骤时导致了该故障?
- 可以重现该问题吗?如果可以,执行哪些步骤时会导致该故障?
- 是否对系统的硬件、操作系统和联网软件等进行了任何更改?
- 当前是否正在对此问题使用变通方法?如果是,请准备在报告问题时进行说明。
- 是否具有与问题症状相关的日志、跟踪和消息?IBM 软件支持机构可能会询问此信息。
- 确定问题对业务产生的影响。当向 IBM 报告问题时,将要求您提供严重性级别。因此,您需要了解并评估您报告的问题对业务造成的影响。请使用以下表中描述的条件。
严重性 |
描述 |
1 |
严重业务影响:无法使用程序,对操作产生严重影响。这种情况要求立即解决。 |
2 |
重大业务影响:程序仍然可用,但是受到极大限制。 |
3 |
一定程度的业务影响:程序是可用的,但是不太重要(对操作不起关键作用)的功能部件不可用。 |
4 |
最低程度业务影响:问题对操作造成的影响很小,或者已经对问题采取了合理的应对措施。 |
- 向 IBM 软件支持机构提交问题。可以使用下列方法提交问题:
如果您提交的问题是关于软件缺陷或者是关于文档错漏,则 IBM 软件支持机构将创建一个授权程序分析报告(APAR)。APAR 将对问题进行详细描述并跟踪其解决方案。
IBM 软件支持机构在解决该 APAR 并提供修订之前会尽可能提供一种变通方法供您使用。IBM 每天都在 IBM 产品支持 Web 页面上发布已解决的 APAR,以便遇到相同问题的其他用户也可以使用相同的解决方案。