FEPI 日志记录

本部分描述了 FEPI 日志记录的格式以及如何打印这些记录。 通过在属性集定义中使用 MSGJRNL、 FJOURNALNUM 和 FJOURNALNAME 选项，可以将 FEPI 日志记录写入 CICS® 用户日记账。 每个 FEPI 日志记录都有一个前缀区域，其中包含与 FEPI 相关的信息，基于这些信息，您可以使用 CICS提供的程序 DFHJUP 来选择要打印的 FEPI 记录。

FEPI 日志操作

您可以要求 FEPI 将入站、出站或入站和出站数据写入指定的 CICS 用户日志；但不能写入系统日志。 这是使用属性集定义中的 MSGJRNL， FJOURNALNUM和 FJOURNALNAME 选项完成的。

在使用 CICS 日志记录的各种原因中，以下内容与 FEPI 处理特别相关:
  • 创建审计跟踪
  • 监控性能
  • 控制消息安全性

表 1 显示了可记入日志的 FEPI 数据的类型。

表 1. FEPI 已记录数据
FEPI 命令 数据流 类型
SEND 出站 数据流格式化，屏幕图像格式化，按键
RECEIVE 入站 数据流格式化，屏幕图像
CONVERSE 出站 数据流格式化，屏幕图像格式化，按键
CONVERSE 入站 数据流格式化，屏幕图像
抽取字段 入站 抽取字段数据

由 FEPI 记录的记录通常由模块和函数标识来标识。 这些在 表 2中列出。

表 2。 FEPI 日志记录标识
标识类型 姓名 值 数据类型
模块标识 MODIDFEP X'5D' 标识日志中的 FEPI 记录
函数标识 fidfepin fidfepou X 'F0' X 'F1' 标识 FEPI 入站数据标识 FEPI 出站数据

FEPI 日志记录结构

每个 FEPI 日志记录都包含一个前缀区域，该区域包含与 FEPI 相关的信息，例如记录数据的对话。 要使用批处理作业 (如 CICS提供的实用程序 DFHJUP) 选择要打印的 FEPI 日志记录，必须了解 FEPI 前缀区域的结构。

FEPI 前缀区域位于 API 用户头中，如 图 1中所示。

图 1。 API 用户头的格式，显示前缀区域的位置
该图显示了 API 用户头的格式，其字段列示在下表中。

下表中还概述了 API 用户头中的那些字段。

表 3。 API 用户头中的字段
字段 长度 描述
CL_UH_长度 4 字节 头的长度
cl_uh_journal_type 2 字节 日志类型
保留的 2 字节 保留字段
cl_uh_prefix_length 4-字节 前缀的长度
prefix area 变量 prefix area
用户数据 变量 用户数据

此 FEPI 前缀区域的准确格式如 图 2所示。

图 2。 FEPI 前缀区域的格式
图为 FEPI 前缀区域的格式，其字段如下表所述。

下表中还汇总了 FEPI 前缀区域中的那些字段。

表 4。 FEPI 前缀区域的字段
字段 长度 描述
UP_MODFN 1 字节 模块函数
UP_SVMID 1 字节 模块标识
UP_FEPPDF 1 字节 数据函数。
字段 UP_FEPDF 可以采用以下任何值:
  • 具有字段名 UP_FEPDD 的值 1 表示数据流。
  • 值为 2 ，字段名称为 UP_FEPDS ，表示已格式化，屏幕图像。
  • 值 3 ，字段名为 UP_FEPDK ，表示格式化，击键
  • 具有字段名 UP_FEPDE 的值 4 表示抽取字段数据
UP_FEPES 1 字节 击键的转义字符
保留的 2 字节 保留字段
UP_FEPPL 8 字节 池名
UP_FEPTG 8 字节 目标名
UP_FEPCV 8 字节 对话标识
保留的 4 字节 保留字段

有关如何使用 CICS提供的实用程序 DFHJUP 来选择要打印的 FEPI 记录的示例，请参阅 使用批处理作业读取日志流 (DFHJUP)。

有关日志记录的更多信息，请参阅 日志记录。