Adding data to a data set using data from an edit session

The APPEND primary command (or its abbreviation, APP) adds data from one or more lines of the data in the current editor session to a sequential, VSAM, or z/FS data set.

To specify the lines to be added to a data set, use one of these:

C or CC prefix commands (to copy lines)
M or MM prefix commands (to copy lines, then delete them)
A label range. (You must specify the "from" and "to" labels on the append command.)

Note that the lines that are copied or moved to the specified data set are only those lines which are not grouped. This means that lines in any of these groups are not copied (or moved):

Excluded groups.
Suppressed groups (groups of other record types when using a template).
Not-selected groups (groups of not-selected records when using a template).

This allows for a wide variety of control over what you create in the target data set, matching the current SHOW settings in the editor session.

If you specify the data set name as part of the APPEND primary command, and the move or copy line commands (or range operand) are entered, the specified data in the current editor session is appended to the data set immediately.

You can specify a partially-qualified or fully-qualified data set name as part of the command.

Example:

APPEND 'userid.datasetname': Appends data to userid.datasetname.

If you enter the APPEND command without a data set name, or you enter the extended version of this command, APPENDX (or its abbreviation, APPX), File Manager displays an extended append panel allowing you to enter the name of a target data set.

Examples:

APP .STRT .END: Displays an extended append panel where you can enter the data set name.
APPX 'userid.dataset': Displays an extended append panel where you can enter the data set name.

The Pack option on the extended append panel allows you to choose whether the data being created is stored in ISPF packed or standard format. The displayed default reflects the current pack mode of the data being edited or viewed.

After the append processing is completed, File Manager returns you to the existing editor session.

Note:

In a CICS® environment, CICS® resources are not available as a target for this command. Also, MQ resources are not available as a target for this command.
If the target file for an append is a KSDS VSAM, the occurrence of duplicate keys causes an informational message to be displayed, but processing of the command continues.