使用 IMS 事务隔离来创建专用消息处理区域并选择要调试的事务

注意：本部分不适用于 IBM® 开发者 z/OS® （非 Enterprise Edition ）或 IBM Z and Cloud Modernization Stack （Wazi Code ）。

z/OS Debugger的 IMS 事务隔离设施允许您在与相同程序的其他用户隔离的环境中调试 IMS 消息处理程序 (MPP)。如果 IMSplex 使用共享队列，那么您可以注册事务，启动区域或从单个连接执行任何其他操作，并且 IMS 事务隔离设施将通知其他 LPAR 这些操作。

通过使用 IMS 事务隔离设施，您可以执行以下任务:

显示可用于给定 IMS 子系统的事务的列表。
从该事务列表中，注册以调试为您使用而创建的专用消息区域中的特定事务。
对于已注册调试的事务，请指定其他模式匹配信息，例如发送到事务的消息的内容。这允许您在特定条件下捕获事务。
根据所选事务的执行环境来启动专用消息处理区域。专用消息处理区域配置为使用延迟调试方式，并硬编码为从延迟调试概要文件数据集读取延迟调试首选项。有关延迟调试的更多信息，请参阅使用延迟调试方式来延迟调试会话的启动。
通过为 STEPLIB 并置提供个人库来定制专用消息区域。

要使用 IMS 事务隔离设施，请执行以下任务:

启动 IBM z/OS Debugger 实用程序。有关更多信息，请参阅启动 IBM z/OS Debugger 实用程序。
在 IBM z/OS Debugger Utilities 面板 (EQA@PRIM) 中，在 "选项" 行中输入 4 并按 Enter 键。
在 " 管理 IMS 消息处理程序 " 面板 (EQAPRIS) 中，在 "选项" 行中输入 5 ，然后按 Enter 键。

此时将显示 " IMS 事务隔离设施 " 面板 (EQAPMPSL)。以下屏幕突出显示面板中的字段。


--------------- IMS Transaction Isolation Facility ---------- Row 1 to 7 of 201
 Command ===>                                   Scroll ===> PAGE

IMS system . . . . . . IMS1  1 

 2  _ Manage additional libraries and delay debug options.
       Your region: @USRT001 Class 021 Stopped 
       Delay debug data set: 'USRT001.DLAYDBG.EQAUOPTS'

  Filters:  3 
   / Display full transaction list.
   _ Display only transactions you are registered to debug.
   _ Filter by name ==> dtmq   
__ 4 __50 Maximum number of transactions (0 - no limit)

(E) Edit  (S) Start Region  (P) Stop Region  (R) Register  (D) De-register
Sel   Transaction  PSB name  Reserved user    Region name    Status
_  5   ADDINV      DFSSAM04
_      ADDPART     DFSSAM04
_      APOL11      APOL1
_      APOL12      APOL1
_      APOL13      APOL1
_      APOL14      APOL1
 F1=Help      F3=Exit      F4=IMSIDLst  F7=Backward  F8=Forward  F12=Cancel

1 IMS 系统

指定调试所在的 IMS 子系统标识。

按 F4 以接收为 IMS 事务隔离设置的 IMS 子系统的列表。

2 管理其他库和延迟调试选项

在输入字段中放置正斜杠 (/) ，然后按 Enter 键以显示 " 管理其他库和延迟调试 " 面板 (EQAPMPRG)。

3 过滤器

您可以使用这些选择来更改针对所选 IMS 子系统显示的事务。

4 最大事务数

此值限制为给定过滤器显示的事务数。如果与过滤器匹配的事务多于所显示的事务，那么将显示一条消息。

注: 如果设置过高的限制或输入 0 以不设置限制，那么此面板的性能将显着下降。

5 事务操作字符

可以对列出的每个事务执行以下操作:

操作	功能	描述
E	编辑	显示编辑模式匹配参数面板 (EQAPMPED)。
S	启动区域	根据所选事务的当前执行环境来启动专用消息处理区域。如果未启动区域，那么它还将注册以调试事务。
P	停止区域	停止您启动的专用消息处理区域。
R	寄存器	注册以调试所选事务。在 IMS 子系统中调度事务的消息时，如果满足所有模式匹配参数，那么会将该消息路由到专用消息处理区域。
D	注销	除去注册以调试所选事务。不再将消息路由到此事务的专用消息处理区域。

在 " 管理其他库和延迟调试 " 面板 (EQAPMPRG) 中，可以执行以下任务:
1. 编辑延迟调试选项数据集。
2. 指定专用消息区域的 Language Environment ® 选项。
3. 将数据集添加到消息区域 STEPLIB 并置。
当 z/OS Debugger 创建专用消息处理区域时，如果分配了延迟调试选项数据集，那么专用消息处理区域处于延迟调试方式。这允许您使用延迟调试选项数据集来控制所使用的 TEST 选项和捕获的程序。

如果未分配延迟调试数据集，那么 z/OS Debugger 将创建具有硬编码 CEEOPTS DD 的专用消息处理区域。硬编码 CEEOPTS DD 包含字符串 TEST (ALL ， * ， PROMPT ， VTAM ®%userid: *) ，其中 userid 是您的 TSO 用户标识。

由 IMS 隔离启动的所有专用消息处理区域都包含 CEEOPTS DD 卡。您可以使用其他运行时选项字段为此 CEEOPTS DD 指定其他 Language Environment 选项。

要将数据集添加到专用消息处理区域的 STEPLIB ，请在面板底部的数据集表的 Cmd 列中输入 I。这将向表中添加空行，您可以使用数据集名称和处置完成此行。

表中的每个数据集都将按表中指定的顺序添加到专用消息处理区域的 STEPLIB 并置的开头。您可以通过修改 Seq 列中的值来更改表中数据集的相对位置。

要对 DD 卡进行更高级的操作，可以在 DD 卡的 Cmd 列中输入正斜杠 (/) ，然后按 Enter 键。将显示一个菜单，您可以在此菜单中更改分配参数， DCB 参数以及在数据集的 DD 卡上指定的其他特征。
以下屏幕突出显示编辑模式匹配参数面板 (EQAPMPED) 上的字段。
```
---------------------- Edit pattern-matching parameters ---------------------
 Command ===> __________________________________________    Scroll ===> CSR 

 Message processing program debug settings:

 Region class  . . .  007           Region name . . @USER1 
 Transaction . . . .  IVTCV                             
 User ID to match. .  USER1  1                             
 Transaction Message  rrr  2                               
    Range start  . .  12  3                                 
    Range length . .  32  4  
   5  Match case /      6  Data is hex _











  F1=Help             F3=Exit      F4=Run      F5=Findnext     F7=Backward
  F8=Forward         F10=Submit   F12=Cancel
```
1 要匹配的用户标识

此字段指定在运行所选事务的给定实例时用于与用户标识匹配的用户标识或模式。该值可以是完整用户标识或以字符 "*" 结尾的模式。

2 事务消息

您在此字段中输入的数据用于与针对所选事务调度的所有消息进行匹配。如果您输入的字符串包含在消息中，那么如果还满足其他模式匹配参数 (请参阅 5 和 6 ) ，那么会将该消息视为匹配。

3 范围开始

要检查的第一个位置。通常可以在位置 1 中找到事务名称，这是范围的缺省开始。

4 范围长度

要扫描的最大字节数。如果未给出长度，那么范围在消息段的末尾结束。

5 匹配大小写

在输入字段中放置正斜杠 (/) 以指示如果所有字符都匹配 (包括其大小写) ，那么将 "事务消息" 中的字符串视为匹配。

6 数据为十六进制

在输入字段中放置正斜杠 (/) 以指示 "事务消息" 中的字符串是十六进制字符串。