Using Elementary Item Input and Output Properties

Each elementary item in a copybook has a number of associated properties, or in XML schema terms, facets. Some of these properties are defined in the data structure (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 an elementary item. For example, you can make the maximum length of a field smaller, but you cannot make it larger.

Properties that you cannot modify are unavailable from the Transaction Studio interface.

Input and Output 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 data structure. Available when an ODO (object depending on) subject is selected.
Maximum OCCURS Set the maximum number of times this field or record can occur in the data structure. The value for this property must be greater than or equal to the value for Min Occurs and less than or equal to the number of rows supported by the transaction at the host. . 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.

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 project is run. This may cause the project to fail completely, or generate invalid data or results.

Default Specify a default value for the input field. The default value for a field is sent to the host when the client does not set the field value.
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.

Translate Field Specify whether to translate this field from PC code pages to EBCDIC (choose Yes or No).

 

Values specified for the Pattern, Min Inclusive/Exclusive, Max Inclusive/Exclusive, Precision, and Scale properties are not saved to the created client operation. Although a value can be entered, there is no support for these properties in this release.

Related Topics
Bullet Create a Client Operation
Bullet About COBOL Copybooks
Bullet Disable Field Translation for Specific Fields