ENQMODEL 资源定义
ENQMODEL 定义了一个命名资源,EXEC CICS ENQ 和 EXEC CICS DEQ 命令的作用域是整个系统。
CICS® 使用 ENQMODEL 资源和 z/OS® 全局资源序列化,为多个应用程序使用的资源提供全系统范围的保护。 单个 CICS 区域内的本地队列在 CICS 地址空间中管理。 影响一个以上 CICS 区域的全系统队列由 z/OS 全局资源序列化管理。 有关全局资源序列化的更多信息,请参阅 z/OS MVS 规划:全局资源序列化。
为资源发出 EXEC CICS ENQ 和 EXEC 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:提高性能。
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。
语法
属性
- 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 请求。
