MFT 数据库记录器表

安装并配置记录器后，将创建多个数据库表。

MFT 记录器数据库模式更新

从 IBM® MQ 9.1开始，在数据库模式中修改了某些数据类型，导致这些表中的列的宽度发生更改:

Db2® 模式
下表中的 LONG VARCHAR 已修改为 Db2 模式中的 VARCHAR ，其固定长度为 2000 字节或 256 个字符。
  • SCHEDULE_ACTION
  • TRANSFER_ITEM
  • SCHEDULE_ITEM
  • TRIGGER_CONDITION
  • CALL_ARGUMENT
  • CALL
  • CALL_REQUEST
  • TRANSFER
  • CALL_RESULT
  • MONITOR_METADATA
  • MONITOR_EXIT_RESULT
  • MONITOR_ACTION
  • AUTH_EVENT
  • FILE_SPACE_ENTRY
缺省情况下，LONG VARCHAR 允许您存储 32700 字节，但 VARCHAR(Size) 将修改后的列大小限制为 2000 字符或 256 个字符。
有关将将Db2数据库迁移到新模式数据库迁移到新模式的更多信息，请参阅Db2。
Oracle 模式
下表中的 NCLOB 已修改为 NVARCHAR(Size)，其中 Size 可以是 2000 字节或 256 个字节：
  • SCHEDULE_ACTION
  • TRANSFER_ITEM
  • SCHEDULE_ITEM
  • TRIGGER_CONDITION
  • CALL_ARGUMENT
  • CALL
  • CALL_REQUEST
  • TRANSFER
  • CALL_RESULT
  • MONITOR_METADATA
  • MONITOR_EXIT_RESULT
  • MONITOR_ACTION
  • AUTH_EVENT
  • FILE_SPACE_ENTRY
缺省情况下，NVARCHAR2 仅允许您存储 4000 字节。 您必须将 MAX_STRING_SIZE 属性设置为 extended，以便数据库将存储器扩展至 32767 字节。
有关将将Oracle数据库迁移到新模式数据库迁移到新模式的更多信息，请参阅Oracle。

在 SOURCE_FILENAME 和 DESTINATION_FILENAME 列的 TRANSFER_ITEM 和 SCHEDULE_ITEM 表中，数据类型为 2000 个字符 (VARCHAR (2000)) 的数据类型在 Db2 和 Oracle 模式中都具有共通性。

AUTH_EVENT

与权限检查相关的事件，通常是由于特权不足而拒绝请求。

  • ID：行标识。
  • ACTION：所发生的操作的类型。
  • COMMAND_ID: 请求事件的原始消息的 IBM MQ 消息标识。 在传输请求的情况下，这还将是传输标识。
  • TIME：发生事件的时间。
  • ORIGINATOR_MQ_USER: IBM MQ 消息中包含的用户标识，对该用户标识执行了权限检查。
  • AUTHORITY：请求的操作所需的权限。
  • ORIGINAL_XML_REQUEST：命令消息的有效内容，表明拒绝了什么操作。
  • RESULTCODE：标识结果的数字代码。
  • RESULT_TEXT：用于说明权限事件的结果的消息。

CALL

远程运行由Managed File Transfer 管理的操作系统命令或Ant [z/OS], or z/OS® JCL job,*。 调用可以嵌入在传输中，或者由 call_request 行引用。

CALL (即，此表中的行) 可以是正常传输的一部分 (在这种情况下， TRANSFER_CALL 用于将其链接到 TRANSFER 中的相关条目) ，也可以是独立受管调用 (仅可从 Ant 或直接插入消息)。 在后一种情况下，会使用 CALL_REQUEST 表而不是 TRANSFERS 表；无需 TRANSFER_CALLS 的等效项，因为每个调用请求只能有一个调用。

  • ID：行标识。
  • COMMAND：运行的命令。 该字段不包括传递到命令的任何自变量，也不包括命令所在路径。
  • TYPE: 命令的类型，例如 Ant 或 JCL。
  • RETRIES：请求的重试次数。
  • RETRY_WAIT：最初请求的在两次重试之间的等待时间间隔（秒）。
  • SUCCESS_RC：表明命令成功完成的返回码。 如果接收到任何其他代码，那么将报告运行失败。
  • EXECUTED_COMMAND：所运行命令的全名，包括路径。
  • CAPPED_RETRIES：可用的重试次数；如果代理的重试限制低于所请求的重试次数，那么该数字可能小于请求的重试次数。
  • CAPPED_RETRY_WAIT：两次重试之间所用的时间间隔；如果代理的已配置限制低于所请求的重试等待时间，那么该数字可能小于请求的时间间隔。
  • OUTCOME：该调用整体上是否成功。 如果尝试了多次，会在 CALL_RESULT 表中单独记录每次尝试的结果。

CALL_ARGUMENT

为调用的命令提供的自变量或参数。

  • ID：行标识。
  • CALL_ID：与自变量关联的调用。
  • KEY：键或名称（在自变量为键值对的情况下）。
  • TYPE：自变量的类型：一些是操作系统命令的位置参数，另一些是用于 Ant 的指定属性。
  • VALUE：自变量的值。

CALL_REQUEST

不属于文件传输的命令调用的工具。 您可以使用 Ant 并使用直接 XML 注入来提交 ManagedCall 消息。

  • ID：受管调用请求的十六进制标识。
  • CALL_ID：CALL 表中描述该调用的行的数据库标识。
  • ACTION_TIME：发生操作的时间。
  • AGENT：运行命令所在的代理。
  • AGENT_QM：运行命令所在的代理所用的队列管理器。
  • ARCHITECTURE：运行代理所在的系统的机器体系结构。
  • OS_NAME：运行代理所在的操作系统的名称。
  • OS_VERSION：操作系统的版本。
  • ORIGINATOR_HOST：从中提交调用请求的机器的主机名。
  • ORIGINATOR_USER：提交调用请求的用户的名称，如请求 XML 中所报告。
  • ORIGINATOR_MQ_USER: 提交调用请求的用户的名称，包含在请求的 IBM MQ 消息描述符中。
  • JOB_NAME：用户指定的作业名。
  • RESULTCODE：调用的整体结果代码。
  • RESULTTEXT：调用的整体结果消息。

CALL_RESULT

调用一条命令的详细结果。 如果启用了重试，那么一个调用可能有多个结果。

  • ID：行标识。
  • CALL_ID：CALL 表中该结果所适用的行的数据库标识。
  • SEQUENCE：该结果所适用的尝试（在尝试了多次的情况下）。
  • OUTCOME：命令的结果（例如，成功或失败）。
  • RETURN_CODE：命令返回码。
  • TIME：完成命令的时间。
  • STDOUT：来自命令的标准输出流（如果已启动）。
  • STDERR：来自命令的标准错误流（如果已启动）。
  • 错误: 如果无法启动命令，那么 Managed File Transfer 会生成一条错误消息来说明问题。

FILE_SPACE_ENTRY

每行都表示已向指定文件空间发送的文件。

  • ID：文件空间条目的标识。
  • FILE_SPACE_NAME：文件空间的名称。 这是文件空间所属用户的名称。
  • TRANSFER_ITEM_ID：与该行相关的传输项的标识。
  • ALIAS：该文件空间条目的别名。 通常，该别名是传输的源文件的名称。
  • DELETED：从文件空间删除文件的时间。 如果尚未删除文件，那么该值为 null。

METADATA

与传输关联的元数据。

  • ID：行标识。
  • TRANSFER_EVENT_ID：该元数据所关联的 transfer_event 行（如果该元数据与传输相关）。 如果元数据与独立受管调用关联，那么该字段为 null。
  • STANDALONE_CALL_ID：如果元数据与独立受管调用关联，那么为相关受管调用请求的标识。
  • KEY：元数据项的名称。
  • VALUE：元数据项的值。

MONITOR

根据外部条件触发 Managed File Transfer 操作的资源监视器。

  • AGENT：运行监视器所在的代理。
  • ID：监视器的十六进制标识。
  • NAME：监视器的名称。
  • QMGR：运行监视器所在的代理的队列管理器。

MONITOR_ACTION

每行都表示针对监视器所发生的操作（例如，创建和触发）

  • ID：行标识。
  • ACTION：所发生的操作的类型。
  • JOB_NAME：所提交的作业的名称（如果适用）。
  • MONITOR：发生该操作所在的监视器。 如果由于针对不存在的监视器请求操作而导致该操作失败，那么这可能为 null。
  • ORIGINAL_XML_REQUEST：如果该操作是 create 或 triggerSatisfied 操作，那么为触发监视器时启动的 XML 请求。
  • ORIGINATOR_MQ_USER: 启动操作的 IBM MQ 消息中包含的用户标识
  • ORIGINATOR_USER：提交请求以执行操作的用户名。
  • ORIGINATOR_HOST：用户从中提交请求以执行操作的机器。
  • TIME：发生操作的时间。
  • UPDATED_XML_REQUEST：如果操作是 triggerSatisfied，那么为启动的 XML 请求。 该请求可能会由于变量替换而不同于最初发出的 XML 请求。

MONITOR_EXIT_RESULT

运行资源监视器出口的结果。

  • ID：行标识。
  • ACTION_ID：与结果关联的监视器操作。
  • EXIT_NAME：产生该结果的出口的名称。
  • RESULTCODE：出口返回的值，取消或继续。
  • RESULTTEXT：来自出口的文本输出（如果有提供）。

MONITOR_METADATA

与资源监视器关联的元数据项。

  • ID：行标识。
  • ACTION_ID：与元数据关联的 monitor_action。
  • KEY：元数据项的名称。
  • PHASE：该元数据项是表示最初提交的数据还是变量替换之后的更新版本。
  • VALUE：元数据项的值。

SCHEDULE

向代理注册的传输调度。

  • AGENT：具有该调度的代理的名称。
  • CREATION_DATE：创建该调度的时间点。
  • ID：该调度的唯一数据库（而不是代理）标识。
  • ID_ON_AGENT：代理针对数据库标识所使用的标识。 该标识在代理之间不是唯一的，甚至可能在同一个代理中也不是唯一的（如果重置了代理的持久性状态）。
  • LATEST_ACTION：修改该调度的状态的最近操作。

SCHEDULE_ACTION

在发生修改调度状态的事件时，会记录一个操作。

  • ACTION_TYPE：发生的操作。
  • ID：行标识
  • ORIGINATOR_HOST：从中提交更改请求的机器。
  • ORIGINATOR_USER：提交更改请求所用的用户名。
  • SCHEDULE_ID：该操作所适用的调度。
  • SPEC_AFTERWARDS：用于表示该调度在发生操作之后的状态的 schedule_spec。
  • STATUS_CODE：用于描述操作结果的数字返回码。
  • STATUS_TEXT：操作结果的文本描述。 如果操作成功，通常为 null。
  • TIME：发生操作的时间点

SCHEDULE_SPEC

个别调度传输的详细信息。

  • ID：行标识。
  • DESTINATION_AGENT：文件传输到的代理。
  • DESTINATION_QM：目标代理所用的队列管理器。
  • REPEAT_COUNT：如果调度重复并受出现次数而不是结束时间约束，那么为重复的次数。
  • REPEAT_FREQUENCY：调度的传输之间存在的 repeat_interval 数。
  • REPEAT_INTERVAL：如果传输重复，那么为发生重复的时间间隔（例如，分钟数或周数）。
  • SOURCE_AGENT：从中传输文件的代理。
  • SOURCE_QM：源代理所用的队列管理器。
  • START_TIME：调度中的第一个传输将发生的时间。
  • START_TIMEBASE：针对与传输关联的时间的时基。 例如，是根据代理的时区还是管理员的时区来运行。
  • START_TIMEZONE：对应于时基且将用于运行调度的时区。

SCHEDULE_ITEM

每个文件（或传输时要匹配的模式）都由 schedule_item 来表示。

  • ID：行标识。
  • CHECKSUM_METHOD：文件的校验和的计算方式
  • DESTINATION_EXISTS_ACTION：目标代理在目标处已存在该文件时所采取的操作。
  • DESTINATION_FILENAME：文件传输到的文件或目录。
  • DESTINATION_QUEUE：文件到消息传输的目标队列名称。
  • [UNIX、Linux、Windows、IBM i]目的地类型： Whether the destination_filename column refers to a file or directory.
  • [z/OS]目的地类型： Whether the destination_filename column refers to a file, directory, or data set.
  • FILE_MODE：传输文件所用的方式（例如，text 或 binary）。
  • RECURSIVE：在代理根据调度创建传输时，代理是 (Y) 否 (N) 对源目录进行递归操作。
  • SCHEDULE_SPEC_ID：与该项关联的 schedule_spec。
  • SOURCE_DISPOSITION：传输完成之后要对源文件执行的操作。
  • SOURCE_FILENAME：源文件、目录名称或模式。
  • SOURCE_QUEUE：消息到文件传输的源队列名称。

TRANSFER

一个或多个文件的单个传输。

  • TRANSFER_ID：传输的十六进制标识。
  • JOB_NAME：传输的用户指定作业名。
  • SCHEDULE_ID：如果该传输是调度的结果，那么为相关调度的数据库行标识。
  • START_ID：表示传输开始的 transfer_event 的行标识。
  • COMPLETE_ID：表示传输结束的 transfer_event 的行标识。
  • RESULTCODE：传输的整体结果代码。 以下主题中列出了此列的可能值: MFT的返回码。 这些代码适用于整个传输; 请参阅 TRANSFER_ITEM.RESULTCODE 表示每个单独项的状态。
  • RESULTTEXT：传输的整体结果文本（如果存在）。
  • STATUS：传输的状态。 该列的可能值为已启动、成功、部分成功、失败和已取消。
  • RELATED_TRANSFER_ID：与该传输相关的先前传输的十六进制标识。 例如，如果传输是文件下载，那么此字段将引用上载文件的传输。

TRANSFER_CALLS

链接对传输的可运行命令调用

  • ID：行标识。
  • POST_DESTINATION_CALL：传输完成之后在目标处进行的调用。
  • POST_SOURCE_CALL：传输完成之后在源代理处进行的调用。
  • PRE_DESTINATION_CALL：传输开始之前在目标代理处进行的调用。
  • PRE_SOURCE_CALL：传输开始之前在源代理处进行的调用。
  • TRANSFER_ID：与该行中的调用关联的传输。

TRANSFER_CD_NODE

有关传输中使用的 Connect:Direct® 节点的信息。

  • PNODE：传输中的主节点。
  • SNODE：传输中的辅助节点。
  • BRIDGE_IS_PNODE: 指示哪个节点是属于 Connect:Direct 网桥的节点的字符。 如果该值为 Y，那么主节点为网桥节点。 如果该值为 N，那么辅助节点为网桥节点。
  • ID：该行的标识。

TRANSFER_CORRELATOR

每行包含一个关联字符串以及与传输项关联的数字。

  • CORRELATION_BOOLEAN：布尔关联值。 以单个字符 Y 表示 true，并以 N 表示 false。
  • CORRELATION_STRING：字符串关联值。
  • CORRELATION_NUMBER：数字关联值。
  • ID：该行的标识。

TRANSFER_EVENT

与传输相关的事件（开始或结束）。

  • ID：行标识。
  • ACTION_TIME：发生传输操作的时间。
  • SOURCE_AGENT：从中传输文件的代理的名称。
  • SOURCE_AGENT_TYPE：从中传输文件的代理的类型。 可能为以下值：1 = STANDARD、2 = BRIDGE、3 = WEB_GATEWAY、4 = EMBEDDED、5 = CD_BRIDGE、6 = SFG。
    注: 从 IBM MQ 9.0开始， Managed File Transfer 不支持 Web 网关或 Web 代理程序。
  • SOURCE_QM：源代理所用的队列管理器。
  • SOURCE_ARCHITECTURE：托管源代理的系统的机器体系结构。
  • SOURCE_OS_NAME：源代理机器的操作系统。
  • SOURCE_OS_VERSION：源代理机器的操作系统版本。
  • SOURCE_BRIDGE_URL：如果源代理为协议网桥代理，那么为该代理与之形成网桥的数据源的 URL。
  • SOURCE_CD_NODE_ID: 作为传输源的 Connect:Direct 节点。
  • DESTINATION_AGENT：文件传输到的代理的名称。
  • DESTINATION_AGENT_TYPE：文件传输到的代理的类型。 可能为以下值：1 = STANDARD、2 = BRIDGE、3 = WEB_GATEWAY、4 = EMBEDDED、5 = CD_BRIDGE、6 = SFG。
    注: 从 IBM MQ 9.0开始， Managed File Transfer 不支持 Web 网关或 Web 代理程序。
  • DESTINATION_QM：目标代理所用的队列管理器。
  • DESTINATION_BRIDGE_URL：如果目标代理为网桥代理，那么为该代理与之形成网桥的数据源的 URL。
  • DESTINATION_CD_NODE_ID: 作为传输目标的 Connect:Direct 节点。
  • ORIGINATOR_HOST：从中提交传输请求的机器的主机名。
  • ORIGINATOR_USER：提交传输请求的用户的名称，由 fteCreateTransfer 命令所报告。
  • ORIGINATOR_MQ_USER: 提交传输请求的用户的名称，包含在请求的 IBM MQ 消息描述符中。
  • TRANSFERSET_TIME：创建传输集的时间。
  • TRANSFERSET_SIZE：传输的项数。
  • TRIGGER_LOG：对于涉及触发器的传输定义，是否记录未导致传输的触发器求值。

TRANSFER_EXIT

每行都表示在文件传输的过程中执行的传输出口。

  • ID：行标识。
  • EXIT_NAME：出口的名称。
  • TRANSFER_ID：该出口所适用的已完成或已取消传输的标识。
  • TYPE：出口的类型。 这可以是以下某个值：SourceStart、SourceEnd、DestinationStart 或 DestinationEnd。
  • STATUS：出口返回的值。 这可以是 cancel 或 proceed。
  • SUPPLEMENT：用于说明出口状态的可选消息。

TRANSFER_ITEM

每行都表示在传输的过程中发送的文件。

  • DESTINATION_CHECKSUM_METHOD：用于计算目标文件的校验和的算法。 如果由于传输未成功完成而未计算校验和，那么这可能为 null。
  • DESTINATION_CHECKSUM_VALUE：目标文件的校验和值。 如果禁用了校验和计算，那么该值可能为 null。
  • DESTINATION_ENCODING：如果目标文件以文本形式传输，那么为目标文件上使用的字符编码。
  • DESTINATION_EXISTS_ACTION：在目标处存在该文件时要执行的操作。
  • DESTINATION_FILE_SIZE：目的地使用的文件名[z/OS]数据集名 的大小。
  • destination_filename：目的地使用的文件名[z/OS]数据集名称 。
  • DESTINATION_LINEEND：如果目标文件以文本形式传输，那么为目标文件中使用的行尾格式。
  • DESTINATION_MESSAGE_QUEUE_NAME：在文件到消息的传输期间，从源文件中生成的消息的目标队列。
  • DESTINATION_MESSAGE_GROUP_ID：如果生成了多条消息，那么为文件到消息的传输期间，用于从源文件中生成的消息的组标识。
  • DESTINATION_MESSAGE_MESSAGE_ID：如果仅生成了一条消息，那么为文件到消息的传输期间，从源文件中所生成消息的消息标识。
  • DESTINATION_MESSAGE_COUNT：在文件到消息的传输期间，将源文件分割为的消息数。
  • DESTINATION_MESSAGE_LENGTH：在文件到消息的传输期间，从源文件中生成的消息的长度（字节）。 仅当指定输出消息的长度 (例如，使用 fteCreateTransfer 命令的 -qs 选项) 时，才会设置此值。 如果指定 -qs 20K 并且源文件的大小为 50 KB ，那么生成的三条消息的大小分别为 20 KB ， 20 KB 和 10 KB。 在此情况下，DESTINATION_MESSAGE_LENGTH 的值设置为 20480。
  • DESTINATION_CORRELATOR_ID：针对目标的相关因子信息的标识。
  • FILE_MODE：文件传输方式，例如 text 或 binary。
  • ID：行标识
  • RESULTCODE：用于表明该项的传输结果的数字代码。 以下主题中列出了此列的可能值: 传输中文件的返回码。 这些代码适用于传输中的各个项; 请参阅 TRANSFER.RESULTCODE 表示整个传输结果。
  • RESULT_TEXT：传输结果的文本说明。 如果传输成功，通常为 null。
  • SOURCE_CHECKSUM_METHOD：用于计算源文件的校验和的算法。
  • SOURCE_CHECKSUM_VALUE：源文件的校验和值。 如果禁用了校验和计算，那么该值可能为 null。
  • SOURCE_DISPOSITION：传输完成时要对源文件执行的操作。
  • SOURCE_ENCODING：如果源文件以文本形式传输，那么为源文件上使用的字符编码。
  • SOURCE_FILE_SIZE：要在源文件中使用的文件名[z/OS]数据集名 的大小。
  • 源文件名： The source file name[z/OS] or data set name .
  • SOURCE_LINEEND：如果源文件以文本形式传输，那么为源文件中使用的行尾格式。
  • SOURCE_MESSAGE_QUEUE_NAME：针对消息到文件的传输，目标文件中包含的消息的源队列。
  • SOURCE_MESSAGE_GROUP_ID：针对消息到文件的传输，目标文件中包含的消息的组标识。
  • SOURCE_MESSAGE_COUNT：针对消息到文件的传输，目标文件中包含的消息数。
  • SOURCE_CORRELATOR_ID：针对源的相关因子信息的标识。
  • TRANSFER_ID：该项所属的传输。
  • TRUNCATE_RECORDS：指示将截断还是合并超过长度的数据集记录。

TRANSFER_STATS

在传输结束时生成的统计信息集。

  • ID：行标识。
  • TRANSFER_ID：统计信息所引用的传输。
  • START_TIME：开始传输的时间。 在繁忙或间歇性连接的系统中，该时间可能晚于“已启动”消息中报告的时间，因为后者表示初始处理的开始时间点，而不是成功数据传输的开始时间点。
  • RETRY_COUNT：由于装入或可用性问题而必须重试传输的次数。
  • FILE_FAILURES：未能传输的文件数。
  • FILE_WARNINGS：传输时针对其报告了警告的文件数。

TRIGGER_CONDITION

基本 Managed File Transfer 条件传输中的一个条件。 例如，“文件 example.file 存在”。

  • ID：行标识。
  • TRANSFER_EVENT_ID：与触发器相关的传输事件。
  • CONDITION_TYPE：触发器中使用的检查类型。 例如，文件是否存在，或者文件的大小。
  • COMPARISON：要进行的特定比较。 例如，“大于或等于”。
  • VALUE：要进行比较的值。
  • FILENAME：要检查的文件名。