Format

      DEFINE  CONTEXT context-name

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

              BASE_PARTITION IS partition-name

              [ TOP IS collection-name ]

              [                       {SPECIFIC_VERSION  } ]
              [ DEFAULT_ATTACHMENT IS {LATEST_CHECKIN    } ] .
              [                       {LATEST            } ]
              [                       {                  } ]

1  –  Parameters

1.1  –  context-name

    Specifies the context you are creating.

1.2  –  text

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

    Specifies the base partition of the partition hierarchy.

1.4  –  collection-name

    Specifies the top collection of the collection hierarchy.

2  –  Description

    The DEFINE CONTEXT command creates a context. A context allows
    you to restrict or expand your view of the system and set the
    characteristics associated with your work environment.

    The BASE_PARTITION clause sets the base partition property to
    the partition name you specify. Use the DEFINE PARTITION command
    to create this partition prior to issuing the DEFINE CONTEXT
    command.

    The TOP clause sets the top collection property to the collection
    name you specify. Include this clause only when you are
    redefining the top collection property for an existing context.
    See the DEFINE COLLECTION command for more information on setting
    this property for a new context.

    The DEFAULT_ATTACHMENT clause defines the default attachment
    property for the context. This property refers to the default
    behavior that occurs when you issue the UPDATE command. Choose
    one of the following keywords:

    DEFAULT_
    ATTACHMENT
    Keyword          Behavior

    LATEST           Detaches the version currently attached and
                     attaches the lastest version, whether checked in
                     or ghost.

    LATEST_CHECKIN   Detaches the version currently attached and
                     attaches the version most recently checked in.

    SPECIFIC_        Does not detach the version currently attached.
    VERSION

    If you do not specify the DEFAULT_ATTACHMENT clause, CDO creates
    the context with LATEST default attachment, by default.

3  –  Examples

  CDO>  DEFINE CONTEXT SALES
  cont>   BASE_PARTITION IS FIRST_QUARTER
  cont>   DEFAULT_ATTACHMENT IS LATEST_CHECKIN.

      In this example, the DEFINE CONTEXT command creates the SALES
      context. The BASE_PARTITION clause sets the base partition
      property to the previously defined FIRST_QUARTER partition. The
      keyword LATEST_CHECKIN in the DEFAULT_ATTACHMENT clause sets
      the default attachment property for the context to the version
      most recently checked in.

      See the DEFINE COLLECTION command for more information on
      setting the top collection property for a context.