ATTRIBUTES 选项
通过 ATTRIBUTES 选项值(列示资源属性的字符串)来传送 CREATE 或 CSD 命令安装的资源定义的具体信息。
以文本格式指定属性和属性值,方式与在 CEDA DEFINE 屏幕上指定属性和属性值的方式相同。 此字符串在执行 CREATE 或 CSD 命令时进行分析,因此必须完全由单个字符串中的文本而不是变量名称组成。 该字符串中的语法是针对每个 CREATE 或 CSD 命令提供的,使用与命令语法相同的约定,但下面所说明的属性值除外。 但是,转换程序 不会 解析内容,这将仅检查主图中显示的命令语法。
属性值基本上与 CEDA DEFINE 屏幕上的属性值一样显示。 但是,由于 DEFINE 屏幕是预先格式化的,而 ATTRIBUTES 字符串不是,因此您需要了解以下规则:
- 属性可能以任何顺序出现 (您不必遵循语法图或 CEDA 命令中的顺序)。
- 属性的名称必须是语法图中显示的名称或相应 CEDA DEFINE 条目中允许的缩写 (请参阅 资源管理事务 CEDA 命令中的 DEFINE 讨论)。注: 缩写可以从发行版更改为发行版,因此完整拼写是最安全的。
- 与 CEDA 和 DFHCSDUP 实用程序的输入相反,属性字符串不会转换为大写。 无论您是使用大写,小写还是混合大小写,都将识别属性名称,如 CICS 指定的值名称 (语法图中以大写字母显示的值名称)。 但是,将按原样采用其他字符值 (例如,资源名称和消息文本) ,以便您需要在预期情况下提供这些值。
- 参数值 (如果有) 必须遵循 CEDA DEFINE 面板中相同属性的规则。 如果存在有限数量的可能值,那么将在属性图中以大写形式列出这些值。 否则,图仅指示值的格式,使用以下约定:
- charn
- 长度为 n 的字符串,或最大长度为 n的字符串 (其中自变量的长度可以是可变的)。
- 十六进制n
- 长度为 n 的十六进制字符的字符串,如果自变量的长度可以是可变的,那么最大长度为 n。
- n1-n2
- n1 到 n2范围内的数字。
注: 您可以省略字符自变量中的尾部空格,十六进制自变量中的尾部 X'00 '以及数字自变量中的前导零。 - 可以使用一个或多个空白来分隔属性以实现可读性,但仅在没有参数的属性与下一个属性之间需要空白。 不允许使用逗号和其他分隔符。 在属性名与包围其自变量的括号之间以及括号与自变量值之间也可能出现空格,但它们不是必需的。 因此这两种,以及类似的组合都是正确的:
ATTRIBUTES ( ‘UCTRAN (NO)RTIMEOUT (10 )’) ATTRIBUTES(‘ UCTRAN(NO) RTIMEOUT( 10) ’ ) - 属性字符串中不需要引号 (如果使用文字,那么需要在整个字符串周围使用引号,如以上示例中所示)。 如果要在文本中使用引号 (例如,在 DESCRIPTION 属性中) ,请对要在文本中显示的每个字符使用两个引号字符,就像在包含引号的文字常量中一样。
- 只有很少的属性需要规范,而省略一个属性相当于不在 CEDA 屏幕上为其键入值。 如果缺省值始终相同,那么它将以与语法图相同的方式显示在图中。 但是,某些缺省值取决于其他属性的值,并且不会显示这些值。 (不能为 CREATE 命令定义自己的缺省值,因为它们不使用 CSD 文件。)
- 对于某些资源类型,可以对所有属性使用缺省值。 如果要执行此操作,请在 ATTRLEN 选项中将字符串的长度设置为零。 在这种情况下,您仍必须指定 ATTRIBUTES 选项,即使未检查您提供的数据值也是如此。
- 当 ATTRLEN 选项不为零时,如果它是 ATTRIBUTES 中指定的变量的长度,并且您未在 C/370中编码,如 参数长度中所述,那么可以省略 ATTRLEN 选项。
如果在 ATTRIBUTES 字符串中发生错误,那么 CICS 会使用相应的 RESP2 值来引发 INVREQ 条件。 CREATE 和 CSD 命令的RESP2 值 列出了适用的 RESP2 值。