File Management - IBM

114 File Management V4R5
in the current job under which the copy command is running. This may be
*MDY, *DMY, *YMD, or *JUL. The length of the zoned decimal field must be 5,0
(if the current job format is *JUL) or 6,0 (if the current job format is *MDY,
*DMY, or *YMD). The system attempts to convert or copy it to the date to-field.
v For converting a zoned decimal field to a time field, the system assumes the
zoned decimal field data is in the *HMS format (no separators). The length of
the zoned decimal field must be 6,0. The system attempts to convert or copy it
to the time to-field.
v For converting a zoned decimal field to a timestamp field, the system assumes
the zoned decimal field data is in the YYYYMMDDHHMMSS form (no
separators). The length of the zoned decimal field must be 14,0. The system
attempts to convert or copy it to the timestamp to-field.
When converting a date, time, or timestamp field to a zoned decimal field,
FMTOPT(*MAP) is specified and the corresponding from- and to-field names
match, the system uses the current job specified form to determine what format the
zoned decimal data should be in. The following applies:
v For converting a date field to a zoned decimal field, the system assumes the
zoned decimal field data is to be in the same date format (no separators) as
specified in the current job under which the copy command is running. This
may be *MDY, *DMY, *YMD, or *JUL. The length of the zoned decimal field
must be 5,0 (if the current job format is *JUL) or 6,0 (if the current job format is
*MDY, *DMY, or *YMD). The system attempts to convert or copy the date field
to it.
v For converting a time field to a zoned decimal field, the system assumes the
zoned decimal field data is to be in the *HMS format (no separators). The length
of the zoned decimal field must be 6,0. The system attempts to convert or copy
the time field to it.
v For converting a timestamp field to a zoned decimal field, the system assumes
the zoned decimal field data is to be in the YYYYMMDDHHMMSS form (no
separators). The length of the zoned decimal field must be 14,0. The system
attempts to convert or copy the timestamp field to it.
Any conversion not successful because of a data value, data format, or data-length
error causes an information message to be sent. The to-file field is set with its
default value.
Null-capable fields using FMTOPT(*MAP) or FMTOPT(*NOCHK)
FMTOPT(*MAP) or FMTOPT(*NOCHK) must be specified on the CPYF command
if:
v The from-file is a database data file.
v The to-file is a physical data file.
v The record formats are not identical.
For the record formats to be identical, corresponding fields in the from-file and
to-file must both be null-capable or not null-capable. For the CPYFRMQRYF
command, the same is true except that the open query file record format is used
(rather than a from-file format).
When you use FMTOPT(*MAP):
v Null values are copied from null-capable from-file fields to null-capable to-file
fields that are named alike. This copying can only happen if the field attributes
and lengths are compatible.