Previous Topic: CAPKIHOME

Next Topic: EOL_CLASSES


CONVERT_CLASSES

A character string containing print classes for EBCDIC-to-ASCII conversions to be performed. For incoming report transfers only.

Range: 1 to 64 characters

Default: None

CREATE_DIRECTORIES

This parameter indicates whether a new directory should be created to accommodate incoming file transfers. CREATE_DIRECTORIES=YES causes a new directory to be created.

Range: YES or NO

Default: YES

DATACLAS

This parameter specifies the name of the data class to use when allocating a new SMS-managed data set.

Note: This parameter applies only to mainframe SMS data sets.

Range: One to eight characters

Default: None

DEFAULT_CHARSET

DEFAULT_CHARSET specifies the default character set 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. If LOCAL_CHARSET/REMOTE_CHARSET/DEFAULT_CHARSET is UTF based charset, UTF rules are applied disregarding encoding specified in DEFAULT_DELIM.

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

Record Delimiter

Mutually exclusive with

CR

CRLF, CRNL

LF

LFCR

NL

 

CRLF

CR

LFCR

LF

CRNL

CR

FF

 

ASCII Rules

Record Delimiter

Mutually exclusive with

CR

CRLF, CRNL

LF

LFCR

NL

 

CRLF

CR

LFCR

LF

CRNL

CR

VT

 

FF

 

UTF Rules

Record Delimiter

Mutually exclusive with

CR

CRLF, CRNL

LF

LFCR

NL

 

CRLF

CR

LFCR

LF

CRNL

CR

VT

 

FF

 

LS

 

PS

 

Range: 0 to 60 characters

Default: ASCII:LF:CRLF

The tables indicate valid record delimiters for various encodings. If a record delimiter is not applicable for encoding on which the XXXX_CHARSET parameter value is based, it should not be used (XXXX_CHARSET refers to the parameter that is in effect at the time of the transfer, i.e. LOCAL_CHARSET, REMOTE_CHARSET, or DEFAULT CHARSET).

Example: If XXXX_CHARSET is not UTF based, PS and LS delimiters should not be used. Similarly if XXXX_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_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

DSNTYPE

This parameter specifies the data set definition.

Note: This parameter applies only to mainframe SMS data sets.

LIBRARY

Defines a PDSE.

PDS

Defines a partitioned data set.

BASIC

Defines a legacy sequential dataset.

LARGE

Defines a large format sequential dataset.

EXTREQ

Defines an extended format dataset.

EXTPREF

Specifies an extended format is preferred. If the extended format is not possible, a basic format is used.

<blank>

Defines a partitioned or sequential data set based on the data set characteristics entered.

Note: These values are IBM standards for SMS processing.

Range: One to eight characters

Default: None