The Batch Interface › SYSIN01 Parameters › General SYSIN01 Parameters › LIST › Using a Superlist

Using a Superlist

Specifying the name of a superlist for the LIST parameter broadcasts the file transfer to all remote destinations designated on a predefined distribution superlist, or list of lists.

Up to 32720 bytes

XCOM LIST names are names of members in the XCOMCNTL data set and therefore are limited to eight alphanumeric characters.

XCOM lists are limited to 32720 bytes of storage, consisting of the following:

• A 32-byte storage descriptor, leaving 32688 bytes for the list.
• Each list entry occupies 4 to 10 bytes:
  • 1 byte for the TYPE
  • 1 flag byte
  • 1 byte for the LENGTH
  • 1 to 8 bytes for the name of the list

If each member name specified as a LIST/SUPERLIST is eight characters long, then a SUPERLIST can include 2971 member names.

LOCAL_CHARSET

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

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

Default: The DEFAULT_CHARSET parameter in the destination member or CA XCOM Data Transport Default Options Table specifies the default.

LOCAL_DELIM

This parameter specifies an optional encoding for which the specified LOCAL_CHARSET is based. The encoding must be the first option in the list and the only valid value is EBCDIC.

Specifies a colon separated list of record delimiters that are used to mark and detect the end of a record for USS-based output files when FILEDATA=TEXT.

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

Valid options:

EBCDIC – The specified character-set is EBCDIC encoded.

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

Default: The DEFAULT_DELIM parameter in the destination member or CA XCOM Data Transport Default Options Table specifies the default.

Notes:

• For EBCDIC rules, the ‘FF’ delimiter is only valid for Linux/Unix/Windows platforms.
• If EBCDIC is specified, it must be the first option in the list.
• If a delimiter is specified that is not valid for the encoding it is ignored

EBCDIC Rules