SET DUMPDS

更改事务转储数据集的状态。

语法

警告系统命令功能强大，可提供有关系统状态的信息，并允许对系统进行更改。系统命令只能由授权应用程序和用户使用。

通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。

SET DUMPDS

条件: INVREQ ， IOERR 和 NOTAUTH

NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。命令语法图和选项说明中没有明确包含这些选项。有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。

描述

SET DUMPDS 命令允许您更改 CICS® 事务转储数据集的状态。通常，存在其中一个 (称为 "A" 转储数据集) ，或者存在两个 ("A" 和 "B")。一个是 active (接收转储) ，另一个 (如果有两个) 是 inactive (备用)。具体来说，您可以:

打开或关闭活动数据集。
切换活动数据集和备用数据集的角色。
请求 CICS 在活动数据集已满时自动切换。
指定下次初始化 CICS 时哪个数据集处于活动状态。

注: 如果在没有任何事务转储数据集的情况下初始化 CICS 系统，那么只有最后两个功能可用。

在进行所请求的更改之前，控制不会返回到发出命令的任务。

选项

INITIALDDS (data-value)

以 1 字符值的形式指定在后续热重新启动或紧急重新启动时首先要激活的转储数据集。此值记录在 CICS 全局目录中，并覆盖 DUMPDS 系统初始化参数最初设置的先前值。

允许的值为 A ， B 和 X。 X 表示 CICS 将使用在 CICS 上次终止 (正常或异常) 时处于不活动状态的数据集; 它对应于 DUMPDS 参数的 AUTO 设置。

OPENSTATUS (cvda)

指定要对事务转储数据集执行的操作。 CVDA 值如下：

CLOSED: 将关闭活动的 CICS 转储数据集。
OPEN: 将打开活动的 CICS 转储数据集。
switch: 如果有两个转储数据集，那么将切换转储数据集的角色。当前处于活动状态的数据集将成为备用数据集，如果数据集处于打开状态，那么将关闭该数据集。当前备用数据库将成为活动数据集，并在关闭时打开。
如果尝试更改不存在的数据集的打开状态，那么会发生 IOERR 异常情况。如果在只有一个转储数据集时指定 SWITCH ，或者在没有转储数据集时指定任何 OPENSTATUS 值，那么可能会发生此情况。

SWITCHSTATUS (cvda)

指定 CICS 是否在当前转储数据集下次填满时自动切换活动数据集。 SWITCHSTATUS 值记录在 CICS 全局目录中，因此会因热重新启动和紧急重新启动而被记住。 (最初由 DUMPSW 系统初始化参数设置。) CVDA 值如下：

无开关: 未切换数据集。
下一个开关: 当活动数据集填充时，将切换数据集，但仅切换一次。 (除非在活动数据集填满时有两个转储数据集，否则 SWITCHNEXT 不起作用。)
切换全部: 每次活动数据集填充时，都将切换这些数据集。 (除非在活动数据集填充时有两个转储数据集，否则 SWITCHALL 不起作用。)

条件

INVREQ

RESP2 值：

1: INITIALDDS 具有无效值。
2: SWITCHSTATUS 具有无效的 CVDA 值。
3: OPENSTATUS 具有无效的 CVDA 值。

IOERR

RESP2 值：

4: OPEN 或 SWITCH 导致打开数据集时发生错误。

NOTAUTH

RESP2 值：

100: 未授权与发出任务关联的用户使用此命令。

示例

EXEC CICS SET DUMPDS
              INITIALDDS('A')
              SWITCH
              NOSWITCH

此示例告诉 CICS A 转储数据集将首先在后续热重新启动和紧急重新启动时处于活动状态。 SWITCH 的 OPENSTATUS 设置使当前活动的转储数据集处于不活动状态，而当前不活动的转储数据集处于活动状态。 NOSWITCH 选项告知 CICS ，当 (新的) 活动转储数据集已满时，将不会自动切换到不活动转储数据集。