CDO$HELP.HLB  —  CDO Commands, UNRESERVE
    Format

              {COLLECTION            }
              {FIELD                 }
    UNRESERVE {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
    unreserving.

1.2  –  element-name

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

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=keyword
       /NOCLOSURE (default)

    Specifies whether CDO unreserves additional elements. An
    unreserve operation fails if any element is a child of an element
    outside the area defined by the /CLOSURE qualifier.

    The /CLOSURE qualifier takes one of the following keywords:

    CLOSURE
    Keyword      Behavior

    TO_BOTH      Unreserves the element specified and all parents and
                 children.

    TO_BOTTOM    Unreserves the element specified and all children.

    TO_TOP       Unreserves the element specified and all parents.

    If you specify TO_BOTH or TO_TOP, CDO ignores parents above the
    top collection.

2.2    /LOG

    Format options:

       /LOG
       /NOLOG (default)

    Specifies whether CDO displays text identifying each element as
    the element is unreserved.

3  –  Description

    The UNRESERVE command cancels the reservation previously placed
    on a version of an element. This operation deletes the ghost
    version of the element and discards any changes you made while
    you reserved the version.

4  –  Examples

  CDO>  RESERVE COLLECTION /CLOSURE=TO_BOTTOM PRODUCT_INVENTORY
  CDO>  DEFINE FIELD PRODUCT_NUMBER
  cont>   DATATYPE BIT SIZE 5.
  CDO>  DEFINE FIELD PRODUCT_DESCRIPTION
  cont>   DATATYPE TEXT SIZE 50.
  CDO>  UNRESERVE COLLECTION /CLOSURE=TO_BOTTOM PRODUCT_INVENTORY

      In this example, the UNRESERVE command cancels the PRODUCT_
      INVENTORY reservation and deletes the two fields that were
      defined.
Close Help