Previous Topic: Dataset Name TypeNext Topic: UMASK


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 Additional File Information screen allows the requester to enter additional information about the local or remote file. The parameters on the Additional File Information fall into three categories:

The Unicode Transfer parameters are used to specify parameters for character set conversion of the source file for transfer. The Unicode Transfer parameters are used by CA XCOM Data Transport to call the IBM Unicode Services API to perform data conversion.

The CA XCOM Gateway parameters are used to specify parameters when a file transfer request is to transmit data to a CA XCOM Gateway.

The USS File System parameters are used to specify parameters when a file transfer request is to transmit USS file system data.

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

Parameter Defaults

The defaults for the Additional File Information parameters have two different sources:

Screen

A sample Additional File Information screen follows:

06/25/13 CA XCOM Release v12 USER01 12.177 Additional File Information 13:50 COMMAND ===> Local Information

File : Charset : CCSID#37/RE Encoding : EBCDIC Delimiters : NA Remote Information File : Charset : CCSID#1200/ML Encoding : EBCDIC Delimiters : NL GatewayGUID: General Information Charset Input Error : REPLACE Replacement Character: Charset Conversion Error: FAIL Replacement Character: Gateway Destination Path : USS -> UMASK : LFILEDATA: FILEDATA: (B/T/R) USSLRECL: ------------------------------------------------------------------------------- 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=Fileinfo F11=Hold F12=Alloc

Local Information Fields

The Local Information fields of the Additional File Information screen pertain to the local system.

File

The local file name specified for the transfer. This field is informational and cannot be changed on the Additional File Information screen.

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’.

Encoding

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

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 Information Fields

The Remote Information fields of the Additional File Information screen pertain to the remote partner system.

File

The remote file name specified for the transfer. This field is informational and cannot be changed on the Additional File Information screen.

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.

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.

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

 

Gateway GUID

Identifies the remote file as a CA XCOM Gateway file and specifies the CA XCOM Gateway GUID. The CA XCOM Gateway GUID is a unique value that identifies each CA XCOM Gateway file.

Specify one of the following items:

Default: None (blank)

General Information Fields

The General Information fields of the Additional File Information screen pertain to both the local and the remote partner system.

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 each piece of erroneous data with the default substitution characters defined for the Unicode character set.

REPLACE#nnnnnnn

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.

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.

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 each unconvertible character with the default substitution characters defined for the Unicode character set.

REPLACE#nnnnnnn

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.

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.