PVCS Dimensions SCC integration readme file

General information

    This document covers issues concerning support of PVCS Dimensions with
    SCC interface.

    The SCC integration with PVCS Dimensions version 5.0 was tested with
    Together 4.0 under SUN JDK 1.2.2, Windows NT 4.0 SP 5.

Known issues

    Before starting to use Dimensions with Together the former must be
    configured to support Together as IDE. See corresponding section in
    this document for details.

    The directory path set in the default Work Set must be the parent
    directory of Together project root associated with Dimensions project.

    Initial name of Dimensions project entered in Version Control project
    field of Project properties dialog, must be unique among all directories
    in the Work Set.

Problems and workarounds

    The SCC integration does not work under JDK 1.3. There is no workaround to
    this problem at the moment the document is written, you have to use SUN
    JDK 1.2.2.

    When running Version Control commands from Together, Dimensions may
    display a modal window with command execution status, which is inactive
    and can't be closed. To avoid this problem set property in vcs.config file
    "vcs.scc.usecallback=true" (false is default). This causes Dimensions to
    display all status messages in Together message window.

    After adding or checking in a file to Dimensions, no matter what was the
    state of "Keep checked out" checkbox, Dimensions deletes the file(s) from
    local directory. To get files back execute "Get" or "Checkout" on the
    directory where the file(s) were.

    On first running "Get" or "Checkout" command from Together with PVCS
    Dimensions, it may crash unexpectedly without any warning: process
    terminates killing the Java machine. To avoid this problem set property
    "vcs.scc.queryinfobeforeget=true" in file vcs.config. This option tells
    VCS to query info on files before proceeding with get.

Configuring PVCS Dimensions to work with Together IDE

    Together initializes sccpcms.dll with IDE name "Together", so IDE
    environment Together must be set up correctly.

    In product $GENERIC add an object type PROJECT with attribute IDE_VALIDSET.
    Define Valid Set IDE_PROJECTS which by default contains definitions for
    IDEs certified to work with Dimensions, created by IDE Setup. Add a value
    Together, tg. Attach lifecycle SOURCE to the object type.

    Define file formats and MIME types for file types you wish Together to
    upload to Dimensions, if not yet defined. These types are:

    name     format      MIME type
    JAVA     Ascii text  text/plain
    C++      Ascii text  text/plain
    PASCAL   Ascii text  text/plain
    IDL      Ascii text  text/plain
    PROJECT  Ascii text  text/plain
    DIAGRAM  Ascii text  text/plain
    WMF      Binary      binary/wmf
    GIF      Binary      binary/gif

    In IDE Setup tool define item types used by Together. These items are:

    pattern     format  type
    %.java      JAVA    SRC
    %.cpp       C++     SRC
    %.cc        C++     SRC
    %.cxx       C++     SRC
    %.c         C++     SRC
    %.hpp       C++     SRC
    %.h         C++     SRC
    %.idl       IDL     SRC
    %.pas       PASCAL  SRC
    %.dfActivity    DIAGRAM SRC
    %.dfBusinessProcess DIAGRAM SRC
    %.dfClass   DIAGRAM SRC
    %.dfComponent   DIAGRAM SRC
    %.dfDeployment  DIAGRAM SRC
    %.dfEJBAssembly DIAGRAM SRC
    %.dfER  DIAGRAM SRC
    %.dfPackage DIAGRAM SRC
    %.dfSequence    DIAGRAM SRC
    %.dfUseCase DIAGRAM SRC
    %.dfXMLType DIAGRAM SRC
    %.tpr   PROJECT SRC
    %.tws   PROJECT SRC
    %.wmf   WMF     DAT
    %.gif   GIF     DAT
