CDO$HELP.HLB  —  CDO Commands, DELETE  FIELD
    Format

      DELETE  FIELD  [ qualifier ] ...   field-name ,... .

1  –  Parameters

1.1  –  field-name

    Specifies the field element you are deleting. You can substitute
    an asterisk (*)  wildcard character for this parameter.

2  –  Qualifiers

2.1    /DESCENDANTS

    Format options:

       /DESCENDANTS
       /NODESCENDANTS (default)

    Specifies whether CDO deletes children. When you specify the
    /DESCENDANTS qualifier, and your field element is controlled,
    CDO deletes all children that are not also children of additional
    elements outside the area defined by your top collection. If the
    field is uncontrolled, CDO deletes all children that are not also
    children of any other elements.

2.2    /LOG

    Format options:

       /LOG
       /NOLOG (default)

    Specifies whether CDO displays text confirming that the field
    element is deleted.

3  –  Description

    The DELETE FIELD command deletes a field element from a
    repository.

    If a field element is controlled, CDO freezes previous versions
    and allows you to delete only the highest visible version. If a
    field element is uncontrolled, CDO deletes the highest version
    unless you specify another version number.

    You cannot delete a field that is a child. Delete the parent
    first, or include the /DESCENDANTS qualifier to delete parents
    and children at the same time.

4  –  Examples

  CDO>  DELETE FIELD /DESCENDANTS ORDER_NUMBER.

      In this example, the DELETE FIELD command with the /DESCENDANTS
      qualifier deletes the ORDER_NUMBER field element and its
      children.
Close Help