元素引用以及局部元素字符串型的 CWF 属性

此处描述的定制有线格式属性适用于:

物理表示

属性 类型 含义
物理类型 枚举类型 从下拉列表中选择以下某项:
  • 固定长度字符串。元素的长度由下面的其他长度属性确定。
  • 长度编码字符串 1。元素的第一个字节包含长度字节以后、以长度单位计的字符串长度。长度编码字符串 1 元素的最大长度为 255 长度单位。
  • 长度编码字符串 2。元素的头两个字节包含两个长度字节以后、以长度单位计的字符串长度。长度编码字符串 2 元素的最大长度为 65535 长度单位。两个长度字节的格式为 WebSphere MQ 队列管理器编码。
  • 以空值终止。以十六进制空字符 X'00' 结尾的字符串。

缺省值是固定长度字符串

长度计数 Button 和 Integer 如果您选择了物理类型固定长度字符串二进制 ,并且将长度类型设置为计数,则请输入元素的长度单位数。

您可指定的最小值是 0(零),可指定的最大值是 2147483647

缺省值为 0(零)。

长度引用 按钮和枚举类型 如果您选择长度由长度引用定义,请选择指定此对象的长度的整数对象的名称。从整数对象的下拉列表选择(这些整数对象定义为当前对象的兄弟,且在消息结构中先于当前对象出现)。

如需了解有关对元素重排序的信息,请参阅记录对象

长度单位 枚举类型 根据已经设置的物理类型,从下拉列表中选择下列项之一 :
  • 字节。它指定处理 X 字节,其中 X 是长度计数的值,或长度引用中指定的 INTEGER 的值。
  • 字符。此选项的含义取决于您在消息的 CCSID 中设置的值或您为消息集属性缺省 CCSID 设置的值。
    • 如果您指定了 SBCS CCSID,则处理 X 字节,其中 X 是长度计数的值,或长度引用中指定的 INTEGER 的值。
    • 如果您指定了 DBCS CCSID,则处理 Y 字节,其中 Y 是长度计数的值,或长度引用中指定的 INTEGER 的值。
    • 如果您指定了 MBCS CCSID,则解析器一次读 1 个字符,并确定该字符是否包括 1 个或更多字节。解析器执行 Z 次读取,其中 Z 是长度计数的值,或长度引用中指定的 INTEGER 的值。
  • 字符单位。这指定字符单位的大小由您在消息的 CCSID 字段中设置的值或您为消息集属性缺省 CCSID 设置的值确定。处理的字节数是字符单位的大小乘以 长度计数的值,或长度引用中指定的 INTEGER 的值。
  • 位流的结尾。处理到位流结束为止的所有数据。 此选项仅当该元素是消息中最后一个元素时才有效。如果您选择此值,则不需要在长度计数长度引用中输入值。

缺省值是字节

字符串对齐 枚举类型 如果已将物理类型属性设置为固定长度字符串,请选择 左对齐 (缺省值)或者右对齐 从下拉列表中。如果您为物理类型选择了另一个值,则此属性不活动。
填充字符 String

如果您将物理类型属性设置为固定长度字符串,并且 字符串对齐属性设置为左对齐右对齐,则可以应用此属性。

当字符串长度小于长度计数长度引用属性指定的字符串大小时,使用填充字符在写输出消息时填充剩余字符位置。无论字符串是从左或右开始填充,都受字符串对齐属性的控制。

当解析输入消息时填充字符,填充字符从字符串的末端调整对齐。无论字符串是从左或右开始调整对齐,都受 字符串对齐属性的控制。

以下列方法之一指定该字符:

  • 从下拉列表中选择 NUL'0'SPACE
  • 输入一个用引号括起来的字符;例如 "c" 'c',其中 c 是任意字母数字字符。
  • 以格式 U+xxxx 输入 Unicode 值,其中 xxxx 是以十六进制格式指定的 Unicode 值。可输入字符串的最大长度是 10。
  • 输入格式为 0xYY 的十六进制字符,其中 YY 是十六进制值。
  • 输入一个十进制字节值(从 0 至 255)。

如何选择用于 MRM 元素的这些填充字符格式,取决于所需的填充字符,以及是否该填充字符必须进行数据转换。多数情况下,加引号的填充字符的规范是足够的,并且当使用该填充字符时,它会转换为正在生成的输出 MRM 消息的目标代码页。例如,当从 ASCII 转换到代码页 500 时,如果已指定 U+0008 作为填充字符,则它会从 0x08 转换至 0x15(“背面间隔”的 ASCII 和 EBCDIC 表示)。

如果需要填充字符,而此填充字符在填充字符字段中不易输入,则可以使用 Unicode 助记符格式来指定所需的字符。使用时,该 Unicode 值也会转换为正在生成的 MRM 消息的目标代码页。

如果要从一个代码页将转换至另一个代码页,应确保针对该代码页的填充字符的转换值有效。 如果该填充字符无法在目标代码页上显示,则采用替换字符进行替换。替换字符是固定的,且其值取决于指定的目标代码页。

如果所需的填充字符不必进行数据转换,则可以使用十六进制或十进制格式。这使您可以选择将一个绝对值指定为直接插入输出消息的填充字符。 如果使用该格式,仍应确保针对使用这些 MRM 定义创建的任何输出消息的代码页,该值都是有效的。

空值表示

属性 类型 含义
编码空 枚举类型 从下拉列表中选择以下某个选项:
  • NULLPadFill。 仅当物理类型固定长度字符串时才有效。以填充字符指定的值填充字段。编码空值必须设置为空字符串。
  • NULLLogicalValue编码空值经过转换以匹配字段的必需格式。这是缺省值。
  • NULLLiteralValue。直接替换编码空值,好像它是字符串一样。
  • NULLLiteralFill。该字段使用编码空值指定的值进行填充。编码空值必须解析为单个字符。
编码空值 STRING 此属性的使用取决于上面描述的编码空属性。如果指定了,它的长度必须等于字符串元素NULLLiteralFill 例外。

缺省值为空的(未设置)。

如果将编码空属性设置为 NULLLiteralFill,则该值必须解析为单个字符。使用以下某个方法设置该字符:
  • 从下拉列表中选择 SPACE、NUL、0x000xFF
  • 输入一个用引号括起来的字符,例如 'c'"c",其中 c 是任意字母数字字符。
  • 输入格式为 0xYY 的十六进制字符,其中 YY 是十六进制值。
  • 输入格式为 YY 的十进制字符代码,其中 YY 是十进制值。
  • 输入格式为 U+xxxx 的 Unicode 值,其中 xxxx 是以十六进制格式指定的 Unicode 值。

字节对齐

属性 类型 含义
字节对齐 枚举类型 指定对象如何从消息开始处对齐。选择一个:
  • 1 字节。这是缺省值。
  • 2 字节
  • 4 字节
  • 8 字节
  • 16 字节
前导跳过计数 整数 指定在读或写此对象前要跳过的字节数。缺省值为 0,最小值为 0,最大值为 999999。您可以使用该值来忽略结构 中不需要的字段,或建模需要在 2、4、8 或 16 字节边界上对齐的 C 或 COBOL 数据定义的字段。指定在读或写此对象前要跳过的字节数。当编写输出消息时,跳过计数字节被指定为消息集“字节对齐填充”属性的值。

对于重复对象,此属性仅应用于第一个实例。

尾随跳过计数 整数 指定在读或写此对象后要跳过的字节数。缺省值为 0,最小值为 0,最大值为 999999。您可以使用该值来忽略结构 中不需要的字段,或建模包含需要在 2、4、8 或 16 字节边界上对齐的字段的重复结构。当编写输出消息时,跳过计数字节被指定为消息集“字节对齐填充”属性的值。

对于重复对象,此属性仅应用于所有实例。

重复

属性 类型 含义
重复引用 枚举类型 如果对象多次出现,则使用该属性,并且在消息中出现的次数由较先的字段动态给定。

从整数对象的下拉列表选择一个整数对象,其在消息结构中 先于该对象出现。选择的整数指定该对象的出现次数。如果未列出任何对象,则在消息结构中该对象前没有整数对象。

如果指定了重复引用,在解析和写消息时它将覆盖最大发生逻辑属性的任何设置,但 不覆盖消息的验证设置。

相关概念
消息建模
消息模型
定制有线格式:与逻辑模型的关系
相关任务
开发消息模型
使用消息模型对象
相关参考
消息模型引用信息
消息模型对象属性
消息模型对象的逻辑属性
消息模型对象的定制有线格式物理属性
消息模型对象的 XML 有线格式物理属性
消息模型对象的 TDS 格式物理属性
所有消息集对象的文档属性
根据对象的模型对象属性
附加的 MRM 域信息
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ad15410_