File Management - IBM

Table 13. Database-to-Database Copy Operations (continued)
FMTOPT
Parameter
Values
(see note
4)
ALL Field Names in
From-and To-Files Are
the Same (like-named)
Database File Record Formats
SOME Field Names in
From-and To-Files Are
the Same
NO Field Names in Either File Are the Same
Notes:
1. Field attributes include the data type (character, zoned, packed, binary or floating point), field length, decimal
position (for numeric fields), date or time format (for date or time fields), null capability, CCSID, and whether
the field has variable length or fixed length.
2. Mapping consists of converting the data in a from-file field to the attributes of the corresponding (like-named)
to-file field. If the attributes of any corresponding fields are such that the data cannot be converted, the copy is
ended.
3. The records are padded or truncated as necessary. Data in the from-file may not match the to-file record format.
4. Any other value specified for the FMTOPT parameter is ignored when the *CVTFLOAT value or the
*NULLFLAGS value is specified (except the *CVTFLOAT and *NULLFLAGS values).
Specifying data for different field types and attributes
Variable-length fields using FMTOPT(*MAP)
FMTOPT(*MAP) can be used to map data between fixed- and variable-length fields
and between variable-length fields with different maximum lengths.
When mapping a variable-length field with a length of zero to a:
v variable-length to-field, the to-field length is set to zero.
v fixed-length to-field, the to-field is filled with single-byte blanks (X'40'), unless
the to-field is a DBCS-only field. A DBCS-only to-field is set to X'4040's and
surrounded by shift-out and shift-in (SO-SI) characters.
The following applies when the from-field does not have a length of zero and
graphic fields are not being mapped to or from bracketed DBCS fields.
Mapping variable-length fields to variable-length fields
The length of a variable-length from-field is copied to a variable-length to-field
when the from-field data length is less than or equal to the maximum length of the
to-field. If the from-field data length is greater than the maximum length of the
to-field, the data of the from-field is truncated to the maximum length of the
to-field, and the to-field length is set to the maximum length. The data is truncated
in a manner that ensures data integrity.
Note: In the examples, x represents a blank, < represents the shift-out character,
and > represents the shift-in character. The 2-byte length is actually a binary
number shown as a character to make the example readable.
Chapter 4. Copying files 109