Displaying the history of checkouts on Linux and UNIX

To display a history of checkouts on Linux and UNIX, you use the cleartool lshistory command. Also, you must be in a VOB directory.

Here are some examples of the lshistory command formats you might find useful.

  • cleartool lshistory -long -me

    When including the -long option in the command, HCL VersionVault includes the name of the view.

    With the -me option, HCL VersionVault lists only those elements on which you have worked.

  • cleartool lshistory -cview -user username

    The -cview option narrows the listing to elements in the current view.

    The -user option lets you specify the username of a team member who has worked on elements in the current view.

Try it!

  1. Navigate to the directory /var/tmp/your-username_tut_elements_vob
  2. Type the command: cleartool lshistory author.txt
  3. Type the command: cleartool history.
  4. Observe how the system response is different when you do not specify a filename.
  5. Optional. Review the lshistory reference page to learn about the other command options.