WebSphere Message Brokers
File: ad30715_
Writer: Terry Cowling

Reference topic

This build: July 31, 2007 21:26:42

COBOL file: select the physical properties

The panel that is described below allows you to select the physical properties that you want.

COBOL file

When you choose to create a new message definition file from an existing COBOL file, you are presented with the following panels:

Panel properties

Compiler information

Source platform
This property sets the defaults for Codepage, Floating point format, and Byte order.
  • Win32 - the default
  • AIX®
  • z/OS®
Codepage
This property shows the default for what has been set using the Source platform property. Do not change this value.
  • ISO8859_1 - the default
Floating point format
This property shows the default for what has been set using the Source platform property. Do not change this value.
  • IEEE Non-Extended - the default
  • IBM® 390 Hexadecimal

Storage layout

Byte order
This property shows the default for what has been set using the Source platform property. Do not change this value.
  • Little endian - the default
  • Big endian
External decimal sign
Select the Sign EBCDIC Custom for elements that have Custom Wire Format (CWF) Physical Type set to External Decimal and with the Sign Orientation set to Leading or Trailing (an embedded sign representation). These settings correspond to a COBOL data item such as USAGE DISPLAY PIC S999 SIGN LEADING or USAGE DISPLAY PIC S999 SIGN TRAILING.
Select EBCDIC Custom if instance messages in an ASCII code page use EBCDIC-style embedded signs. Otherwise, ASCII or EBCDIC does not select Sign EBCDIC Custom for elements and, at run time, the type of embedded sign is determined from the code page of the instance message.
  • ASCII - the default
  • EBCDIC
  • EBCDIC Custom

Compile options

QUOTE
This option affects the character produced by the COBOL keywords QUOTE and QUOTES and is used for setting INITIAL VALUE of a data-item, imported as a default value.
  • DOUBLE - the default
  • SINGLE
TRUNC
This option implements the effects of the COBOL compiler option TRUNC(STD|OPT|BIN).

For STD or OPT, COBOL BINARY data-items (including USAGE COMP, COMP-4, or BINARY) have maxInclusive and minInclusive facets that are created to conform to their PICTURE clause (for example, PIC S999 = min -999, max 999).

For BIN, BINARY data-items behave as if created with USAGE COMP-5. No facets are created, the logical type of each element created (for example, xsd:short) gives the implicit maximum and minimum values that can be handled.
  • STD - the default
  • OPT
  • BIN
NSYMBOL
This option is the equivalent of the COBOL compiler option NSYMBOL(NATIONAL|DBCS), which determines whether PIC N data-items are national or dbcs items.
  • DBCS
  • NATIONAL - the default
Create default values from initial values
If you want to create default values from the initial values, select Create default values from INITIAL VALUEs.
Create facets from level 88 VALUE clauses where possible
If you want to create minimum inclusive facets, maximum inclusive facets, and enumeration facets from the imported COBOL level 88 values on the simple type associated with the Schema xsd:element, select Create facets from level 88 value clauses where possible.

This option adds a Value Constraints node under Logical properties in the Properties Hierarchy and the values that you specify are subsequently used for validation during run time.

If a simple type has both minimum and maximum inclusive facets set, as well as enumeration facets, the enumeration facets are used in preference to the minimum and maximum inclusive facets.

Create null values for all fields
If your COBOL level 01 data structure is being initialized to a particular character (for example, SPACE, LOW-VALUE, or HIGH_VALUE) in your COBOL application, you might want to select Create null values for all fields.

If the data structure is initialized to a particular character, the resultant message can cause parsing errors because some fields contain a value that is not valid for the data type of the field. If you select this option any fields that have been initialized to a particular character are treated as NULL values, and the parsing will succeed.

Specify the initialization character using the Null character control, the default value for which is the SPACE character. Setting these controls results in the selection of the Nillable property for all global elements, the CWF Encoding Null property set to NullLiteralFill, and the CWF Encoding Null Value property set to the specified character.

NULL character
Set the Null character in one of the following ways:
  • Select SPACE (the default), NUL, 0x00, or 0xFF from the list.
  • Type a character between quotation marks, for example "c" or 'c', where c is any alphanumeric character.
  • Type a hexadecimal character code in the form 0xYY, where YY is a hexadecimal value.
  • Type a decimal character code in the form YY, where YY is a decimal value.
  • Type a Unicode value in the form U+xxxx, where xxxx is a Unicode value specified in hexadecimal.

Under normal collation sequence rules, use 0x00 for low-values and 0xFF for high-values.

Padding character for strings
Enter the padding character that is to be used when importing the COBOL copybook. Either select from one of the predefined entries in the list, or type the character into the field. The value must resolve to a single character. Set this character in one of the following ways:
  • Select SPACE (the default), NUL, 0x00, or 0xFF from the list.
  • Type a character between quotes, for example "c" or 'c', where c is any alphanumeric character.
  • Type a hexadecimal character code in the form 0xYY, where YY is a hexadecimal value.
  • Type a decimal character code in the form YY, where YY is a decimal value.
  • Type a Unicode value in the form U+xxxx, where xxxx is a Unicode value specified in hexadecimal.
Related tasks
Importing from COBOL copybooks
Related reference
New message definition file wizard
New message definition file wizard: COBOL file
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:26:42

ad30715_ This topic's URL is: