长度选项

许多 API 命令涉及应用程序与 CICSPlex ® SM之间的数据传输。

在 COBOL ， PL/I 和汇编语言中，转换程序可以缺省设置某些长度选项; 这意味着它们在指定数据区的程序中可能是可选的。 在 C 和 REXX 中，必须指定所有长度选项。

CICSPlex SM API 允许大多数 data-value 参数 (仅从程序传递到 CICSPlex SM) 为缺省值。 以下命令上的 LENGTH 选项例外:
  • 创建
  • 移除
  • UPDATE
另一方面，必须始终指定可以从程序传递到 CICSPlex SM 并再次返回的 data-ref 自变量。

当 API 命令提供了长度选项时，它始终表示为带符号的全字二进制值。 这使理论上的长度上限为 2 147 483 647 字节。 可实现的上限因命令和各种语言编译器而异，但 API 命令上所有输入数据区的最大限制通常为 16 124 字节。 超过此限制时， API 命令将失败，响应为 INVALIDCMD ，原因为 LENGTH。