嵌入式简单类型日期时间型的 CWF 属性

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

物理表示

属性 类型 含义
物理类型 枚举类型 从下拉列表中选择以下某项:
  • 固定长度字符串。元素的长度由下面的其他长度属性确定。
  • 长度编码字符串 1。元素的第一个字节包含长度字节以后、以长度单位计的字符串长度。长度编码字符串 1 元素的最大长度为 255 长度单位。
  • 长度编码字符串 2。元素的头两个字节包含两个长度字节以后、以长度单位计的字符串长度。长度编码字符串 2 元素的最大长度为 65535 长度单位。两个长度字节的格式为 WebSphere MQ 队列管理器编码。
  • 以空值终止。以十六进制空字符 X'00' 结尾的字符串。
  • 压缩十进制。日期时间编码为压缩十进制数。仅当 DateTime 格式属性代表仅数值数据时,它才有效。
  • 二进制。日期时间编码为字节的二进制序列。如果您选择此选项,则可为格式字符串属性指定的符号范围小于选择字符串选项时可指定的符号范围(请参阅日期时间格式获取详 细信息)。
  • 时间秒。此值支持 C time_t 和 Java 日期和时间对象。仅当 DateTime 格式属性代表仅数值数据时,它才有效。
  • 时间毫秒。此值支持 C time_t 和 Java 日期和时间对象。仅当 DateTime 格式属性代表仅数值数据时,它才有效。

缺省值为固定长度字符串

日期时间格式 String 指定日期和时间的模板。

缺省 dateTime 格式取决于对象的逻辑类型。有关取决于逻辑类型的日期时间格式缺省值的信息,请参阅逻辑类型的 DateTime 缺省值

如果您将物理类型设置为 二进制,则模板仅限于作为字符串数据的 dateTime 中定义的那些组件。如果您将物理类型设置为压缩十进制时间秒时间毫秒,则模板仅限于那些代表数字的组件。在这些情况下,您必须更新此 日期时间格式属性。

请参阅日期时间格式以获取关于日期和时间格式的详细信息。

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

对所有三个物理类型您可指定的最小值为 1

您可指定的最大值对于固定长度字符串 256,对于压缩十进制10,对于二进制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。这指定编码空值包含直接替换的值,好象它是字符串一样。当为编码空值设置以指定空日期的值不是一个日期时间值,或不 符合标准日期时间格式 yyyy-MM-dd 'T'HH:mm:ss 时使用此选项。
  • NULLLiteralFill。该字段使用编码空值指定的值进行填充。编码空值必须解析为单个字符。
编码空值 String

如果您将编码空属性设置为 NULLPadFill,则禁用此属性(灰掉)。

如果将编 码空属性设置为 NULLLogicalValue,则必须将该属性设置为 ISO8601 日期时间格式。这些格式在 作为字符串数据的 dateTime中描述。例如,指定一个符合 yyyy-MM-dd'T'HH:mm:ss 格式的值(如 1970-12-01)。

如果将编码空属性设置为 NULLLiteralValue,可输入与字段长度相同的任何值。

如果将编码空属性设置为 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 字节边界上对齐的字段的重复结构。当编写输出消息时,跳过计数字节被指定为消息集“字节对齐填充”属性的值。

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

重复

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

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

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

相关概念
消息建模
消息模型
定制有线格式:与逻辑模型的关系
相关任务
开发消息模型
使用消息模型对象
相关参考
消息模型引用信息
消息模型对象属性
不推荐的消息模型对象属性
嵌入式简单类型属性
嵌入式简单类型 CWF 属性
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ad16050_