Home
Managing change and releases
Learn how to manage change and release in the product.
Guide to building software on Windows
Working with DOs and configuration records
You can perform operations on derived objects and configuration records.
Listing and describing derived objects
Learn how to list and describe derived objects.
Listing the kind of a derived object
Learn how to list the kind of a derived object.

Managing change and releases
Learn how to manage change and release in the product.
- Managing software projects
- Workflow for creating projects
- Workflow for making baselines
- Workflow for recommending baselines
- Guide to building software on Linux and UNIX
- Guide to building software on Windows
  - VersionVault build concepts
    HCL VersionVault supports makefile based building of software systems and provides a software build environment closely resembling that of the make program.
  - Derived objects and configuration records
    Learn about derived objects and configuration records.
  - Pointers on using HCL VersionVault build tools
    Learn about how to use VersionVault build tools.
  - Working with DOs and configuration records
    You can perform operations on derived objects and configuration records.
    - Setting correct permissions for derived objects
      Learn how to set permission for derived objects.
    - Listing and describing derived objects
      Learn how to list and describe derived objects.
      - Listing derived objects created at a certain path name
        Use the lsdo command to list derived objects created at a specific path name.
      - Listing the kind of a derived object
        Learn how to list the kind of a derived object.
      - Displaying the OID of a DO
        The OID of a derived object is the permanent identifier recorded in the VOB database for the DO.
      - Displaying a description of a DO version
        The describe command displays descriptions of DO versions, as it does descriptions of regular versions.
    - Identifying the views that reference a derived object
      The VOB stores information about which views reference a derived object.
    - Specifying views that can wink in derived objects
      You can use the CCASE_WINKIN_VIEWS environment variable to specify a list of views that can wink in derived objects.
    - Specifying a derived object in commands
      In general, you use standard path names to access DOs when you're working in a view that references them.
    - Winking in a DO manually
      You can manually wink in any DO to your view, using the winkin command.
    - Preventing winkin
      Learn how to prevent winkin to or from your view during a build or audit.
    - Converting derived objects to view-private files
      Using a standard command or program to modify a derived object in any way converts it from a DO to a view-private file.
    - Working with DO versions
      Learn how to create DO versions and check in DOs during a build.
    - Converting nonshareable DOs to shared DOs
      To convert a nonshareable DO to a shared DO, use the winkin command.
    - Displaying VOB disk space used for derived objects
      The dospace command and the VersionVault Administration Console report VOB disk space used for shared derived objects.
    - Derived objects environment variables
      Learn about the environment variables of the derived objects.
    - Deleting derived objects
      The rmdo command removes the data container and the VOB database object for a derived object.
    - Displaying contents of configuration records
      The catcr command displays the contents of a configuration record.
    - Comparing configuration records
      Because config records provide complete records of how DOs are built, you can use them to determine how two builds differ.
    - Attaching labels or attributes to versions in a CR
      You can attach a label or an attribute to the versions in the CR hierarchy of a derived object.
    - Configuring a view to select versions used to build a DO
      To select the versions in the CR hierarchy of a derived object, use the -config version selector in the config spec of your view.
    - Including a makefile version in a configuration record
      Learn how to include makefile version in a configuration record.
  - clearmake makefiles and BOS files
    The HCL VersionVault build program, clearmake, can process makefiles.
  - Using clearmake compatibility modes
    clearmake is designed for compatibility with existing make programs, which minimizes the changes you need to make to your makefiles.
  - Using HCL VersionVault to build C++ programs
    Understand the guidelines and instructions to use the VersionVault build utilities, omake and clearmake, in C++ development environments such as Microsoft Visual C++. You will learn how the makefile fragment works and also present alternate possibilities for working around the problems.
  - Using HCL VersionVault build tools with Java
    The build behavior of Java tools causes various problems for clearmake and omake. Understand the problems and some possible solutions to resolve them.
  - Setting up a parallel build
    Learn the process to set up and run parallel builds.

Listing the kind of a derived object

Learn how to list the kind of a derived object.

To display the kind of a derived object, use the cleartool commands ls -l, lsprivate -l -do, or describe -fmt "%[DO_kind]p". The kind can be one of the following values:

nonshareable: The DO was created during an express build and cannot be winked in by other views.
unshared: The DO was created during a regular build. Its data container is located in view storage, not in the VOB.
promoted: The data container of the DO has been promoted to the VOB by a winkin or view_scrubber -p command. The DO is referenced by only one view.
shared: The data container of the DO has been promoted to the VOB by a HCL VersionVault build tool or a manual winkin or view_scrubber -p command.

List, in long form, a particular DO.

cleartool ls -l util 
derived object (non-shareable)  util@@01-Sep.10:54.2147483681

To list all DOs created in the current view in the \dev VOB, including the DO kind:

cleartool lsprivate -long -invob \dev -do 
derived object (unshared)  \dev\file2.txt@@02-Jul.13:51.124
derived object (unshared)  \dev\file2sub.txt@@02-Jul.13:51.123

To list the name and kind of all DOs created in the current view:

cleartool lsprivate -long -do 
derived object (shared)  \dev\file2.txt@@02-Jul.13:51.124
derived object (unshared)  \dev\file2sub.txt@@02-Jul.13:51.123
derived object (unshared)  \dev\dir1\x.obj@@01-Jul.14:23.186
derived object (unshared)  \dev\api\bin\adm.exe@@04-Jul.04:01.776