适配器跟踪任务相关的用户出口样本程序 (DFH$APDT)

DFH$APDT 是任务相关的用户出口 (TRUE) 样本程序,它包含可用于事务跟踪的适配器数据字段。

在源代码和对象代码中都提供了样本出口程序 DFH$APDT。 源在 hlq.SDFHSAMP 样本库中提供,并在 hlq.SDFHLOAD 装入库中提供可执行格式。 在生产环境中使用此样本程序之前,必须对其进行定制。

可以通过以下两种方法之一使用 DFH$APDT 样本 TRUE 程序:
  • 可以对 TASKSTART 启用此命令,例如,使用命令 EXEC CICS ENABLE PROGRAM(DFH$APDT) TASKSTART START ,以便在每个任务的开始和结束时调用此命令。 该出口设置对每个任务的上下文管理感兴趣,并且每次后续任务发出 START 命令时都调用该出口。
  • 可以使用 EXEC CICS ENABLE PROGRAM(DFH$APDT) START 命令对其进行启用和启动。 然后,应用程序可以使用 DFHRMCAL 请求来启动出口。 出口集对上下文管理感兴趣,并且将针对应用程序发出的每个后续 START 命令调用该出口。
注: 如果已设置适配器数据,那么 DFH$APDT 样本不会尝试对其进行更改。

当您对事务的上下文管理设置兴趣时,该事务发出的所有后续 START 请求都会导致调用出口并设置适配器数据字段。 在 DFH$APDT 样本中,这些字段是从常量设置的,但对于实际适配器,其内容基于上下文。 CICS® 使用这些字段的内容来填充正在启动的任务的关联数据的原始数据部分中的适配器数据字段。 然后,此关联数据可用于事务跟踪。