Previous Topic: Dataset Name Type

Next Topic: Send Report To Another System Screen


Release

Specifies whether the remote partner is to release unused DASD space when creating a file.

YES

The remote partner is to release unused DASD space.

The unused DASD space that is specified for the transfer is released when the file is closed at the end of the transfer.

NO

The remote partner is not to release unused DASD space.

Unicode Transfer Information Screen

The Unicode Transfer Information screen is used to specify parameters for character set conversion of the source file for transfer. Some of the parameters available on the Unicode Transfer Information screen CA XCOM Data Transport uses to call the IBM Unicode Services API to perform data conversion.

Invoke the screen by either entering the command UNICODE on the command line or by pressing the PF10 key on any of the following panels:

Parameter Defaults

The defaults for the Unicode parameters have two different sources:

Screen

A sample Unicode Transfer Information screen follows:

06/25/12 CA XCOM Release r11.6 SP00 USER01 12.177 Unicode Transfer Information 13:50 COMMAND ===> Local Charset : CCSID#37/RE Remote Charset: CCSID#1200/ML Local Encoding : EBCDIC Local Delimiters : NA Remote Encoding : EBCDIC Remote Delimiters : NL Charset Input Error : REPLACE Replacement Character: Charset Conversion Error : FAIL Replacement Character: PFK 1/Help 3/End 11/Hold F1=Help F2=SPLIT F3=End F4=RETURN F5=RFIND F6=RCHANGE F7=UP F8=DOWN F9=SWAP F10=Unicode F11=Hold F12=Alloc

Parameter Fields

This section describes the parameter fields of the Unicode Transfer Information screen.

Local Charset

This parameter specifies the local character set of the source data.

CCSID#nnnnn/tttttttt

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

tttttttt (optional) – specifies the technique search order IBM Unicode Services uses when performing conversion. From 1 to 8 characters are specified. Valid values to use are:

R - Roundtrip conversion

E - Enforced Subset conversion

C - Customized conversion

L - Language Environment Behavior conversion

M - Modified for special use conversion

B - Bidi transformation (Bi-directional) conversion

0-9 - User defined conversions

Note: If the technique search order is not specified, Unicode Services defaults to ‘RECLM’.

Remote Charset

This parameter specifies the remote character set for the target data.

When the remote system is CA XCOM Data Transport for z/OS:

CCSID#nnnnn/tttttttt

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

tttttttt (optional) – specifies the technique search order IBM Unicode Services uses when performing conversion. From 1 to 8 characters are specified. Valid values to use are:

R - Roundtrip conversion

E - Enforced Subset conversion

C - Customized conversion

L - Language Environment Behavior conversion

M - Modified for special use conversion

B - Bidi transformation (Bi-directional) conversion

0-9 - User defined conversions

Note: If the technique search order is not specified, Unicode Services defaults to ‘RECLM’.

When the remote system is CA XCOM Data Transport for Windows or CA XCOM Data Transport for Linux/Unix:

CCSID#nnnnn

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

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

Local Encoding

This parameter specifies an optional encoding for which the specified Local Charset is based. The encoding can only specify EBCDIC.

Local Delimiters

This parameter specifies the delimiters to use for USS-based output files when FILEDATA=TEXT.

Valid options:

NA – Not applicable, the system default delimiter is used.

NL – New line

CR – Carriage return

LF – Line feed

CRLF – Carriage return/Line feed

LFCR – Line feed/Carriage return

CRNL – Carriage return/New line

Remote Encoding

This parameter specifies an optional encoding for which the specified Remote Charset is based.

When the remote system is CA XCOM Data Transport for z/OS, the encoding can be only EBCDIC. When the remote system is CA XCOM Data Transport for Windows or CA XCOM Data Transport for Linux/Unix, the encoding can be either ASCII or EBCDIC.

Remote Delimiters

This parameter specifies a colon separated list of record delimiters that are used to mark and detect the end of a record.

Valid options:

NA – Not applicable, the system default delimiter is used.

NL – New line

CR – Carriage return

LF – Line feed

CRLF – Carriage return/Line feed

LFCR – Line feed/Carriage return

CRNL – Carriage return/New line

VT – Vertical Tabulation

FF – Form Feed

PS – Paragraph Separation

LS – Line Separation

The tables list the valid delimiters for the various encodings, along with delimiters that are mutually exclusive with each one. CA XCOM Data Transport validates the delimiters that are specified and terminates a transfer where mutually exclusive delimiters are specified.

Note: For EBCDIC rules, the ‘FF’ delimiter is only valid for Linux/Unix/Windows platforms.

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

 

Charset Input Error and Replacement Char

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

REPLACE
REPLACE#nnnnnnn

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

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. This option is not supported for z/OS systems and is treated as REPLACE.

FAIL

The transfer terminates with an error condition.

The Replacement Character causes replacement of each piece of erroneous data with the Unicode character that the decimal value nnnnnnn identifies. This option is not supported for z/OS systems, where the replacement character is defined in the conversion table that is defined to IBM Unicode Services. The replacement character has a valid range of 1 – 1114111.

Charset Convert Error & Replacement Char

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

REPLACE
REPLACE#nnnnnnn

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

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. This option is not supported for z/OS systems and is treated as REPLACE.

FAIL

The transfer terminates with an error condition.

The Replacement Character causes replacement of each piece of erroneous data with the Unicode character that the decimal value nnnnnnn identifies. This option is not supported for z/OS systems, where the replacement character is defined in the conversion table that is defined to IBM Unicode Services. The replacement character has a valid range of 1 – 1114111.