Format

      CHANGE  PARTITION partition-name

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

              [ LOOKASIDE_PARTITION IS look-partition-name ,... ]
              [ NOLOOKASIDE_PARTITION                           ]
              [                                                 ]

              [ PARENT_PARTITION IS parent-partition-name ]

              [ AUTOPURGE   ]
              [ NOAUTOPURGE ] .
              [             ]

1  –  Parameters

1.1  –  partition-name

    Specifies the partition you are modifying.

1.2  –  text

    Modifies information. Within the DESCRIPTION clause, this is
    information documenting the partition; 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.3  –  look-partition-name

    Modifies the list of partitions that is visible through this
    partition. Each partition must be an existing partition.

1.4  –  parent-partition-name

    Modifies the partition hierarchy by naming a parent (owner) for
    an existing parent (owner) partition.

2  –  Description

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

    Because a partition is a nonversioned element, CDO does not
    accept a branch designation or a version number in the partition
    name.

    The LOOKASIDE_PARTITION clause modifies the list of partitions
    whose contents are visible through the partition you are
    modifying.

    The PARENT_PARTITION clause modifies the partition hierarchy by
    naming an owner for an existing parent (owner) partition. This
    clause can be specified only once during the lifetime of the
    partition, in either the DEFINE PARTITION or CHANGE PARTITION
    command.

    The AUTOPURGE and NOAUTOPURGE keywords redefine the autopurge
    property for the partition. The value of this property indicates
    whether or not CDO automatically purges intermediate versions of
    elements in the partition when you promote the latest version.

3  –  Examples

    1.CDO>  DEFINE PARTITION FIRST_BASELEVEL AUTOPURGE.
      CDO>  DEFINE PARTITION FRONT_END
      cont>   PARENT_PARTITION IS FIRST_BASELEVEL AUTOPURGE.
      CDO>  DEFINE PARTITION BACK_END
      cont>   PARENT_PARTITION IS FIRST_BASELEVEL
      cont>   LOOKASIDE_PARTITION IS FRONT_END AUTOPURGE.
      CDO>  CHANGE PARTITION FRONT_END
      cont>   LOOKASIDE_PARTITION IS BACK_END.

      In this example, the CHANGE PARTITION command adds a LOOKASIDE_
      PARTITION clause to the FRONT_END partition element. You add
      this clause in a CHANGE PARTITION command, rather than in the
      initial DEFINE PARTITION command, because the partition named
      in a LOOKASIDE_PARTITION clause must be an existing partition.

    2.CDO>  DEFINE PARTITION FINAL_REPORT AUTOPURGE.
      CDO>  DEFINE PARTITION PUBLICATION_RELEASE AUTOPURGE.
      CDO>  CHANGE PARTITION FINAL_REPORT
      cont>   PARENT_PARTITION IS PUBLICATION_RELEASE.

      In this example, the CHANGE PARTITION command adds a PARENT_
      PARTITION clause to the FINAL_REPORT partition element.

    3.CDO> DEFINE PARTITION FIRST_TESTBASELEVEL AUTOPURGE.
      CDO> CHANGE PARTITION FIRST_TESTBASELEVEL
      cont> AUDIT IS "LET'S PROMOTE ALL TEST VERSIONS" NOAUTOPURGE.

      In this example, the CHANGE PARTITION command adds an AUDIT
      clause and modifies the AUTOPURGE keyword.