Format

      CHANGE  FILE_ELEMENT  type-name  element-name

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

              [                  {n              } ]
              [ property-name IS {quoted-string  } ] ... .
              [                  {               } ]
              [ NOproperty-name                    ]

              END [ FILE_ELEMENT element-name ] [ type-name ] .

1  –  Parameters

1.1  –  type-name

    Specifies the type (MCS_BINARY or an MCS_BINARY subtype) of the
    file element you are modifying. See the Oracle CDD/Repository
    Information Model for more information on these types.

1.2  –  element-name

    Specifies the file element you are modifying.

1.3  –  text

    Modifies information. Within the DESCRIPTION clause, this is
    information documenting the file element; 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.

1.4  –  property-name

    Specifies the property you are adding, changing, or removing. You
    specify removal with the NO keyword.

1.5  –  n

    Modifies the value (numerical) set for a property.

1.6  –  quoted-string

    Modifies the value (a string enclosed in quotation marks) set for
    a property.

2  –  Description

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

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

    Before you can issue the CHANGE FILE_ELEMENT command, you must
    reserve the file element with the RESERVE FILE_ELEMENT command.

    If you add, change, or delete a property from the file element,
    the property you specify must be a defined or inherited property
    for the file element's type. See the Oracle CDD/Repository
    Information Model for a list of these properties.

    Errors occur if you attempt to delete the MCS_STOREDIN property
    from a file element whose STORETYPE is EXTERNAL. CDO requires
    this property for external files.

3  –  Examples

  CDO>  RESERVE FILE_ELEMENT MCS_BINARY PARSER_TABLES
  CDO>  CHANGE FILE_ELEMENT MCS_BINARY PARSER_TABLES
  cont>   DESCRIPTION IS "PARSER TABLES FOR VERSION 5.0".
  cont> END MCS_BINARY.
  CDO>  REPLACE FILE_ELEMENT MCS_BINARY PARSER_TABLES

      In this example, the CHANGE FILE_ELEMENT command adds
      description text to the file element PARSER_TABLES.