Configuring and Customizing Your Product › Define Destinations › How to Code Different Destination Types › Superlist of Lists

Superlist of Lists

TYPE=SUPERLIST
LIST=listname[,...[,listname]]

The TYPE=SUPERLIST statement must be the first non‑comment statement in the control library member.

Multiple listnames can be specified in a single statement or multiple statements can be employed. When a single statement is used to list multiple destinations, the destination must be separated by commas. For example, to specify a list of three list destinations (L1, L2, and L3) any of the following specifications can be used:

• LIST=L1,L2,L3
• LIST=L1,L2
  LIST=L3
• LIST=L1
  LIST=L2
  LIST=L3
• And so on

Notes:

• CA XCOM Data Transport lists are limited to 32720 bytes of storage, as follows:
  • There is 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.

  So, if each member name specified as a list or superlist is 8 characters long, a superlist can identify 2971 member names.

• Each destination list on the superlist must have a member defined in the CA XCOM Data Transport control library.
• For a complete list of the parameters that can be used in a list destination definition, see List Destination Parameters in the chapter “Configuration Parameters.”