The DFHCSDUP APPEND command

Add the groups in one list to the end of another list.

APPEND syntax

Description

No duplicate group names are allowed in a list. If DFHCSDUP finds any duplicate names during the APPEND operation it ignores them, and they are not appended. The DFHCSDUP output listing contains a warning message if this happens.

Note: If you are appending from one CSD to another, you should be aware that this command does not copy the groups themselves; you should use a separate COPY command to do this.

Options

FRomcsd(ddname): specifies the ddname of the secondary CSD file from which you are appending listname1.
List(listname1): specifies the name of the list that is appended. Do not use a generic list name.
The list being appended can be on the primary CSD file, or on another CSD file. If you are appending from another CSD file, you must identify it by specifying the FROMCSD parameter.
To(listname2): specifies the name of the list to which you want the group names appended. If you are appending from another CSD file, you can give this list the same name as the one you are appending from. Do not use a generic list name.
If this target list already exists, the source list is appended to the end of it. If the target list does not exist, it is created. (In effect, you are copying the source list.)

Examples

A list called LISTA contains the following groups:

GB001
GB002
GB003

A list called LISTB contains the following groups:

G001
G002
G003

Append LISTB to LISTA, like this:

APPEND LIST(LISTB) TO(LISTA)

After this, LISTA contains the following groups, in this order:

GB001
GB002
GB003
G001
G002
G003

and LISTB still contains:

G001
G002
G003