Previous Topic: Add SyntaxNext Topic: Archive Syntax


The Archive Statement

The ARCHIVE statement writes the base level and all change levels of an element to a sequential file (known as an archive data set). In addition, for CA Endevor SCM ACM users, the ARCHIVE action writes the base level and all change levels of the Component List to the archive data set.

Use the ARCHIVE action to:

Archive is available in batch only. Once an element has been archived, COPY, LIST, RESTORE, and TRANSFER actions can be executed against the archive data set.

Sourceless elements cannot be archived. When an attempt to archive an explicitly specified sourceless element is encountered, the action fails. If a sourceless element is encountered during wildcard expansion, the element is skipped and a warning message is issued.

When the Bypass Element Delete option is not specified, a check is made to see if prior sourceless elements exist. If one does exist, the action will fail if no other sourced element exists upstream. The action cannot be allowed to continue because it would remove source access to the sourceless element, making it impossible for it to be regenerated.