Format

      CHANGE  COLLECTION  collection-name

              [ DESCRIPTION IS /*text*/ ]
              [ NODESCRIPTION           ]  [ AUDIT IS /*text*/ ] .
              [                         ]

1  –  Parameters

1.1  –  collection-name

    Specifies the collection you are modifying.

1.2  –  text

    Modifies information. Within the DESCRIPTION clause, this is
    information documenting the collection; within the AUDIT clause,
    it is a history list entry. Valid delimiters are /* */ or double
    quotation marks (" ").

    You can use Japanese to document comments in the DESCRIPTION or
    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  –  Description

    The CHANGE COLLECTION command modifies a collection by performing
    a change in place. CDO changes the values you specify, and other
    values remain the same.

    Before you can issue the CHANGE COLLECTION command, you must
    issue the RESERVE COLLECTION command to reserve the collection.
    The SHOW COLLECTION or SHOW RESERVATIONS command indicates
    whether a condition is reserved. The RESERVE command creates a
    new version of the element.

    Since a collection is a controlled element, CDO freezes previous
    versions and allows you to modify only the highest visible
    version.

3  –  Examples

    1.CDO> SET CONTEXT
      CDO> DEFINE COLLECTION REGIONAL_SALES
      cont> DESCRIPTION IS "COLLECTION IS REGION_5".
      CDO>  RESERVE COLLECTION REGIONAL_SALES
      CDO>  CHANGE COLLECTION REGIONAL_SALES
      cont>   DESCRIPTION IS "COLLECTION DIRECTORY IS WEST_COAST".
      CDO>  REPLACE COLLECTION REGIONAL_SALES

      In this example, the CHANGE COLLECTION command modifies the
      description clause of the REGIONAL_SALES collection.

    2.CDO>  RESERVE COLLECTION COMPILER_C
      CDO>  CHANGE COLLECTION COMPILER_C
      cont>   NODESCRIPTION
      cont>   AUDIT IS "PHASE REVIEW".
      CDO>  REPLACE COLLECTION COMPILER_C

      In this example, the CHANGE COLLECTION command removes the
      description clause and adds audit text.