创建并存储 DTCN 概要文件

您可以通过以下方式创建和存储 DTCN 概要文件或 CICS 概要文件:

通过使用 DTCN 事务。这些主题中的其余信息描述了如何执行此操作。
通过在 Eclipse IDE 中的 z/OS Debugger 概要文件视图或随 Z Open Debug提供的 z/OS Debugger 概要文件视图中创建 CICS 概要文件。请参阅使用 Eclipse IDE 为 CICS 应用程序创建调试概要文件或使用 Z Open Debug 为 CICS 应用程序创建调试概要文件。

DTCN 事务将调试概要文件存储在存储库中。存储库可以是 CICS® 临时存储器队列或 VSAM 文件。以下列表描述了使用 CICS 临时存储器队列或 VSAM 文件之间的差异:

如果未登录到 CICS 或以缺省用户身份登录，那么无法使用 VSAM 文件。必须使用 CICS 临时存储器队列。
如果使用 CICS 临时存储器队列，那么如果创建概要文件的终端已断开连接或者 CICS 区域已终止，那么将删除该概要文件。如果使用 VSAM 文件，那么概要文件将通过断开连接或 CICS 区域重新启动来持久存储。
如果使用 CICS 临时存储器队列，那么单个终端上只能有一个概要文件。如果使用 VSAM 文件，那么可以在单个终端上存在多个概要文件，每个概要文件由不同的用户创建。

z/OS® Debugger 根据是否存在调试概要文件 VSAM 文件来确定使用的存储方法。如果 z/OS Debugger 找到分配给 CICS 区域的调试概要文件 VSAM 文件，那么假定您使用 VSAM 文件作为存储库。如果找不到调试概要文件 VSAM 文件，那么假定您使用 CICS 临时存储器队列作为存储库。请参阅 IBM® z/OS Debugger Customization Guide 或联系系统程序员以获取有关如何创建和管理 VSAM 文件的更多信息。

如果存储库是临时存储器队列，那么每个概要文件都将保留在存储库中，直到发生下列其中一个事件为止:

输入概要文件的终端将显式删除该概要文件。
DTCN 检测到创建概要文件的终端已断开连接。
CICS 区域已终止。

如果存储库是 VSAM 文件，那么将保留每个概要文件，直到显式删除该文件为止。 DTCN 事务使用用户标识来标识概要文件。因此，每个用户标识只能有一个概要文件存储在 VSAM 文件中。

概要文件处于活动或不活动状态。如果概要文件处于活动状态，那么 DTCN 会尝试将其与使用概要文件中指定的资源的事务进行匹配。 DTCN 不会尝试将事务与不活动概要文件相匹配。要使概要文件处于活动状态或不活动状态，请使用 z/OS Debugger CICS Control -Primary Menu 面板 (主 DTCN 面板) 使概要文件处于活动状态或不活动状态，然后保存该概要文件。如果存储库是 VSAM 文件，那么当 DTCN 检测到终端已断开连接时，它会使概要文件处于不活动状态。

要创建和存储 DTCN 概要文件:

登录到 CICS 终端并输入事务标识 DTCN。 DTCN 事务显示主 DTCN 屏幕 z/OS Debugger CICS Control -主菜单，如下所示。

 DTCN               z/OS Debugger CICS Control - Primary Menu             S07CICPD
                           * VSAM storage method *    1           
 Select the combination of resources to debug (see Help for more information)  
  Terminal Id     ==> 0090                                                     
  Transaction Id  ==>                                                          
  LoadMod::>CU(s) ==>          ::>                ==>          ::>             
                  ==>          ::>                ==>          ::>             
                  ==>          ::>                ==>          ::>             
                  ==>          ::>                ==>          ::>             
  User Id         ==> CICSUSER                                                 
  NetName         ==>                                                          
  IP Name/Address ==>                                                          
 Select type and ID of debug display device                                    
  Session Type    ==> MFI                 MFI, TCP, DTC, RDS            
  Port Number     ==>                     TCP Port                             
  Display Id      ==> 0090                                                     
                                                                               
 Generated String:  TEST(ERROR,'*',PROMPT,'MFI%0090:*')                        
                                                                               
 Repository String: No string currently saved in repository                    
                                                                               
 Profile Status:    No Profile Saved. Press PF4 to save current settings.      
                                                                               
 PF1=HELP 2=GHELP 3=EXIT 4=SAVE 5=ACT/INACT 6=DEL 7=SHOW 8=ADV 9=OPT 10=CUR TRM

1 行显示一条消息，指示 DTCN 将在临时存储器队列或 VSAM 文件中存储概要文件。将使用下列其中一个源中的值来填充某些输入字段:

如果临时存储器队列是存储库类型，那么对于在此终端上运行的任务，将使用以全屏幕方式启动 z/OS Debugger的缺省值来填充这些字段。
如果 VSAM 文件是存储库类型，并且存在当前用户的概要文件，那么将使用该概要文件中找到的数据来填充这些字段。如果 VSAM 文件是存储库类型，并且当前用户不存在概要文件，那么对于在此终端上运行的任务，将使用以全屏方式启动 z/OS Debugger的缺省值来填充这些字段。

如果您不想更改这些字段，那么可以跳过接下来的两个步骤并继续执行步骤 4。如果要更改此面板上的设置，请继续执行下一步。

指定用于标识要调试的事务或程序的资源组合。有关这些字段的更多信息，请执行下列其中一项任务:
- 阅读 DTCN 主菜单屏幕上的字段描述。
- 将光标置于字段旁边，然后按 PF1 以显示联机帮助。
指定要运行的调试会话的类型以及显示调试会话的设备的标识。有关这些字段的更多信息，请执行下列其中一项任务:
- 阅读 DTCN 主菜单屏幕上的字段描述。
- 将光标置于字段旁边，然后按 PF1 以显示联机帮助。
通过按 PF9 以显示辅助选项菜单 (类似于以下示例) ，指定要用于调试会话的 TEST 运行时选项，其他运行时选项，命令文件，首选项文件和 EQAOPTS 文件:
```
 DTCN               z/OS Debugger CICS Control - Menu 2               S07CICPD

 Select z/OS Debugger options
 Test Option     ==> TEST                Test/Notest
 Test Level      ==> ERROR               All/Error/None
 Commands File   ==> *
 Prompt Level    ==> PROMPT
 Preference File ==> *

 EQAOPTS File    ==>

 Any other valid Language Environment options
 ==>



 PF1=HELP 2=GHELP 3=RETURN
```
对于在此终端上运行的任务，将使用以全屏幕方式启动 z/OS Debugger的缺省值来填充某些输入字段。如果您不想更改缺省值，那么可以跳过此步骤的其余部分并继续执行步骤 5。如果要更改此面板上的设置，请继续执行此步骤。
按 PF3 以返回到主 DTCN 面板。

如果要使用通过 COMMAREA 或容器传递的数据来帮助确定要调试的事务和程序，请按 PF8。此时将显示 " 高级选项 " 面板，此面板类似于以下示例:

 DTCN               z/OS Debugger CICS Control - Advanced Options         S07CICPD 
                                                                                
 Select advanced program interruption criteria:                                 
                                                                                
 Commarea Offset  ==> 0                                                         
 Commarea Data    ==>                                                           
                                                                                
 Container Name   ==>                                                           
 Container Offset ==> 0                                                         
 Container Data   ==>                                                           
                                                                                
 URM Debugging    ==> NO                                                        
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 Default offset and data representation is decimal/character.                   
 See Help for more information.                                                 
                                                                                
                                                                                
                                                                                
 PF1=HELP 2=GHELP 3=RETURN

可以在 COMMAREA 或容器中指定数据，但不能同时指定两者。您还可以使用此面板来指示是否要调试用户可更换模块 (URM)。有关这些字段的更多信息，请执行下列其中一项任务:

阅读 DTCN 主菜单屏幕上的字段描述。
将光标置于字段旁边，然后按 PF1 以显示联机帮助。

按 PF3 以返回到主 DTCN 面板。
按 PF4 以保存概要文件。 DTCN 对您在 DTCN 面板中输入的数据执行数据验证。当 DTCN 发现错误时，它会将光标置于错误字段中并显示一条消息。您可以使用上下文相关帮助 (PF1) 来查找输入的错误。
按 PF5 以将状态从 "活动" 更改为 "不活动" ，或从 "不活动" 更改为 "活动"。概要文件有三种可能的状态:

未保存概要文件

尚未为此终端创建概要文件。

主动

概要文件对于模式匹配处于活动状态。

不活动

将跳过此概要文件的模式匹配。
在存储库中保存概要文件后， DTCN 会在显示字段 "存储库字符串" 中显示已保存的 TEST 字符串。如果您对保存的概要文件感到满意，请按 PF3 以退出 DTCN。

现在，在 CICS 系统中运行并与先前步骤中指定的资源匹配的任何任务都将启动 z/OS Debugger。

请参阅以下主题，以获取与本主题中讨论的材料相关的更多信息。

相关任务
显示活动 DTCN 概要文件的列表并管理 DTCN 概要文件
相关参考
"DTCN 主菜单" 屏幕上字段的描述
IBM z/OS Debugger Customization Guide 中 DTCD 事务的描述