Parameters › List of Parameters › DEBUG_FLAG

DEBUG_FLAG

This parameter specifies whether a trace will be output to the file /tmp/<tid>.TRA instead of to the default path $XCOM_HOME/trace/<tid>.TRA. In addition to the transfer trace information, the initialization will also be traced. The trace level is still taken from the variable XTRACE.

Note:

• The <tid> variable refers to the six-digit transfer ID number.
• $XCOM_HOME is an environment variable

YES

The trace is output to /tmp/<tid>

NO

The trace is output to $XCOM_HOME/trace/<tid>.TRA.

Default: NO

DEFAULT_CHARSET

This parameter specifies the default character set that CA XCOM Data Transport uses for Unicode transfers (CODE_FLAG=UTF8 or CODE_FLAG=UTF16).

CCSID#nnnnn

nnnnnn - specifies the CCSID number that corresponds to the character set. Valid values are 1 - 65535.

Alternatively, the value can be specified as an IANA character set name, or (ICU) acceptable alias name.

Range: 0 to 60 characters

Default: ISO-8859-1

DEFAULT_CONVERROR

This parameter identifies the appropriate action when the input file contains characters that cannot be converted. They are not included within the output character sets character repertoire.

Used only for UNICODE transfers (CODE_FLAG=UTF8 or CODE_FLAG=UTF16).

REPLACE

Replace each unconvertible character with the default substitution characters defined for the Unicode character set.

REPLACE#nnnnnnn

Replace each unconvertible character with the Unicode character that the decimal value nnnnnnn identifies. (If the specified replacement character cannot be represented in the output character set, then the transfer is failed).

SKIP

The erroneous data is disregarded, but a warning message is issued at the end of the transfer. The message identifies that this condition occurred and provides a total count of the number of skipped characters.

FAIL

The transfer terminates with an error condition.

Default: FAIL

DEFAULT_DELIM

DEFAULT_DELIM specifies an optional encoding for which the specified DEFAULT_CHARSET is based. The encoding can be either ASCII or EBCDIC. If specified, the encoding must be the first option in the list.

Additionally, specifies a colon separated list of record delimiters that are used to mark and detect the end of a record can be specified.

This parameter is used only for UNICODE transfers (CODE_FLAG=UTF8 or CODE_FLAG=UTF16).

EBCDIC Rules

ASCII Rules

UTF Rules

Range: 0 to 60 characters

Default: ASCII:LF:CRLF

Tables indicate valid record delimiters for various encodings. If a record delimiter is not applicable for encoding on which XX_CHARSET (LOCAL_CHARSET or REMOTE_CHARSET or DEFAULT CHARSET, whichever of these is in effect at the time of transfer) is based, it should not be used.

Example: If XX_CHARSET is not UTF based, PS and LS delimiters should not be used. Similarly if XX_CHARSET is EBCDIC based, VT, PS, and LS delimiters should not be used.

In these cases, these delimiters will be treated as invalid and disregarded if used. If no valid delimiter is found in DEFAULT_DELIM, delimiters will be derived as explained below.

If DEFAULT_DELIM is not specified or doesn’t contain at least one valid delimiter, platform default values are used as shown below,

• Default for ASCII: ‘LF,CRLF’
• Default for EBCDIC: ‘NL’

DEFAULT_INPUTERROR

This parameter identifies the appropriate action when the input file contains data that is not consistent with the specified input character set.

Used only for UNICODE transfers (CODE_FLAG=UTF8 or CODE_FLAG=UTF16).

REPLACE

Replace each piece of erroneous data with the default substitution characters defined for the Unicode character set.

REPLACE#nnnnnnn

Replace each piece of erroneous data with the Unicode character that the decimal value nnnnnnn identifies.

SKIP

The erroneous data is disregarded, but a warning message is issued at the end of the transfer. The message identifies that this condition occurred and provides a total count of the number of ignored bytes.

FAIL

The transfer terminates with an error condition.

Default: FAIL