Automatic Editing and Error Handling › Automatic Editing at Runtime › Mapout Operations

Mapout Operations

Automatic editing operates on a single field at a time. Automatic editing processes each field as illustrated in the following figure. A given automatic editing operation must be completed without errors for a field before automatic editing can advance to the next editing operation for that field.

A translation character can be defined at system generation to be output when invalid data is found on mapout. If the translate character is defined as a null or a blank, no translation is performed. The default translation character values is the at character (@). Data that contains invalid character values (such as packed data that cannot be unpacked or bit data) is converted to a single @ character; the @ character is displayed in the field when the map is displayed.

The code table (if any) for a field is used to convert an encoded stored value to a decoded display value. The dialog or program that uses the map abends if an unanticipated stored value is evaluated by a code table that does not include the keywords NOT FOUND as an encoded value.

Automatic editing places blanks in numeric input if the Blank when zero option is on for the field and the input contains only zeros.

Automatic editing converts input to external format from internal format by processing the external picture for the field from right to left. If an error occurs during this phase, the task requesting the mapout is abended.

Automatic editing places underscores in a blank field if UNDERSCORE BLANK FIELD was selected for the field.

Edit tables are not used in mapout operations.