CREATE LSRPOOL
在本地 CICS® 区域中定义 LSR 池。
语法
警告系统命令功能强大，可提供有关系统状态的信息，并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
条件: ILLOGIC ， INVREQ ， ENGERR 和 NOTAUTH
NOHANDLE、RESP 和 RESP2是常用选项，可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项.
COBOL 程序员注意: 在上述语法中，必须使用 ATTRIBUTES(data-area) 而不是 ATTRIBUTES(data-value)。
描述
CREATE LSRPOOL 命令使用在命令上指定的属性来安装 LSRPOOL 定义，并且不使用存储在 CSD 中的资源定义。 LSR 池必须在 CICS 区域中具有唯一的 LSRPOOLNUM 值。 如果本地区域已包含具有相同 LSRPOOLNUM 值的定义，那么新定义将替换旧定义; 否则，将添加新定义。 与大多数资源定义不同，您在 LSRPOOL 选项中指定的名称不会确定替换; 而是由 LSRPOOLNUM 中的值控制所执行的操作。
注: 当您替换当前打开的池的定义时，新定义直到下次构建池时才会生效。 直到关闭所有正在使用该池的文件并随后重新打开一个文件之后，才会重建该池。
同步点在 CREATE LSRPOOL 处理中是隐式的，但在处理命令的早期检测到异常情况时除外。 如果 CREATE 成功执行，那么将落实对该任务中的可恢复资源所作的未落实的更改，如果未成功执行，那么将回滚。 请参阅 使用 EXEC CICS CREATE 命令来定义资源 ，以了解管理 CREATE 命令的其他一般规则。
未审计 CREATE 命令，因为其他消息会记录这些命令的操作。
选项
- ATTRIBUTES (data-value)
- 指定要添加的 LSRPOOL 的属性。 必须使用 LSRPOOL attributes中显示的语法将属性列表编码为单个字符串。 请参阅 ATTRIBUTES 选项 以获取有关指定属性的一般规则，并参阅 LSRPOOL 资源 以获取有关特定属性的详细信息。注: 您可以通过指定 ATTRLEN 值 0 ，为 LSRPOOL 定义的所有属性指定缺省值。 但是，您仍需要指定 ATTRIBUTES 选项，即使未使用其值也是如此。
- ATTRLEN (data-value)
- 以半字二进制值的形式指定 ATTRIBUTES 选项中提供的字符串的长度 (以字节为单位)。 长度可以从 0 到 32767。
- LOGMESSAGE( cvda )
- 指定 CICS 是否记录用于所创建资源的属性。 CVDA 值如下：
- 日志
- 资源属性将记录到 CSDL 瞬时数据队列中。
- NOLOG
- 未记录资源属性。
- LSRPOOL (data-value)
- 指定要添加到 CICS 区域的 LSRPOOL 定义的 8 字符名称。
条件
- ILLOGIC
- RESP2 值：
- 2
- 无法执行该命令，因为尚未完成先前的 CONNECTION 或 TERMINAL 池定义。
- INVREQ
- RESP2 值：
- n
- ATTRIBUTES 字符串中存在语法错误，或者在处理的废弃或资源定义阶段发生错误。 有关 RESP2 值的信息，请参阅 CREATE 和 CSD 命令的 RESP2 值 。
- 7
- LOGMESSAGE cvda 值无效。
- 200
- 该命令是在使用 EXECUTIONSET 值 DPLSUBSET 定义的程序中执行的，或在没有 SYNCONRETURN 选项的分布式程序链接从远程系统调用的程序中执行的。
- LENGERR
- RESP2 值：
- 1
- 您在 ATTRLEN 中指定的长度为负数。
- NOTAUTH
- RESP2 值：
- 100
- 未授权与发出任务关联的用户使用此命令。