Revert Elements Command

A new command can revert an element, or hierarchy of elements, to a previous state:

>- REVert -+- ELEment ---.

| |

`- HIERarchy -+- <selele> -+- AT -----.

| |

`- BEFore -+- <comparison> ->

where the <comparison> syntax is similar to that following the SINCE keyword in the DIFFERENCE and OUTPUT CHANGES commands:

-->-+- <date/time> -+-----------------------.

| | |

|- LATEST ------| |

| | |

|---------------+- EXTRACT -+-----------|

| | |

| |- extno ---+

| | |

| ‘- extname -+

| |

`- STAMP - <name> ----------------------+->

If the BEFORE option is used, the elements will be reverted to the state they had before the specified session.

Examples

The Revert command ensures that every element creation, include, reorder and deletion, and every attribute change is allowed before proceeding. If any of these tests fail, for example due to legality checks, read-only databases or DACs, then the entire revert operation is cancelled and the following error is generated.

(43,615) Cannot Revert elements. No changes have been made.

In this case a series of warning messages is written to the console indicating the causes of the error, for example:

DAC prevents deletion of element /DELETE_UDET_B

DAC prevents creation of element =15752/1363

DAC prevents modification of attribute Built on element /MODIFY_B_VESS1

Element locks do not prevent a Revert operation if those elements were unlocked in the previous state.

Note:
This command is not directly related to the REVERT <database name> command available in Admin. This command allows an entire database to be reverted to the state it had at a previous session.