The PROMOTE command moves a controlled element to the next-higher
    approval level.

    You cannot promote an element more than one approval level at a
    time.

    You cannot promote more than one version of an element at a time.
    If you do not include a version number, PROMOTE promotes the
    highest visible version.

    An error occurs if you attempt to promote an element that is
    reserved. The SHOW RESERVATIONS command indicates whether this
    condition exists.

    An error occurs if you attempt to promote an element that is a
    parent of another element in the same partition.

    An error occurs if you attempt to promote an element that is a
    parent of another element in a partition that is not on the path
    between the destination partition and the root partition.

    An error occurs if you attempt to promote an element from the
    root partition. The root partition is the highest partition in
    the partition hierarchy.

    When you promote a version to higher levels of approval, the
    value of the autopurge property determines whether CDO deletes
    intermediate versions of the element in the source partition.
    You set the autopurge property for a partition in the DEFINE
    PARTITION command.

    When you promote a version to higher levels of approval, you can
    still access previous versions at lower levels. However, you must
    explicitly promote any changes you make to the element at lower
    levels to see this change reflected in the higher level versions.