CREATE LIBRARY

描述

CREATE LIBRARY 命令安装具有命令上指定的属性的 LIBRARY 资源。 它不使用存储在 CSD 中的资源定义。

使用 CREATE LIBRARY 命令创建 LIBRARY 资源时， LIBRARY 名称不得与 CICS 区域中任何其他公共 LIBRARY 资源的名称相同。 如果本地区域已具有具有您指定的名称的公共 LIBRARY 资源，那么新定义将替换旧定义，前提是禁用旧 LIBRARY ，否则将拒绝该命令。 无法使用此命令替换在 CICS 束中定义和安装的 LIBRARY 资源。

在作为部署在平台上的应用程序的一部分打包和安装的 CICS 束中定义 LIBRARY 资源时， $TAG3 CICS $TAG4 将为应用程序创建专用 LIBRARY 资源，因此资源名称在 CICS 区域中不必唯一。 有关公共资源和专用资源的更多信息，请参阅 应用程序版本的专用资源。

选项

ATTRIBUTES (data-value)

指定要添加的 LIBRARY 资源的属性。 必须使用 LIBRARY 属性中显示的语法将属性列表编码为单个字符串。 请参阅 ATTRIBUTES 选项 以获取有关指定属性的常规规则，并参阅 LIBRARY 属性 以获取有关特定属性的详细信息。

ATTRLEN (data-value)

以半字二进制值的形式指定 ATTRIBUTES 选项中提供的字符串的长度 (以字节为单位)。 长度可以从 0 到 32767。

LIBRARY (data-value)

指定要添加到 CICS 区域的 LIBRARY 资源的 8 字符名称。

LOGMESSAGE(cvda)

指定 CICS 是否记录用于所创建资源的属性。 CVDA 值如下：

日志

资源属性将记录到 CSDL 瞬时数据队列中。

NOLOG

未记录资源属性。

条件

ILLOGIC

RESP2 值：

2

无法执行该命令，因为影响 LIBRARY 搜索顺序的先前更改尚未完成。

INVREQ

RESP2 值：

n

ATTRIBUTES 字符串中存在语法错误，或者在处理的废弃或资源定义阶段发生错误。 EXEC CICS CREATE 命令发出的大多数 RESP2 值都与写入瞬时数据队列 CSMT 的消息相关联。 RESP2 值和相应的消息号显示在 CICS 信息中心的 CREATE 和 CSD 命令的RESP2 值 主题的表中。

语法错误可能由以下原因导致:

• LIBRARY 名称无效。
• 排名值超出范围 1-99。
• 排名值是保留值 10。
• 未指定 DSNAMExx 属性 (必须至少提供 1 数据集名称)。
• 提供的 LIBRARY 名称是保留名称

废弃或资源定义阶段期间的错误可能由以下原因导致:

• 存储空间不足，无法为 LIBRARY 创建内部控制结构
• 数据集分配失败
• 数据集并置失败
• LIBRARY 未能打开
• 同名的现有 LIBRARY 已存在且未禁用
• 写入 CICS 目录失败

7

LOGMESSAGE CVDA 值无效。

200

该命令是在使用 EXECUTIONSET 值 DPLSUBSET 定义的程序中执行的，或者在没有 SYNCONRETURN 选项的情况下，通过分布式程序链接从远程系统调用了一个程序。

500

安装失败，因为存在同名的现有 LIBRARY ，并且无法将其替换，因为未将其禁用。

LENGERR

RESP2 值：

1

您在 ATTRLEN 中指定的长度为负数。

NOTAUTH

RESP2 值：

100

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

103

CICS 区域对组成 LIBRARY 并置的其中一个数据集没有读访问权。