IBM Support

Recursive checkout or checkin using Windows Explorer

Question & Answer


Question

Is there a procedure that can be used to perform an IBM® Rational® ClearCase® checkout or checkin operation recursively on Microsoft® Windows® using the Explorer integration?

Answer

While there is no ClearCase specific functionality to perform a recursive checkout or checkin operation (due to performance issues), you can take advantage of built in Windows functionality to achieve the same purpose by performing the steps below.

Note: For information about performing recursive checkouts or checkins from the command line and on Unix and Linux, refer to technote 1122520 Recursively checkout and checkin elements.


Things to consider before following the steps below:
  • This method for performing a checkin or checkout may be slower than using an equivalent command line interface procedure discussed in technote 1122520.
  • Be aware that recursively checking out or checking in files can cause performance degradation, especially when the total amount of the files checkedout/in exceed 2GB.
  • It is recommended that if performance is degraded due to this recursive operation that either the operation be changed (say to checkout/checkin in smaller chunks) or to stop the operation all together.
  • Attempting to checkout/checkin a large number of files (hundreds) may cause Windows Explorer to terminate with a Runtime Error



Steps to perform a recursive checkin/checkout using Windows Explorer


In Windows XP Explorer, navigate to the directory where you want to checkout the file.
  1. Right-click on the directory

  2. Click Search to open the Windows Search GUI.

  3. Type *.* in the All or part of the file name field.



  4. Click on More advanced options and unselect Search system folders

    Note: Make sure Search subfolders is selected.



  5. Click Search to produce a list of the files from that directory and all subdirectories

  6. Select any or all files in the list, right-click on any file that you selected and click ClearCase > Checkout (or Checkin)




  7. Be sure to click Apply to All




Refer to the ClearCase: The ten best scripts article under the Scripts to recursively checkin / checkout / add to source control section for a script option.

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"GUI: Windows Explorer (Integration)","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.0.1;7.0;2003.06.00","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"GUI: Windows Explorer (Integration)","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21125301