TSMODEL 资源定义

语法

属性

DESCRIPTION(文本)

您可以提供在此字段中定义的资源的描述。 描述文本的长度最多可以为 58 个字符。 您可以使用的字符没有任何限制。 但是，如果使用括号，请确保对于每个左括号都有一个匹配的右括号。 如果使用 CREATE 命令，那么对于文本中的每个单撇号，将编码两个撇号。

EXPIRYINTMIN（ { 0 | 数字 } ）

指定与此模型匹配的临时存储器队列的到期时间间隔 (以分钟计)。 CICS 使用向上舍入到最接近的 10 分钟倍数的值。 时间间隔计数在每次使用临时存储器队列之后开始。 如果在到达到期时间间隔之前未再次使用该队列，那么该队列将适合 CICS 自动将其删除。

0

没有到期时间间隔适用于与此模型匹配的临时存储器队列，并且这些队列永远不适合自动删除。 这是缺省设置。

号

到期时间间隔，以分钟为单位，范围在 10 - 900000 之间。 在此到期时间间隔之后，如果未再次使用与此模型匹配的临时存储器队列，那么该队列将符合自动删除的条件。

到期时间间隔适用于以下位置中的临时存储器队列:

• 本地 CICS 区域中的主临时存储器。
• 与本地 CICS 区域关联的不可恢复辅助临时存储器 (DFHTEMP 数据集)。
• 共享临时存储池中的临时存储队列 ( CICS TS 5.3 及更高版本)。

到期时间间隔不适用于以下类型的临时存储器队列，因此 CICS 从不自动删除这些队列:

• 辅助临时存储器中定义为可恢复的队列。
• 远程 CICS 区域中的队列。 要使 CICS 删除远程临时存储器队列，请在拥有这些队列的区域中的适当 TSMODEL 资源定义中指定到期时间间隔。
• CICS 为自己使用而创建的队列。

如果在 TSMODEL 资源定义中更改到期时间间隔，那么与模型匹配的现有临时存储器队列不受影响。 这些队列继续使用创建它们时应用的到期时间间隔。 如果从 CICS 区域中删除所有具有非零到期时间间隔的 TSMODEL 资源定义，那么 CICS 将停止扫描已到期的临时存储器队列。

GROUP（ 组名 ）

每个资源定义都必须具有 GROUP 名称。 资源定义成为组的成员，并在安装组时安装在 CICS 系统中。

可接受的字符：

A-Z 0-9 $ @ #

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

输入的任何小写字符都将转换为大写。

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

LOCATION({辅|MAIN})

指定队列是保留在辅助存储器还是主存储器中:

辅助

与此模型匹配的队列将保留在辅助临时存储器中。 这会忽略在 API 请求中指定的任何内容。

MAIN

与此模型匹配的队列将保存在主临时存储器中。 这会忽略在 API 请求中指定的任何内容。

对于与远程队列和共享临时存储池中的队列相关的临时存储器模型，将忽略 LOCATION。 在远程队列的 TSMODEL 资源定义中使用 LOCATION 允许在本地和远程区域中安装相同的定义。 请参阅 用于相互通信的共享资源。

POOLNAME(池)

指定要与此 TSMODEL 资源定义配合使用的共享 TS 池定义的名称。 该名称的最大长度为 8 个字符。

可接受的字符：

A-Z 0-9 $@ # _

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

输入的任何小写字符都将转换为大写。

嵌入的空白是不可接受的，将完全由空白组成的名称视为未提供任何池名称。

如果同时指定了 REMOTESYSTEM ，那么不能指定 POOLNAME。

如果应用程序在 EXEC CICS 临时存储器命令上指定了 SYSID ，或者如果由 XTSEREQ 全局用户出口程序添加了 SYSID ，那么 CICS 不会搜索匹配的 TSMODEL 资源定义。 要使 CICS 能够在应用程序显式指定 SYSID 时查找临时存储器数据共享池的名称，必须使用具有适当 TYPE=SHARED 条目的临时存储器表 (TST)。

PREFIX(前缀)

指定 CICS 用于标识匹配临时存储器队列的字符串。 前缀的长度最多可以为 16 个字符。

可接受的字符：

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

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

在最简单的情况下，前缀与以前缀开头的 TS 队列名称相匹配。 例如，前缀 ABCD 与队列名称 ABCD， ABCDE和 ABCD99相匹配。

可以在前缀中使用通用字符 (+) 一次或多次，以匹配 TS 队列名称中的任何字符。 例如，前缀 A++D 与队列名称 ABCD， A99D和 ABCD99匹配。 它与 ABD不匹配。 您不需要在前缀末尾指定 + 个字符; 您可以将前缀视为在右侧填充 + 个字符，最多为 TS 队列名称的最大长度 (16 个字符)。 例如，前缀 ABC 与前缀 ABC+ 或 ABC+++++完全等效。

在前缀中使用 + 字符时，可能会发现 (单独考虑) 有多个前缀与 TS 队列名称匹配。 在此情况下， CICS 使用以下规则来选择匹配的 TS 模型:

• 在前缀中精确指定的字符比 + 字符更匹配。
• 字符一次比较，从左到右，匹配的字符是越往左越强的匹配。

例如：

• 队列名称 ABCD99 与前缀 ABCD 而非 AB+D匹配: 在第一个前缀中，精确指定四个匹配字符; 在第二个前缀中，仅精确指定三个字符。
• 队列名称 ABCD99 与前缀 ABC+ 而非 AB+D匹配: 在两个前缀中，精确指定了相同数目的匹配字符。 但是，与之完全匹配的第三个字符在第一个前缀中更靠左。

使用空白前缀创建 TSMODEL 定义可能会产生意外结果。 带有空白前缀的 TSMODEL 定义与任何未与任何其他 TSMODEL 定义匹配的队列名称匹配，因此其作用域可能很广泛。 例如，它肯定会影响 API 创建的其他队列; 某些队列可能匹配，因此可能在不应该时到期 (并被删除)。

要使 CICS 能够在应用程序显式指定 SYSID 时查找临时存储器数据共享池的名称，必须使用具有适当 TYPE=SHARED 条目的临时存储器表 (TST)。

RECOVERY（ { 否 | 是 } ）

指定是否可恢复与此模型匹配的队列。

否

与此模型匹配的队列不可恢复。

YES

与此模型匹配的队列可恢复。

位置 (MAIN) 不允许 RECOVERY (YES)。

REMOTEPREFIX(前缀)

指定 CICS 用于标识远程系统中匹配的临时存储器队列的字符串。 前缀的长度最多可以为 16 个字符。

可接受的字符：

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

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

除非同时指定了 REMOTESYSTEM ，否则不允许使用 REMOTEPREFIX。 REMOTEPREFIX 属性的长度必须与 PREFIX 属性相同。

REMOTEPREFIX 属性中字符匹配的规则与 PREFIX 属性相同。 如果使用 + 字符进行通用匹配，那么它们必须位于 PREFIX 和 REMOTEPREFIX 中的相同位置。 例如：

• 前缀: A++D
• REMOTEPREFIX： X++Y

REMOTESYSTEM(连接)

指定用于将本地系统链接到临时存储器队列所在的远程系统的连接的名称。

可接受的字符：

A-Z 0-9 $ @ #

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

除非使用 CREATE 命令，否则您输入的任何小写字符都将转换为大写。

嵌入空白是不可接受的，将完全由空白组成的名称视为未指定远程系统。

REMOTESYSTEM 和 POOLNAME 是互斥的。 如果指定了 REMOTESYSTEM，那么会忽略 POOLNAME。

SECURITY（ { 否 | 是 } ）

指定是否对与该模型匹配的队列执行安全性检查。

否

不针对与此模型匹配的队列执行安全性检查。

YES

将对此模型匹配的队列执行安全性检查。

有关更多信息，请参阅 临时存储器的安全性。

TSMODEL(名称)

指定此 TSMODEL 资源定义的名称。 该名称的最大长度为 8 个字符。

可接受的字符：

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

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

不接受嵌入空白。

此名称用于标识 CSD 文件上的 TSMODEL 资源定义。 它不会在活动的 CICS 系统中使用。

XPREFIX( xprefix )

可用作 PREFIX 的替代项。 输入要用作此模型的前缀的十六进制字符串，长度最多为 32 个字符。 由于 XPREFIX 指定为十六进制格式，因此所使用的名称中可以包含无法在 PREFIX 属性中输入的字符。

要在 XPREFIX 属性中指定通用字符，请使用代码 X'4E'。

用于将 XPREFIX 与 TS 队列名称匹配的规则与用于 PREFIX 属性的规则相同。

XREMOTEPFX( xprefix )

可用作 REMOTEPREFIX 的替代项。 输入要用作远程系统上的前缀的十六进制字符串，长度最多为 32 个字符。 因为 XREMOTEPFX 以十六进制格式指定，所以您可以使用包含无法在 REMOTEPREFIX 属性中输入的字符的名称。

要在 XPREFIX 属性中指定通用字符，请使用代码 X'4E'。

用于将 XREMOTEPFX 与 TS 队列名称匹配的规则与用于 REMOTEPREFIX 属性的规则相同。