File Management - IBM

100 File Management V4R5
A field name cannot be specified if RCDFMT(*ALL) is specified when copying
from a multiple-format logical file, or if the from-file is a device file or inline data
file.
See the following topics for additional information about specifying data for:
v “Variable-length fields used by the INCHAR parameter”
v “Null-capable fields used by the INCHAR parameter”
v “Different CCSIDs used by the INCHAR parameter”
v “DBCS-graphic fields used by the INCHAR parameter”
Variable-length fields used by the INCHAR parameter
When you specify *RCD for the INCCHAR parameter, the starting position
represents the position in the buffer. The 2-byte length field of variable-length
fields must be considered when determining the position. Use single-byte blanks
(X'40') to pad variable-length fields if the INCCHAR value spans multiple fields.
You can specify variable-length fields for the INCCHAR string when you specify a
field name. The starting position represents the position in the data portion of the
variable-length from-field value. The number of bytes that are compared is the
number of bytes in the value that is specified for the INCCHAR string. If the
actual data in the variable-length from-field is shorter than the value specified for
the INCCHAR parameter, the from-field data is padded with single-byte blanks
(X'40') for the comparison.
You cannot specify a zero-length string for the INCCHAR value.
Null-capable fields used by the INCHAR parameter
The INCCHAR parameter allows null-capable character-field and null-capable
DBCS-field names to be specified. However, any logical comparison with a
null-field value tests as false, and the record is not copied. The copy command
performs no special processing if the you specify the *RCD special value as the
field name. The command only compares buffer default values for actual null
values.
Different CCSIDs used by the INCHAR parameter
When you specify *RCD for the INCCHAR parameter, the copy command does not
perform any conversions on the input string. The command compares the byte
string that you entered at the specified position in the record buffer of the
from-file.
When you specify a field name, the command assumes that the input string is in
the CCSID of the job in which the copy command runs. The input string is
converted to the CCSID of the from-field. If no conversion table is defined or if an
error occurs while converting the input string, a message is sent and the copy
operation ends. If the command can correctly convert the value, the command uses
the converted value for record selection.
DBCS-graphic fields used by the INCHAR parameter
When you specify a graphic field for the INCCHAR parameter, you should enclose
the DBCS data in shift-out and shift-in characters. The command assumes that the
data is in the associated DBCS CCSID of the job CCSID. There must be a valid
conversion to the field CCSID; otherwise, an error occurs. The shift-out and shift-in