ENQMODEL 资源定义

ENQMODEL 定义了一个命名资源,EXEC CICS ENQEXEC CICS DEQ 命令的作用域是整个系统。

CICS® 使用 ENQMODEL 资源和 z/OS® 全局资源序列化,为多个应用程序使用的资源提供全系统范围的保护。 单个 CICS 区域内的本地队列在 CICS 地址空间中管理。 影响一个以上 CICS 区域的全系统队列由 z/OS 全局资源序列化管理。 有关全局资源序列化的更多信息,请参阅 z/OS MVS 规划:全局资源序列化

为资源发出 EXEC CICS ENQEXEC CICS DEQ 命令时,CICS 会检查是否有匹配的已安装 ENQMODEL 定义。 ENQMODEL 资源的 ENQSCOPE 属性定义了共享同一排队范围的区域集。 如果 ENQSCOPE 属性保持为空(默认值),CICS 会将任何匹配的 enqueue 或 dequeue 请求视为发出 CICS 区域的本地请求。 如果 ENQSCOPE 不为空,CICS 会将 Enqueue 或 dequeue 视为整个系统,并将队列名称和资源名称传递给 z/OS 全局资源序列化,以管理 Enqueue。

z/OS 全局资源序列化可配置为环形配置或星形配置。 出于性能考虑,不建议在多系统环境中的生产区域使用环形配置。 您还可以使用 CICS 系统初始化参数 NQRNL 来指定 z/OS 全局资源序列化是否对 CICS 队列请求使用 RNL 处理,这会影响资源的范围。 有关为 z/OS 配置 CICS 全局资源序列化的详细信息,请参阅 Global CICS enqueue 和 dequeue:提高性能

例如,您可以使用 DISPLAY GRS 命令显示使用 z/OS 全局资源序列化设施的 sysplex 队列:
D  GRS,RES=(DFHEqname|*,[  rname|,*])
其中:
qname
指定由 ENQMODEL 资源定义的 4 个字符 ENQSCOPE。
rname
指定由 ENQMODEL 资源定义的 ENQNAME。

仅资源支持全系统范围的排队,地址上的排队则不支持。 它不是为锁定可回收资源而设计的。

有关使用 CEMT 和 CEDA 安装队列模型资源定义的信息,请参阅 安装队列模型资源定义。 有关使用 BAS 的信息,请参阅 使用 BAS 队列模型资源定义

获取 ENQMODEL 资源

需要使用全系统范围 enqueue 或 dequeue 功能的 CICS 区域都必须定义并安装所需的 ENQMODEL 资源。 确保这一点的推荐方法是让 CICS 区域共享一个 CSD,并让初始化组列表包含相同的 ENQMODEL 组。

如果定义了适当的 ENQMODEL 资源,应用程序就会使用 sysplex 队列;无需更改应用程序。 对于动态配置资源名称(事先不知道)的应用程序,可以使用 enqueue EXEC 接口程序退出 XNQEREQ 和 XNQEREQC 在资源名称开头提供与合适的 ENQMODEL 资源定义相匹配的字符。 有关这些用户退出的更多信息,请参阅 Enqueue EXEC 接口程序退出 XNQEREQ 和 XNQEREQC

语法

阅读语法图跳过可视语法图ENQMODEL( 名称)GROUP( groupName)DESCRIPTION( 文本)ENQNAME( 资源)ENQSCOPE( 作用域 (scope))STATUS(ENABLED)STATUS(DISABLED)

属性

DESCRIPTION( 文本 )
您可以在此字段中对要定义的资源进行描述。 描述文本长度最多为 58 个字符。 您可以使用的字符没有任何限制。 但是,如果使用括号,应确保每个左括号都有一个匹配的右括号。 如果使用 CREATE 命令,则要为文本中的每一个单撇号编码两个撇号。
ENQMODEL( 姓名 )
指定该 ENQMODEL 定义的名称。 该名称的最大长度为 8 个字符。
可接受的字符:

A-Z a-z 0-9 $ @ # ./ - _ % & ?!:| " = ¬ , ; < >

有效字符在代码页 IBM® -037 显示时列出。 如果使用不同的 EBCDIC 代码页,请注意 变体角色 中记录的变体字符。

该名称用于标识 CSD 文件中的 ENQMODEL 定义。 它不会在活动的 CICS 系统中使用。

ENQNAME(资源)
指定 1 至 255 个字符的资源名称。
可接受的字符:

A-Z a-z 0-9 $ @ # ./ - _ % & ?!:| " = ¬ , ; < > *

当代码页为 IBM-037 时,将列出有效字符。 如果使用不同的 EBCDIC 代码页,请注意 变体角色 中记录的变体字符。

您也可以使用 *(星号)作为最后一个字符,表示通用名称。 名称中其他地方的 *(星号)将被视为字面 * 字符。

ENQSCOPE(范围)
指定可选的 4 个字符的 enqueue 模型作用域名称。 如果省略或指定为空格,则匹配的 enqueue 模型具有本地作用域。
GROUP(组名)
每个资源定义都必须有一个 GROUP 名称。 安装组时,资源定义将成为组的成员并安装在 CICS 系统中。
可接受的字符:

A-Z 0-9 $ @ #

当代码页为 IBM-037 时,将列出有效字符。 如果使用不同的 EBCDIC 代码页,请注意 变体角色 中记录的变体字符。

输入的任何小写字母都会转换成大写字母。

GROUP 名称长度最多为 8 个字符。 小写字符被视为大写字符。

STATUS{ENABLED|DISABLED})
指定 Enqueue 模型是以 ENABLED 还是 DISABLED 状态安装。 默认为 ENABLED。
已启用
匹配的排队请求按正常方式处理。
DISABLED
匹配的 enqueue 请求会被拒绝,发出的任务也会中止。 处理匹配的 INSTALL CREATE 和 DISCARD 请求。