CONVERSE (缺省值)

描述

此形式的 CONVERSE 命令由其他 CONVERSE 描述不适用的所有 CICS支持的 z/OS® Communications Server 终端使用。

选项

FROM (数据区)

此选项指定要写入终端或逻辑单元或发送至伙伴事务的数据。 如果指定了 ATTACHID ，那么可以在相关时省略此选项。

FROMFLENGTH (数据值)

此选项是 FROMLENGTH 的全字替代项。

FROMLENGTH (data-value)

此选项指定数据的长度 (作为半字二进制值)。 有关安全上限的说明，请参阅 翻译注意事项：EXEC CICS 命令中的 LENGTH 选项。

INTO (data-area)

此选项指定从终端或逻辑单元读取的数据的接收字段，或要从连接到当前对话的另一端的应用程序接收数据的应用程序目标数据区。

MAXFLENGTH (data-value)

此选项是 MAXLENGTH 的全字替代项。

MAXLENGTH (data-value)

此选项指定 CICS 为了响应 CONVERSE (缺省) 命令而要恢复的最大数据量 (半字二进制值)。 如果指定了 INTO ，那么 MAXLENGTH 将覆盖使用 TOLLENGTH 作为 CICS的输入。 如果指定了 SET ，那么 MAXLENGTH 为程序提供了一种方法来限制它一次接收的数据量。

如果指定的值小于零，那么假定为零。

如果数据长度超过指定的值，并且 NOTRUNCATE 选项不存在，那么数据将截断为该值，并且会出现 LENGERR 条件。 TOLLENGTH 选项中指定的数据区设置为数据的原始长度。

如果数据长度超过指定的值，并且存在 NOTRUNCATE 选项，那么 CICS 将保留其余数据并使用它来满足后续 RECEIVE 命令。 TOLLENGTH 选项中指定的数据区设置为返回的数据长度。

如果没有为 MAXLENGTH 编码任何参数，那么 $TAG1 CICS $TAG2 将缺省为 TOLLENGTH。

NOTRUNCATE

此选项指定当可用数据超过所请求的长度时，将不废弃其余数据，而是保留这些数据以供后续 RECEIVE 命令检索。

SET (ptr-ref)

此选项指定要设置为从终端读取的数据的地址的指针引用。 除非被其他命令或语句更改，否则指针引用在下一个 CONVERSE (缺省) 命令或任务结束之前有效。

如果 DATALOCATION (ANY) 与应用程序相关联，那么数据的地址可以高于或低于 16 MB 界线。

如果 DATALOCATION (BELOW) 与应用程序相关联，并且数据位于 16 MB 线以上，那么数据将复制到 16 MB 线以下，并返回此副本的地址。

如果为正在运行的任务指定了 TASKDATAKEY (USER) ，并且存储器保护处于活动状态，那么返回的数据在用户密钥中。 如果指定了 TASKDATAKEY (CICS) 并且存储器保护处于活动状态，那么返回的数据位于 CICS键中。

TOFLENGTH (数据区)

此选项是TOL思的全字替代项。

TOL思 (数据区)

此选项指定要接收的数据的长度 (半字二进制值)。 如果指定 INTO ，但省略 MAXLENGTH ，那么 "data area" 指定程序接受的最大长度。 如果该值小于零，那么假定为零。

如果数据的长度超过指定的值，但省略了 NOTRUNCATE ，那么会将数据截断为该值，并出现 LENGERR 条件。 当接收到数据时，数据区被设置为数据的长度。

有关安全上限的说明，请参阅 翻译注意事项：EXEC CICS 命令中的 LENGTH 选项。

条件

22 LENGERR

在下列任何情况下，都会发生此情况:

• CICS 将废弃接收的数据，因为其长度超过程序接受的最大长度 (请参阅 TOLLENGTH 和 MAXLENGTH 选项) ，并且未指定 NOTRUNCATE 选项。
• 在下列其中一个选项中提供了超出范围的值: FROMLENGTH ， FROMFLENGTH ， MAXLENGTH ， MAXFLENGTH ， TOLTOFLENGTH 或 TOFLENGTH。

缺省操作: 异常终止任务。