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.