Format

               { COLLECTION              }
               { FIELD                   }
      PROMOTE  { RECORD                  }  [ qualifier ]   element-name ,...
               { FILE_ELEMENT  type-name }
               {                         }
               { GENERIC  type-name      }

               [ AUDIT  IS /*text*/ ]

1  –  Parameters

1.1  –  type-name

    Specifies the type of the file or generic element you are
    promoting.

1.2  –  element-name

    Specifies the element you are promoting.

1.3  –  text

    Adds information to the history list entry. Valid delimiters are
    /* */ or double quotation marks (" ").

    You can use Japanese to document comments in the AUDIT clause for
    a field. To do this, use the SET CHARACTER_SET command, and set
    the character_set of the session to DEC_KANJI.

2  –  Qualifiers

2.1    /CLOSURE

    Format options:

       /CLOSURE=TO_BOTTOM
       /NOCLOSURE (default)

    Specifies whether CDO promotes additional elements. Specifying
    the /CLOSURE=TO_BOTTOM qualifier promotes all children of an
    element that reside in the same partition.

3  –  Description

    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.

4  –  Examples

  CDO>  PROMOTE RECORD /CLOSURE=TO_BOTTOM SUBSCRIBER

      In this example, the PROMOTE command promotes the record
      SUBSCRIBER and all children.