IBM MQMFT Agent退出文件（mail.jar、mftexit1.0.jar）的用途与启用方法咨询

一、两个JAR文件的核心用途 #

• mail.jar：这是JavaMail API的标准实现包，相当于mftexit1.0.jar的"邮件发送引擎"。它负责处理邮件底层的连接、构造、发送逻辑——比如连接你的SMTP服务器、封装邮件主题/内容、处理认证等，是邮件通知功能的基础依赖。
• mftexit1.0.jar：这是MQ File Transfer Edition（MQ FT）官方示例的事件通知退出程序。它的核心作用是监听MQ FT agent的所有文件传输事件（比如传输启动、成功、失败、取消），当触发预设事件时，调用mail.jar发送定制化的邮件通知给相关人员，帮你及时掌握文件传输状态。

二、启用步骤（一步步来） #

1. 确认文件位置
   先确保这两个JAR已经放在你指定的路径：\IBM\WebSphereMQ\mqft\config\qmname\agents\agentname\exits——这是MQ FT agent默认扫描退出程序的目录，位置错了agent会找不到它们。

2. 配置Agent的退出参数
   找到对应agent的配置文件agentname.properties（在\IBM\WebSphereMQ\mqft\config\qmname\agents\agentname目录下），添加以下配置项：

   # 启用邮件通知退出程序，指定主类（mftexit1.0.jar里的核心类）
   exitClass=com.ibm.wmqfte.examples.mailnotification.MailNotificationExit
   
   # ------------------- 邮件服务器配置 -------------------
   # SMTP服务器地址，比如smtp.yourcompany.com
   mail.smtp.host=你的SMTP服务器地址
   # SMTP端口，默认25，加密端口可能是465/587
   mail.smtp.port=25
   # 如果SMTP需要认证，打开这行并填写账号密码
   # mail.smtp.auth=true
   # mail.smtp.user=你的邮箱账号
   # mail.smtp.password=你的邮箱密码
   
   # ------------------- 邮件内容配置 -------------------
   # 发件人邮箱
   mail.from=ft-notify@yourcompany.com
   # 收件人邮箱，多个用逗号分隔
   mail.to=admin@yourcompany.com,ops-team@yourcompany.com
   # 邮件主题模板，支持MQ FT内置变量
   mail.subject=MQ FT传输${result}通知：传输ID ${transferId}
   # 邮件正文模板，同样支持变量，比如传输源文件、目标文件、时间等
   mail.body=传输ID：${transferId}\n状态：${result}\n源文件：${sourceFile}\n目标文件：${destinationFile}\n开始时间：${startTime}\n结束时间：${endTime}
   

   注意：MQ FT提供了很多内置变量可以用在模板里，比如${result}会显示SUCCESS或FAILURE，${sourceFile}是传输的源文件路径，按需调整即可。

3. 重启MQ FT Agent
   配置修改后必须重启agent才能生效，用MQ FT的命令行工具操作：

   • 停止agent：fteStopAgent -p qmname agentname
   • 启动agent：fteStartAgent -p qmname agentname

4. 测试验证
   发起一个测试传输（比如用fteCreateTransfer命令），然后检查：

   • 收件邮箱是否收到对应的通知邮件；
   • Agent日志（路径：\IBM\WebSphereMQ\mqft\logs\qmname\agents\agentname）里有没有退出程序加载和运行的日志，排查可能的错误。

注意事项 #

• 确保两个JAR的版本和你的MQ FT版本兼容，避免出现类加载异常；
• 给agent进程开放访问SMTP服务器的网络权限，否则邮件发不出去；
• 如果需要自定义更多事件处理逻辑，你可以基于mftexit的源码修改，再重新打包成JAR替换原文件。

内容的提问来源于stack exchange，提问作者Kalema Edgar