Properties of Input and Output Fields

Each field in a copybook has a number of associated properties, or in XML Schema terms, facets. Some of these properties are defined in the COMMAREA (Type, Minimum OCCURS, and Maximum OCCURS); others are XML Schema properties.

The XML Schema properties do not exist in the copybook. They are additional properties that you can use to constrain the legal values for a field. For example, you can make the maximum length of a field smaller, but you cannot make it larger.

Note The properties that you cannot modify are unavailable from the Task Builder interface.

Input and Output Field Properties

Property Description
Type (Read-only) Data type. This value cannot be modified.
Minimum OCCURS Set the minimum number of times this field must occur in the COMMAREA. Available when an ODO (object depending on) subject is selected.
Maximum OCCURS Set the maximum number of times this field can occur in the COMMAREA. The value for this property must be greater than or equal to the value for Min Occurs. Available when an ODO subject is selected.
Fixed OCCURS Set a fixed number of times this field occurs. Available when a field with OCCURS is selected.
Min Length Set the minimum length of this field in bytes. This value is not used at runtime, and is for display only.
Max Length Set the maximum length of this field in bytes. The value for this property must be greater than or equal to the value for Min Length.
Caution Changing the value for the maximum length of a field to a value larger or smaller than the length of the field on the host can result in errors when a task is run. This may cause the task to fail completely, or generate invalid data or results.
Default Specify a default value for the field. The default value for a field is sent to the host when a value is not received when the task is run.
Min Inclusive/Exclusive Select one. Min Inclusive is used in combination with Max Inclusive to restrict a value to a specified range; Min Exclusive is used in combination with Max Exclusive to restrict a value outside of a specified range.
Max Inclusive/Exclusive Select one. Max Inclusive is used in combination with Min Inclusive to restrict a value to a specified range; Max Exclusive is used in combination with Min Exclusive to restrict a value outside of a specified range.
Object of this OCCURS DEPENDING ON Specifies the object of this ODO clause. Available only when an ODO clause is selected.
Precision Specify the maximum number of decimal digits. This property must be applied to a positive integer.
Scale Specify the maximum number of decimal digits in the fractional part of a value. You cannot specify a number greater than the value for Precision.
Pattern A regular expression used to match the value of the field to a particular pattern.
Caution Values specified for the pattern property do not get saved to the task file created. Although a value can be entered, there is no support for patterns in this release.
Translate Field Specify whether to translate this field from PC code pages to EBCDIC (choose Yes or No).
Related Topics
Bullet Creating Task Files
Bullet About COBOL Copybooks
Bullet Disabling Field Translation for Specific Fields
Bullet Creating a Task Definition
  Attachmate