The tables define the properties that you can set for a Custom Wire Format message set.
Some of the message set properties (marked with an asterisk (*)) are relevant only if the message being processed is not using WebSphere® MQ as the transport protocol.
If the transport protocol is WebSphere MQ, values are derived from the message headers (for example, MQMD), and the message set properties, if set, are ignored.
Property | Type | Meaning |
---|---|---|
Boolean True Value | String | Enter up to eight hexadecimal digits. Do not include the hexadecimal indicator (0x) preceding this number. Each digit is a half byte. The maximum length is 4 bytes. You must enter an even number of digits (a whole number of bytes). This value must be different from, but the same length as, the Boolean False Value. The default value is 00000001. |
Boolean False Value | String | Enter up to eight hexadecimal digits. Do not include the hexadecimal indicator (0x) preceding this number. Each digit is a half byte. The maximum length is 4 bytes. You must enter an even number of digits (a whole number of bytes). This value must be different from, but the same length as, the Boolean True Value. The default value is 00000000. |
Boolean Null Value | String | Enter up to eight hexadecimal digits. Do not include the hexadecimal indicator (0x) preceding this number. Each digit is a half byte. The maximum length is 4 bytes. You must enter an even number of digits (a whole number of bytes). This value can be the same as either Boolean True Value or Boolean False Value, or different. The default value is 00000000. |
Use these settings when messages are being output.
Property | Type | Meaning |
---|---|---|
Byte Alignment Pad | String | If the xsd:element Custom Wire Format properties Byte Alignment, Leading Skip Count, and Trailing Skip Count cause bytes to be skipped in the bit stream when the message is serialized, this property supplies the character to be used in the skipped positions. Set this character in one of the following ways:
|
Policy for Missing Elements | Enumerated | This property determines the action that is taken by the broker when fields are missing from the message tree when the message is serialized (for output):
|
Property | Type | Meaning |
---|---|---|
Packed Decimal Positive Code | Enumerated | Select, from the list, the positive sign that is used for packed decimal numbers. The default value is C, which indicates that 0x0C is used as the positive sign; this value is used in most systems. You can also select F, which indicates that 0x0F is used as the positive sign; this value is used in some systems. |
Property | Type | Meaning |
---|---|---|
Derive default dateTime format from logical type | Button | Select this option if you want the default dateTime
format to be determined by the logical type of the element or attribute. You can override this property for an element or attribute within a complex type. |
Use default dateTime format | Button and String | Select this option if you want to specify a default
dateTime format that is fixed for all elements or attributes of logical type
dateTime, date, time, gYear, gYearMonth, gMonth, gMonthDay, and gDay. You can override this property for an element or attribute within a complex type. For more information, see DateTime formats. |
Start of century for 2 digit years | Integer | This property determines how two-digit years are interpreted. Specify the two digits that start a 100-year window that contains the current year. For example, if you specify 89, and the current year is 2002, all two-digit dates are interpreted as being in the range 1989 to 2088. |
Days in First Week of Year | Enumerated | Specify the number of days of the new year that must
fall within the first week. The start of a year typically falls in the middle of a week. If the number of days in that week is less than the value specified here, the week is considered to be the last week of the previous year; therefore, week 1 starts some days into the new year. Otherwise, it is considered to be the first week of the new year; in this case, week 1 starts some days before the new year. Select Use Broker Locale, which causes the broker to get the information from the underlying platform, or select a number from the list that is displayed. |
First Day Of Week | Enumerated | Specify the day on which each new week starts. Select Use Broker Locale, which causes the broker to get the information from the underlying platform, or select a value from the list that is displayed. |
Strict DateTime Checking | Check box | Select this option if you want to restrict dateTimes
to a valid dateTime format. If Strict DateTime
Checking is selected, receiving an incorrect dateTime causes an error.
|
Time Zone | Enumerated | The value that you set for this property is used if
the value that you specified for the Default
DateTime Format property does not include Time Zone information. The initial value is Use Broker Locale, which causes the broker to get the information from the underlying platform. You can change this property by selecting from the list of values. |
Daylight Savings Time | Check box | Select this option if the area in the Time
Zone property observes Daylight Saving Time. If it does not observe
Daylight Saving Time, do not select this option. For example, if an area is selected in Time Zone and this option is not selected, the value passed represents the time zone without the Daylight Saving Time. |
Use input UTC format on output | Check box | This property applies to elements and attributes of
logical type xsd:dateTime or xsd:time that contain a dateTime as a string
and that have a dateTime format of I, IU, T, or TU, or that include ZZZ or
ZZZU. Such elements and attributes can specify Coordinated Universal Time (UTC) by using either the Z character or timezone +00:00 in the value. On input, the MRM parser remembers the way that UTC was specified. If this property is selected, and the element or attribute is copied to an output message, the UTC format is preserved into the output message and overrides the format that is implied by the dateTime format property. If this property is cleared, or if the element or attribute was not copied from an input message, the UTC format in the output message is controlled solely by the dateTime format property. |
Use these settings only for messages with no MQMD.
Property | Type | Meaning |
---|---|---|
Default CCSID* | Integer | Enter a numeric value for the default Coded Character Set Identifier. The default is 500. If the input message is a WebSphere MQ message, the equivalent attribute that is set for the queue manager is used, and this property is ignored. |
Default Byte Order* | Enumerated | Select either Big Endian (the default) or Little Endian from the list to specify the byte order of numbers that are represented as binary integers. In C, this is equivalent to data type short or long. In COBOL, this is equivalent to a PIC 9, COMP, COMP-4, COMP-5, or BINARY data type. Your choice must match the encoding with which messages are created. Typically, Big Endian is the correct option for messages that are created on UNIX® or z/OS®; Little Endian is the correct option for messages that are created on Windows®. Do not use this property if the message is received across the WebSphere MQ transport protocol; in this case, the property is deduced from the MQMD of the message, or from the encoding of the broker queue manager. |
Default Packed Decimal Byte Order* | Enumerated | Select Big Endian (the default) or Little Endian from the displayed list to specify the byte order of numbers that are represented as packed decimal. In COBOL, this is equivalent to PIC 9 COMP-3 data type. There is no equivalent data type in C. Your choice must match the encoding with which messages are created. Typically, Big Endian is the correct option for messages that are created on UNIX or z/OS; Little Endian is the correct option for messages that are created on Windows. |
Default Float Format* | Enumerated | Select one of S390 (the default), IEEE, or Reverse IEEE from the displayed list to specify the byte order of numbers in the message that are represented as floating point. |