ISSUE ADD
向数据集添加记录。
描述
ISSUE ADD 将记录添加到外部控制器中的顺序或键控直接数据集。 FROM 选项用于指定要写入的数据, LENGTH 选项用于指定其长度。
仅当此命令应用于 DPCX/DXAM 数据集时,才需要 RIDFLD 选项。 在这种情况下,它指定要添加的记录的相对记录号。 使用 RIDFLD 时, NUMREC 必须为 1 (缺省值)。
选项
- DEFRESP
- 指定作为 ISSUE ADD 命令的结果发出的所有终端控制命令都将请求来自外部批处理程序的明确响应,而不考虑 (由系统程序员) 指定 CICS® 任务的消息完整性。
- DESTID (data-value)
- 指定外部目标中数据集的名称 (1-8 个字符)。
- DESTIDLENG (data-value)
- 指定 DESTID 选项中指定的名称的长度 (半字二进制值)。
- FROM (数据区)
- 指定要写入数据集的数据。
- LENGTH (data-value)
- 指定要写入的数据的长度 (半字二进制值)。 有关安全上限的描述,请参阅 CICS 命令中的 LENGTH 选项。
- 无等待
- 指定 CICS 任务继续处理而不等待 ISSUE ADD 命令完成。 如果未指定此选项,那么将暂挂任务活动,直到命令完成为止。
- NUMREC (data-value)
- 对于相对记录数据集,将要添加的逻辑记录数指定为半字二进制值。 从 RIDFLD 选项标识的记录开始按顺序替换记录。
对于已建立索引的数据集,无法指定 NUMREC ,因为只能添加一条记录。
- RIDFLD (数据区)
- 对于相对记录数据集,指定 4 字符字段作为记录的相对记录号 (从零开始)。 还需要 RRN 选项。
对于键控直接数据集, RIDFLD 应指定键。
- RRN
- 指定在 RIDFLD 选项中指定的记录标识字段包含相对记录号。 对于相对记录数据集,此选项是必需的。
- VOLUME (data-value)
- 指定包含 DESTID 选项中指定的数据集的外部目标中软盘的名称 (1-6 个字符)。
- VOLUMELENG (data-value)
- 指定 VOLUME 选项中指定的名称的长度 (半字二进制值)。
条件
- 48 FUNCERR
- 如果在执行命令期间发生错误,那么将发生此错误。 目标选择不受影响,针对同一目标的其他命令可能成功。
缺省操作: 异常终止任务。
- 16 INVREQ
- RESP2 值:
- 200
- 分布式程序链接服务器应用程序在 CONVID 选项上指定了函数输送会话 (其主体设施)。
- 47 个 SELNERR
- 如果在目标选择期间发生错误,那么将发生此错误。 未选择目标,针对同一目标的其他命令不太可能成功。
缺省操作: 异常终止任务。
- 49 UNEXPIN
- 当从舷外控制器接收到一些意外或无法识别的信息时发生。
缺省操作: 异常终止任务。
