Download FLCL - User Manual

FLCL - User Manual
257 / 764
DESCRIPTION If the write byte order mark keyword is defined, then the corresponding BOM sign is written at the start of the
output stream (block oriented) or at the beginning of each record. If this BOM keyword is not used, then the BOM sign will not
be written (this is valid independent of the chosen encoding/CCSID). If a valid BOM sign is located in the middle of the input
stream, it is removed from the data. If you define the BOM keyword and the target charset contains only single bytes or no valid
BOM sign, then no byte order mark will be written to the output file.
If an invalid BOM sign is recognized, then it will be ignored and causes no entry in the report file. If the byte order changes in
the middle of text and the BOM handling switch is not activated, the conversion will stop and an error message is thrown.
By default, the write BOM keyword is set to OFF.
4.2.270
PARAMETER CHRMODE
SYNOPSIS
HELP:
PATH:
TYPE:
SYNTAX:
Define handling of non-convertible characters [STOP]
CONV.WRITE.FLAM4
NUMBER
CHRMODE=STOP/IGNORE/SUBSTITUTE
DESCRIPTION With the MODE selection you can define how an invalid or incomplete character is handled inside of a unit by
this component. All possible modes are listed at the end of this chapter.
This MODE is valid for the content of each unit (block or record). At the end of a unit there can be an incomplete character. Such
a rest will be handled dependent on the METHOD you choose. The rest of the last unit of a data field will be concatenated to the
first unit of the next data field. For all other records in a data field the handling of such a rest will be defined by the respective
METHOD.
The SKIP case for METHOD is only relevant for incomplete byte sequences at the end of a unit. The ignore and substitution
mode is only effective for all characters in the middle of the unit, besides an incomplete byte sequence occurs in the last unit.
Please don’t mix up the IGNORE case for MODE with the SKIP case of METHOD.
If a system or user substitution table is used the stop, ignore or substitute are only relevant for characters not managed by
the CCSIDs and the substitution tables. This means that the USRTAB and SYSTAB are added to the capabilities of character
conversion and only for the rest the chosen MODE is used.
4.2.270.1
CONSTANT STOP
SYNOPSIS
HELP:
PATH:
TYPE:
SYNTAX:
Stop at the first non-convertible character
CONV.WRITE.FLAM4.CHRMODE
NUMBER
STOP
DESCRIPTION Stops conversion at the first incomplete or invalid character which can not be converted. An error message
is given with the position of abortion and the value in the input stream. An entry will be (STP()) written to the report file to
log this event. To be compatible with other conversion tools, this is the default case, but we recommend to use IGNORE or
SUBSTITUTE to prevent any abortion.
indexterm:[Constant STOP}
4.2.270.2
CONSTANT IGNORE
SYNOPSIS
HELP:
PATH:
TYPE:
SYNTAX:
Ignore non-convertible characters
CONV.WRITE.FLAM4.CHRMODE
NUMBER
IGNORE