Home

CodeWarrior™ Development Tools mwClearCase Plug

Contents

1. 2 Open the Code Warrior project whose project file you want to add to ClearCase The Code Warrior IDE displays the project window for this project 3 Select VCS gt Project gt Add The Comment dialog box appears Figure 3 7 on page 27 shows this dialog box 4 Optionally type a comment in the Comment dialog box 5 Click OK The Comment dialog box closes The plug in adds the project file and comment if any to ClearCase and changes the projects check out status icon to X This icon is in the lower left corner of the project window Adding Files and Projects Recursively To add files and projects to ClearCase recursively follow these steps 1 Run the Code Warrior IDE 2 Select VCS gt Recursive gt Add NOTE You do not have to open a project before issuing the recursive Add command because this form of the command does not affect a specific project Instead the command affects all subdirectories and files in the plug in s view 3 The Comment dialog box appears Figure 3 7 on page 27 shows this dialog box MWCC 28 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference 4 Optionally enter a comment in the Comment dialog box 5 Click OK The Comment dialog box closes The plug in adds all files and projects in its ClearCase view to ClearCase Add You can apply the Add command to a file to a project or recursively If applied to a file the Add co
2. Figure 3 4 The Project Window s Context Menu EA loas 0 Prob01 Release B Y A E r Files Link Order Targets Fie Code Data lee ED ProbO java 814 De Ras E 3490 N a a f a M UDPServerjay Open in Windows Explorer X MA Temp java a xl MA Temp_ReadOr Check Syntax zi Ej E 5 files Compile Z MN Compile If Dirty Disassemble Add Files Create Group Remove Get o ae ClearCase Commands Checkin Difference The Editor Window s VCS Menu If the mwClearCase plug in is active for a project the editor window toolbar includes a VCS menu for each project file you open An editor window s VCS menu is identified by one of the checkout status icons The particular icon displayed corresponds to the check out status of the file open in the editor window Figure 3 2 on page 21 explains how to interpret each check out status icon Figure 3 5 shows a CodeWarrior editor window If you click the check out status icon a dropdown menu displays This menu contains ClearCase commands Unlike the IDE s VCS menu the editor s VCS menu contains just those ClearCase commands that are pertinent based on the check out status of the open file For example because the file in Figure 3 5 is checked out the dropdown menu contains just the Get Undo Checkout Connect and Difference commands This is because these are the only commands you can apply to a file that is checked out mwClear
3. The plug in checks out the selected file and changes its check out status icon to Checking out a Project To check out a project follow these steps 1 Open the project that you want to check out The Code Warrior IDE displays the project window for this project mwClearCase Plug in User Guide MWCC 35 Using the mwClearCase Plug in mwClearCase Plug in Command Reference 2 Select VCS gt Project gt Checkout The plug in checks out the project that is the project s mcp file and changes the project s check out status icon to 4 This icon appears in the lower left corner of the project window Checking out Files and Projects Recursively To check out files and projects recursively follow these steps 1 Run the Code Warrior IDE 2 Select VCS gt Recursive gt Checkout NOTE You do not have to open a project before issuing the recursive Checkout command because this form the command does not affect a specific project Instead the command affects all files and projects in the plug in s view 3 Click OK The plug in checks out all files and projects in its ClearCase view Connect Although a Connect command appears in the IDE s VCS menu you do not ever have have to issue it This is because the plug in automatically connects to the ClearCase view specified in its configuration when necessary Difference You can apply the Dif ference command to a single file only You cannot apply it to multip
4. yes Window Help a is os Bot x Be 8 Synchronize Status Synchronize Selection 9 Probl Release Es Recursive Checkout a Undo Checkout Files Link Order Targets pee Checkin Gheckout Y D Undo Checkout MA Prob01 java 814 Checkin Status E TCPServer java 2438 O Properties M UDPServer java 2184 History AB Temp java 329 Status Add MA Temp_ReadOnly java 345 Properties AUN A 5 files 5K Difference Add Add Disconnect About Variables The Project Window s Context Menu To display a project window s context menu right click the mouse while its cursor is within the project window Figure 3 4 shows a project window context menu If the project window is for a project for which you have activated the mwClearCase plug in the project window context menu includes ClearCase commands at the bottom Unlike the VCS menu the context menu contains just a subset of the ClearCase commands the plug in supports Further the particular commands included vary depending upon the check out status of the project file that is currently selected For example because the file selected in Figure 3 4 is checked out the context menu contains just the Get Undo Checkout Checkin and Difference commands This is because only these commands are pertinent for a file that is checked out MWCC 22 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Locations
5. MWCC 24 mwClearCase Plug in User Guide e Miscellaneous Commands Using the mwClearCase Plug in mwClearCase Plug in Command Reference Miscellaneous commands are not ClearCase commands The plug in s miscellaneous commands perform a variety of actions See the reference entry for each miscellaneous command for an explanation of the purpose and effect of each of the commands in this category Table 3 1 lists the commands the plug in supports along with the location and type of each command Table 3 1 Commands Supported by the mwClearCase Plug in Command Command Location s Command Type s About VCS Menu e Miscellaneous Add VCS Menu e File Project Window Context Menu e Project Editor Window Menu e Recursive Add VCS Menu e File Editor Window Menu e Project e Recursive Checkin VCS Menu e File Project Window Context Menu e Project Editor Window Menu e Recursive Checkout VCS Menu e File Project Window Context Menu e Project Editor Window Menu e Recursive Connect VCS Menu e Miscellaneous Difference VCS Menu File e Project Window Context Menu Editor Window Menu Disconnect VCS Menu e Miscellaneous Get VCS Menu e File e Project Window Context Menu e Project Editor Window Menu e Recursive History VCS Menu e File e Project Properties VCS Menu e File e Project Subtree Add VCS Menu e Recursive Subtree Add VCS Menu e Recursive mwClearCase Plug
6. to be added to ClearCase Source file added to ClearCase using the mwClearCase plug in I Use For All Remaining Files Cancel 5 Optionally type a comment in the Comment dialog box MWCC 44 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference 6 Click OK The Comment dialog box closes The ClearCase Add File dialog box displays Figure 3 17 shows this dialog box Figure 3 17 The ClearCase Add File Dialog Box ClearCase Add File a x m File Type ClearCase Autodetect v c ancel Store only the latest copy of the file no deltas Keep checked out 7 Use the ClearCase Add File dialog box to select the ClearCase file addition options you want 8 Click OK The ClearCase Add File dialog box closes The plug in adds each file project file and subdirectory of the selected subtree to the plug in s ClearCase view Subtree Checkin The Subtree Checkin command is a recursive command You can apply it to any subdirectory of the plug in s ClearCase view You cannot apply the command to an individual file or to a project The Subtree Checkin command first lets you select a subdirectory of the plug in s ClearCase view Next the command recurses into each subdirectory of the selected root directory and checks in each file and project currently checked out To check in a subtree of the plug in s ClearCase view follow these steps 1 Ru
7. OK The ClearCase Add File dialog box closes The plug in adds the project file and comment if any to ClearCase and changes the project s check out status icon to X This icon is in the lower left corner of the project window Adding Files and Projects using the Recursive Add Command To add files and projects to ClearCase using the recursive Add command follow these steps 1 2 Run the Code Warrior IDE Select VCS gt Recursive gt Add NOTE You do not have to open a project before issuing the recursive Add command because this form of the command does not affect a specific project Instead it affects all subdirectories and files in the plug in s view mwClearCase Plug in User Guide MWCC 31 Using the mwClearCase Plug in mwClearCase Plug in Command Reference The Comment dialog box appears Figure 3 7 on page 27 shows this dialog box Optionally enter a comment in the Comment dialog box Click OK The Comment dialog box closes The ClearCase Add File dialog box displays Figure 3 9 on page 30 shows this dialog box Use the ClearCase Add File dialog box to select the ClearCase file addition options you want Click OK The ClearCase Add File dialog box closes The plug in adds all files and projects in its ClearCase view to ClearCase Checkin MWCC 32 You can apply the Checkin command to a file to a project or recursively If applied to a file the Checkin command checks in the
8. YourTempDir is a placeholder for the directory to which you extracted the mwClearCase plug in zip file and CodeWarriorInstallDir isa placeholder for the directory in which you installed your CodeWarrior product 6 Copy the file mwClearCase_Release_Notes_win32i txt from the directory YourTempDir to the directory CodeWarriorInstallDir Release Notes Version Control Notes 7 Copy the file ClearCase_UG chm from the directory YourTempDir Documentation to the directory CodeWarriorInstallDir CodeWarrior Manuals HTML 8 Copy the file ClearCase_UG pdf from the directory YourTempDir to the directory CodeWarriorInstallDir CodeWarrior Manuals PDF 9 Delete the temporary directory mwClearCase Plug in User Guide MWCC 9 Setting Up the mwClearCase Plug in Activating the mwClearCase Plug in The mwClearCase plug in is now installed NOTE Read the release notes before using the mwClearCase plug in The name of the release notes file is mwClearCase_Release_Notes_win32i txt Activating the mwClearCase Plug in Before you can use the mwClearCase plug in you must first activate and configure it To do this you must make entries in the VCS Setup settings panel Figure 2 1 shows the VCS Setup settings panel Table 2 1 lists each component in this panel and explains the purpose of each These procedures explain how to activate and configure the mwClearCase plug in e Creating a Default mwClearCase Plug
9. changes made to the selected file into ClearCase If applied to a project the Checkin command checks the changes made to the project file that is to the mcp file into ClearCase If applied recursively the Checkin command checks in each file and project in each subdirectory of the plug in s ClearCase view that is currently checked out Checking in a File To check in a file follow these steps 1 Open the project that contains the file you want to check in The CodeWarrior IDE displays the project window for this project In the project window click the name of the file you want to check in The IDE highlights this file name mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference TIP To check in several files at once highlight the name of each file and then issue the Checkin command 3 Select VCS gt Checkin 4 The Comment dialog box appears Figure 3 10 shows this dialog box Figure 3 10 The Comment Dialog Box I x Please enter a comment for the file s to be checked into ClearCase TCP Server now runs in its own thread J Use For All Remaining Files Cancel 5 Optionally enter a comment in the Comment dialog box 6 Click OK The Comment dialog box closes The plug in checks in the selected file and changes its check out status icon to X NOTE Ifyou try to check in a file that has not changed the check in fails In this case apply t
10. in Configuration e Creating a Project specific mwClearCase Plug in Configuration Figure 2 1 The VCS Setup Settings Panel of the VCS Settings Window YES Setup Use Version Control Method Muy ClearCase y V Use global settings as default m Login Settings MV Connect on open I Always show login dialog Username Password Y Remember password m Database Path M view_java J Try to mount shared volume Local Path M Awiew_java Choose MWCC 10 mwClearCase Plug in User Guide Setting Up the mwClearCase Plug in Activating the mwClearCase Plug in Table 2 1 VCS Setup Settings Panel Components Panel Component Use Version Control Description Check to instruct the IDE to use a version control system plug in dropdown menu check box Clear to stop the IDE from using a version control system plug in NOTE If you are overriding the default plug in configuration this item s label is Use custom project not Use Version Control Method Choose the version control system to activate To activate the mwClearCase plug in choose MW ClearCase Use global settings as default check box Check to create the default mwClearCase plug in configuration Clear to deactivate the default plug in configuration NOTE This check box is present only if there were no projects open when you displayed the VCS Settings window Login Settings gro
11. in User Guide MWCC 25 Using the mwClearCase Plug in mwClearCase Plug in Command Reference Table 3 1 Commands Supported by the mwClearCase Plug in Command Command Location s Command Type s Subtree Checkin e VCS Menu e Recursive Subtree Checkout VCS Menu e Recursive Subtree Get VCS Menu e Recursive Status VCS Menu e File e Project Synchronize Selection VCS Menu e Miscellaneous Synchronize Status VCS Menu e Miscellaneous Undo Checkout VCS Menu e File e Project Window Context Menu e Project Editor Window Menu Variables VCS Menu e Miscellaneous About The About command displays the mwClearCase plug in s About box The About box displays the version number of the plug in along with other identification information To issue the About command select VCS gt About An About box like that shown in Figure 3 6 displays NOTE The About command is available in just the IDE s VCS menu Figure 3 6 About Box for the mwClearCase Plug in Metrowerks SCC IDE YCS Plug in X Name Metrowerks SCC IDE YCS plug in Version 1 0 1a1 Built Feb 22 2001 10 25 36 SCC DLL Provider ClearCase SCC DLL Version 1 1 MWCC 26 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference Add You can apply the Add command to a file to a project or recursively If applied to a file the Add command adds the s
12. name 4 Select VCS gt Properties The plug in displays the file s properties in the ClearCase Properties dialog box Figure 3 22 shows this dialog box Figure 3 22 The ClearCase Properties Dialog Box M view_java vob_adyv_java Prob01 Prob01 jaya Properties aiki Ied General Labels Custom PA Name M wiew_java yvob_ady_java Prob01 Prob01 jav Kind version Created by wwalker Domain Users Created on Monday 10 14 02 14 34 33 Description Cancel Apply Help NOTE Refer to the ClearCase documentation for instructions that explain how to use the ClearCase Properties Dialog Box MWCC 50 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference Displaying the Properties of a Project To display a project s properties follow these steps 1 Run the Code Warrior IDE 2 Open the project whose properties you want to display The Code Warrior IDE displays the project window for this project 3 Select VCS gt Project gt Properties The plug in displays the project s properties that is the properties of the projects mcp file in the ClearCase Properties dialog box Figure 3 22 on page 50 shows this dialog box NOTE Refer to the ClearCase documentation for instructions that explain how to use the ClearCase Properties Dialog Box Status You can apply the Status command to a file or to a project You cannot apply it recursively he Statu
13. out a Project 5 Select VCS gt Checkout The plug in does these things a Copies the latest version of the selected file into its ClearCase view b Makes the file writable and marks it checked out c Changes the file s check out status icon to The selected file is checked out You can now use the Code Warrior editor to change the file Checking out a Project To check out a project that is a project s mcp file follow these steps 1 Run the Code Warrior IDE 2 Open the project that you want to check out The IDE displays the project window for this project 3 Select VCS gt Project gt Checkout The plug in does these things a Copies the latest version of the project s mcp file into its ClearCase view b Makes the mcp file writable and marks it checked out c Changes the project s check out status icon to 4 This icon is in the lower left corner of the project window The project is checked out You can now change the project s configuration as necessary Checking in a File Once you finish changing a file that you have checked out you can check it back in To check a file into ClearCase follow these steps 1 Run the Code Warrior IDE mwClearCase Plug in User Guide MWCC 61 Tutorial Checking in a File 2 Open the Code Warrior project that contains the file you want to check in The IDE displays the project window of the selected project 3 In the project window click
14. the name of the file you want to check in The project window highlights this file name 4 Select VCS gt Checkin The plug in displays the Comment dialog box Figure 4 3 shows this dialog box Figure 4 3 The Comment Dialog Box I x Please enter a comment for the file s to be checked into ClearCase Called sleep at top of run method M Use For All Remaining Files Cancel 5 Optionally enter a check in comment 6 Click OK The plug in instructs ClearCase to do these things a Create a new version of the file being checked in b Mark the file not checked out The plug in then changes the file s check out status icon to X NOTE Ifyou check out a file do not change it and then check it back in the Check in command fails Use the Undo Checkout command in this case MWCC 62 mwClearCase Plug in User Guide Tutorial Checking in a Project Checking in a Project Once you finish changing a project s configuration you can check it back in To check a project into ClearCase follow these steps 1 2 Run the Code Warrior IDE Open the Code Warrior project that you want to check in The IDE displays the project window of the selected project Select VCS gt Project gt Checkin The plug in displays the Comment dialog box Figure 4 3 on page 62 shows this dialog box Optionally enter a checkin comment Click OK The plug in instructs ClearCase to do these things a Create a n
15. Case Plug in User Guide MWCC 23 Using the mwClearCase Plug in mwClearCase Plug in Command Reference Figure 3 5 The Editor Window s Menu of ClearCase Commands b M z F Path C view_java_snap vob_ady_java Prob01 TCPServer java lt gt 0 ctor Get a public TCPSer t a ff save ar Checkin command line display EE the console window keyl_ ar l System out println Xey value is keyl_ end ctor f inherited from Thread Defines what thread does public void runf Line 27 Col 23 1 mwClearCase Plug in Command Reference This section explains the purpose and effect of each command supported by the mwClearCase plug in The plug in supports four categories of ClearCase commands e File Commands File commands are ClearCase commands that the plug in applies to the selected file s in the selected project You can issue file commands from the IDE s VCS menu from a project s context menu and from an editor window s VCS menu e Project Commands File commands are ClearCase commands that the plug in applies to the selected project You can issue project commands from just the Project submenu of the IDE s VCS menu e Recursive Commands Recursive commands are ClearCase commands that the plug in applies to each subdirectory and file contained in the plug in s view directory You can issue recursive commands from just the Recursive submenu of the IDE s VCS menu
16. CodeWarrior Development Tools mwClearCase Plug in User Guide metrowerks Software Starts Here 4 Metrowerks the Metrowerks logo and Code Warrior are registered trademarks of Metrowerks Corp in the US and or other countries All other tradenames and trademarks are the property of their respective owners Copyright O Metrowerks Corporation 2002 ALL RIGHTS RESERVED The reproduction and use of this document and related materials are governed by a license agreement media it may be printed for non commercial personal use only in accordance with the license agreement related to the product associated with the documentation Consult that license agreement before use or reproduction of any portion of this document If you do not have a copy of the license agreement contact your Metrowerks representative or call 800 377 5416 if outside the US call 1 512 997 4700 Subject to the foregoing non commercial personal use no portion of this documentation may be reproduced or transmitted in any form or by any means electronic or mechanical without prior written permission from Metrowerks Metrowerks reserves the right to make changes to any product described or referred to in this doc ument without further notice Metrowerks makes no warranty representation or guarantee regard ing the merchantability or fitness of its products for any particular purpose nor does Metrowerks assume any liability arising out of the application or use of any p
17. E You do not have to open a project before issuing the Subtree Add command because this command does not affect a specific project Instead it affects the selected subtree of the plug in s ClearCase view 3 Use the Please Select and Access Path dialog box to select a subtree of the plug in s ClearCase view to use as the starting point of a recursive add 4 Click OK The Please Select and Access Path dialog box closes The Comment dialog box appears Figure 3 14 shows this dialog box Figure 3 14 The Comment Dialog Box I x Please enter a comment for the file s to be added to ClearCase por file added to ClearCase using the mwClearCase plug in M Use For All Remaining Files Cancel 5 Optionally type a comment in the Comment dialog box MWCC 42 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference 6 Click OK The Comment dialog box closes The plug in adds each file project file and subdirectory in the selected subtree to the plug in s ClearCase view Subtree Add The Subtree Add command is a recursive command You can apply it to any subdirectory of the plug in s ClearCase view You cannot apply the command to an individual file or to a project The Subtree Add command first lets you select a subdirectory of the plug in s ClearCase view Next the command recurses into each subdirectory of the selected root directory and adds each file pr
18. File has not been checked out of ClearCase File is read only File is writable X A File has not been checked out of ClearCase f File has been checked out of ClearCase File is writable mwClearCase Plug in Command Locations The mwClearCase plug in lets you apply common ClearCase commands to a CodeWarrior project and to the files that belong to a project To use the plug in however you must know where to find these commands The mwClearCase plug in makes ClearCase commands available in these places The IDE s VCS Menu The Project Window s Context Menu The Editor Window s VCS Menu The IDE s VCS Menu The VCS menu is in the CodeWarrior IDE s menu bar The VCS menu is present in the menu bar if at least one of these conditions is met e You created the default plug in configuration e You assigned a plug in configuration to a project and this project is both open and selected The VCS menu includes every mwClearCase command supported by the plug in Other menus discussed below include just a subset of the supported ClearCase commands mwClearCase Plug in User Guide MWCC 21 Using the mwClearCase Plug in mwClearCase Plug in Command Locations Individual items in the VCS menu are enabled or disabled depending upon the check out status of the current project or currently selected project file Figure 3 3 The VCS Menu Metrowerks CodeWarrior REEF File Edit View Search Project Debug
19. Path dialog box automatically 9 Specify the local path to make the default local path To do this follow these steps a Click the Choose button in the Local Path group box The Select an Access Path dialog box displays b Use this dialog box to select the same ClearCase view chosen in step 9 c Click OK The selected path appears in the read only field to the left of the Choose button d Click OK The selected path appears in the read only text field to the left of the Choose button 10 Click OK The VCS Settings window closes The IDE activates the mwClearCase plug in for the open project MWCC 16 mwClearCase Plug in User Guide Setting Up the mwClearCase Plug in Deactivating the mwClearCase Plug in NOTE The VCS menu appears in the IDE s menu bar when you select a project for which the plug in has been activated This menu disappears when you select a project for which the plug in has not been activated 3 Refer to Using the mwClearCase Plug in on page 19 for instructions that explain how to use each feature of the mwClearCase plug in Deactivating the mwClearCase Plug in To deactivate the mwClearCase plug in follow these steps 1 Run the Code Warrior IDE 2 If you are deactivating the default plug in configuration close all projects If you are deactivating the plug in configuration for a specific Code Warrior project open that project 3 Choose Edit gt Version Control Settings The VCS
20. Settings window appears 4 Display the VCS Setup settings panel in the VCS Settings window To do this select the item labeled VCS Setup This item is in the pane labeled VCS Settings Panels This pane is on the left side of the VCS Settings window Figure 2 1 on page 10 shows the VCS Settings window with the VCS Setup panel displayed 5 Select the item labeled None from the Method dropdown menu 6 If you are deactivating the default plug in configuration clear the box labeled Use global settings as default NOTE The VCS Setup panel includes the Use global settings as default check box only if the IDE has no projects open The VCS Setup panel does not include this check box if the IDE has one or more projects open 7 Clear the Use Version Control check box The IDE disables the rest of the items in the VCS Setup panel mwClearCase Plug in User Guide MWCC 17 Setting Up the mwClearCase Plug in Deactivating the mwClearCase Plug in NOTE Ifthe default plug in configuration exists this check box is labeled Use custom project instead of Use Version Control 8 Click OK The VCS Settings window closes The IDE deactivates the plug in and removes the VCS menu from its menu bar NOTE Tf no projects were open when you clicked OK the IDE deactivates the default plug in configuration If a project was open the IDE deactivates the plug in for just this project MWCC 18 mwClearCase Plug in User Guide Using the mwClearCase Plug
21. ach subdirectory of the selected root directory and checks in each file project file and subdirectory that is checked out NOTE The Subtree Checkin command fails for each checked out file that has not been changed For such files use the Undo Checkout command Subtree Checkout The Subtree Checkout command is a recursive command You can apply it to any subdirectory of the plug in s ClearCase view You cannot apply the command to an individual file or to a project The Subtree Checkout command first lets you select a subdirectory of the plug in s ClearCase view Next the command recurses into each subdirectory of the selected root directory and checks out each file project and subdirectory that is not already checked out To check out a subtree of the plug in s ClearCase view follow these steps 1 Run the CodeWarrior IDE 2 Select VCS gt Recursive gt Subtree Checkout The plug in displays the Please Select an Access Path dialog box Figure 3 20 shows this dialog box NOTE You do not have to open a project before issuing the Subtree Checkout command because this command does not affect a specific project Instead it affects the selected subtree of the plug in s ClearCase view mwClearCase Plug in User Guide MWCC 47 Using the mwClearCase Plug in mwClearCase Plug in Command Reference Figure 3 20 The Please Select an Access Path Dialog Box Please Select an Access Path 2 xi Path Type absolute Pa
22. are e Creating a Default mwClearCase Plug in Configuration e Creating a Project specific mwClearCase Plug in Configuration Creating a Default mwClearCase Plug in Configuration The Code Warrior IDE attempts to use the default mwClearCase plug in configuration for each project that does not have a custom configuration MWCC 12 mwClearCase Plug in User Guide Setting Up the mwClearCase Plug in Activating the mwClearCase Plug in NOTE You do not have to create the default mwClearCase plug in configuration Instead you can create a custom plug in configuration for each of your projects The default plug in configuration is just a convenience To create the default mwClearCase plug in configuration follow these steps 1 2 Run the Code Warrior IDE Close any open projects Choose Edit gt Version Control Settings The VCS Settings window appears Display the VCS Setup settings panel in the VCS Settings window To do this select the item labeled VCS Setup This item is in the pane labeled VCS Settings Panels This pane is on the left side of the VCS Settings window Figure 2 1 on page 10 shows the VCS Setup panel Check the Use Version Control check box The IDE enables the Method dropdown menu and the Use global settings as default check box Select the item labeled Mw ClearCase from the Method dropdown menu The IDE enables the rest of the items in the VCS Setup panel Check Use global settings as def
23. ase History Browser C view_java_snap vob_adyv_java Prob01 UDP File Edit view Tools Help Kelile AS ew sl eE Use Name Event Kind Version Comment 10 13 02 15 22 36 wwalker AUDPServerjava create version main 8 Added another test comment 10 11 02 16 00 20 wwalker UDPServerjava create version mains Added another test comment 10 11 02 15 54 00 wwalker UDPServerjava create version main6 Added a test comment 10 11 02 14 25 15 wwalker UDPServerjayva create version Aimaini5 Added comment block to top of file 10 11 02 10 34 15 wwalker AUDPServer java create version main 4 Changed port number to 80 10 11 02 10 32 03 wwalker SUDPServer java maina Added even more comments to improve 10 11 02 10 29 15 wwalker AUDPServerjava create version mains2 Added comments to improve readability 10 07 02 16 17 23 wwalker AUDPServerjava create version main 1 Initial checkin 10 07 02 16 17 23 wwalker AUDPServerjava create version main 0 10 07 02 16 17 23 wwalker AUDPServerjava create branch main 10 07 02 16 17 23 wwalker UDPServerjava create file element Initial checkin create version Comment Labels ttributes Added even more comments to a a improve readability even more v Y y Ready 100 Events 11 YA MWCC 40 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference Displaying the Revision History of a Project To display the revision history of a pro
24. ault check box This setting makes the current plug in configuration the default configuration The IDE attempts to apply this configuration to all CodeWarrior projects that do not have a custom plug in configuration NOTE Because no CodeWarrior project is open the VCS Settings panel includes the Use global settings as default check box If a project is open the VCS Setting panel does not include this check box mwClearCase Plug in User Guide MWCC 13 Setting Up the mwClearCase Plug in Activating the mwClearCase Plug in 8 Specify the path to the ClearCase view to make the default view To do this follow these steps a Click the Choose button in the Database Path group box The Select an Access Path dialog box appears Use this dialog box to navigate to the directory that contains the ClearCase view that you want to make the default view Click OK The selected path appears in the read only field to the left of the Choose button NOTE Ifyou are using a dynamic view you must start the view before its directory appears in the Select an Access Path dialog box See the ClearCase documentation for instructions that explain how to start a dynamic view If you are using a snapshot view its directory appears in the Select an Access Path dialog box automatically 9 Specify the local path to make the default local path To do this follow these steps a Click the Choose button in the Local Path group box T
25. cket udpsocket_ private Datagramsocket udpSocket_ private String key1_ private string keyl_ private String key3_ private string key3_ private static final int PORT_ZNUM 7 7 is static final int PORT_ZNUM 80 4 ctor public UDPServer String argument public UDPServer String argument f f save argument passed on command lir f f save argument passed on comme keyl_ argument keyl_ argument end ctor gt end ctor Pall gt import java net import java io Difference 1 of 1 Line 1 of 70 num Disconnect Although a Disconnect command appears in the IDE s VCS menu you do not ever have to issue it This is because the plug in automatically disconnects from the ClearCase view specified in its configuration when necessary mwClearCase Plug in User Guide MWCC 37 Using the mwClearCase Plug in mwClearCase Plug in Command Reference Get You can apply the Get command to a file to a project or recursively If applied to a file the Get command copies the latest version of the file from ClearCase into the plug in s ClearCase view If applied to a project the Get command copies the latest version of the project file that is of the mcp file from ClearCase into the plug in s ClearCase view If applied to recursively the Get command copies the latest version of each file and project from ClearCase into the plug in s ClearCase view Getting a File To get the latest vers
26. command locations 21 24 editor window 23 project window context menu 22 VCS menu 21 command reference 24 55 commands about 26 add 27 add 29 checkin 32 checkout 35 connect 36 difference 36 disconnect 37 get 38 history 39 properties 49 status 51 subtree add 41 subtree add 43 subtree checkin 45 subtree checkout 47 subtree get 48 synchronize selection 52 MWCC 66 synchronize status 53 undo checkout 54 variables 55 deactivating 17 18 installing 8 10 obtaining 7 8 overview 5 6 project window check out status icons 20 project window context menu commands 22 setting up 7 18 system requirements 5 tutorial 57 63 checking in a file 61 63 checking in a project 63 checking out a file 60 61 checking out a project 61 default plug in configuration creating 57 60 using 19 55 O obtaining the mwClearCase plug in 7 8 overview of the mwClearCase plug in 5 6 P Password configuration option 11 plug in tutorial 57 63 project specific plug in configuration creating 15 17 project window check out status icons 20 context menu 22 context menu and ClearCase commands 22 project window context menu 22 properties command 49 R Remember password option 11 requirements for using the mwClearCase plug in 5 S setting up the mwClearCase plug in 7 18 settings panels VCS Setup 10 status command 51 subtree add command 41 subtree add command 43 mwClearCase Plug in User Guide subtree checkin command 45 Use global se
27. ct is open the VCS Settings panel does not include the Use global settings as default check box This is because the IDE must assign a plug in configuration to an open project if there is one 6 Check the Use Version Control check box NOTE Ifthe default plug in configuration has been defined this check box is labeled Use custom project instead of Use Version Control In this case the new plug in configuration overrides the default plug in configuration 7 Select the Mw ClearCase item from the Method dropdown menu The IDE enables the rest of the items in the VCS Setup panel mwClearCase Plug in User Guide MWCC 15 Setting Up the mwClearCase Plug in Activating the mwClearCase Plug in 8 Specify the path to the ClearCase view that contains the open project and its source files To do this follow these steps a Click the Choose button in the Database Path group box The Select an Access Path dialog box displays b Use this dialog box to navigate to the directory that holds the ClearCase view that contains the open project c Click OK The selected path appears in the read only text field to the left of the Choose button NOTE Ifyou are using a dynamic view you must start the view before its directory appears in the Select an Access Path dialog box See the ClearCase documentation for instructions that explain how to start a dynamic view If you are using a snapshot view its directory appears in the Select an Access
28. d projects from within the CodeWarrior IDE e View the ClearCase status of each file in a project and of the project file itself from within the IDE In short the plug in is a time saver because it lets you use ClearCase without leaving the CodeWarrior IDE Without the plug in you must run a separate program to use ClearCase System Requirements To use the mwClearCase plug in your computer operating system and software must meet the requirements listed in Table 1 1 mwClearCase Plug in User Guide MWCC 5 Overview Learning More About mwClearCase Table 1 1 System Requirements for the mwClearCase Plug in Component Requirement Computer IBM compatible PC Processor Pentium class processor Memory 128 MB minimum Operating system Windows 98 Windows ME Windows NT Windows 2000 or Windows XP ClearCase Rational ClearCase for Windows version 3 2 or later CodeWarrior IDE Version 4 0 1 or later Windows hosted version only Learning More About mwClearCase The mwClearCase Plug in User Guide this document explains how to use the features of the plug in It does not cover project configuration management concepts or document the ClearCase product For information of this type refer to the ClearCase documentation MWCC 6 mwClearCase Plug in User Guide Setting Up the mwClearCase Plug in This chapter explains how to obtain install activate configure and deactivate the mwClearCase plug in The c
29. e Path 11 Local Path 12 Login Settings 11 Method 11 Password 11 Remember password 11 Try to mount shared volume 11 Use global settings as default 11 Use Version Control 11 Username 11 connect command 36 Connect on open configuration option 11 creating a project specific plug in configuration 15 17 creating the default plug in configuration 12 15 D Database Path configuration option 11 deactivating the mwClearCase plug in 17 18 default plug in configuration creating 12 15 difference command 36 disconnect command 37 G general ClearCase information 6 get command 38 H history command 39 how to activate the mwClearCase plug in 10 17 check in a file 61 63 check in a project 63 check out a file 60 61 check out a project 61 create a default plug in configuration 12 15 57 60 create a project specific plug in configuration 15 17 deactivate the mwClearCase plug in 17 18 install the mwClearCase plug in 8 10 MWCC 65 interpret the check out status icons 21 obtain the mwClearCase plug in 7 8 I information about ClearCase 6 installing the mwClearCase plug in 8 10 L learning about ClearCase 6 Local Path configuration option 12 location of commands 21 24 Login Settings configuration option 11 M meaning of check out status icons 21 menu VCS 21 Method configuration option 11 more information about ClearCase 6 mwClearCase plug in about 5 activating 10 17 for a specific project 15 17 globally 12 15
30. e oe ew eo YD Th Project Window ate e 2 eu 4 woe ee we oY mR ew 2 The Project Window and the Plug in 20 mwClearCase Plug in Command Locations 2 2 2 21 The IDE s VCS Menu 6 24 eb ee ew u a es ws 2l The Project Window s ContextMenu 2 2 2 22 The Editor Window s VCS Menu 2 2 2 2 2 2 2 23 mwClearCase Plug in Command Reference 2 2 2 2 24 4 Tutorial 57 Creating a Default Plug in Configuration 57 Checking out a File lt lt 4 5 a a a a A O Checking out a Project 2 a a a a aaa 6L Checking in a File 4 4 a a aaa Gl Checking in a Project lt os a a a a aaa BS Index 65 mwClearCase Plug in User Guide MWCC 3 Table of Contents MWCC 4 mwClearCase Plug in User Guide Overview This chapter provides an overview of the Metrowerks ClearCase plug in for the Code Warrior M integrated development environment IDE This tool is commonly called the mwClearCase plug in This chapter contains these topics e About the mwClearCase Plug in e System Requirements e Learning More About mwClearCase About the mwClearCase Plug in The mwClearCase plug in is a tool that makes working with CodeWarrior projects whose files are managed by the ClearCase software configuration management system more convenient How The mwClearCase plug in lets you e Execute common ClearCase commands on CodeWarrior files an
31. ect you open that does not have a custom plug in configuration mwClearCase Plug in User Guide Tutorial Creating a Default Plug in Configuration 8 Leave the Username field empty 9 Check the Connect on open check box 10 Check Remember password check box The plug in enables the Password field 11 Leave the Password field empty 12 Leave the Always show login dialog check box unchecked 13 Assign a ClearCase view to the default plug in configuration To do this follow these steps a Click the Choose button in the Database Path group box The Select an Access Path dialog box appears b Use this dialog box to select the ClearCase view that you want to use for the rest of this tutorial c Leave the Try to mount shared volume check box unchecked d Click OK The full path to the selected ClearCase view appears in the read only field to the left of the Choose button 14 Assign a local path to the default plug in configuration To do this follow these steps a Click the Choose button in the Local Path group box The Select an Access Path dialog box appears b Use this dialog box to select the same ClearCase view that you selected for Database Path c Click OK The full path to the selected ClearCase view appears in the read only field to the left of the Choose button NOTE You must select the same ClearCase view for Database Path and for Local Path Otherwise the mwClearCase plug in will not work mwC
32. elected file to ClearCase If applied to an open project the Add command adds the project file that is the mcp file to ClearCase If applied recursively the Add command adds all files and projects contained in the plug ins ClearCase view to ClearCase Adding a File To add a file to ClearCase follow these steps 1 Run the CodeWarrior IDE 2 Open the project that contains the file you want to add to ClearCase The CodeWarrior IDE displays the project window for this project 3 In the project window click the name of the file you want to add The IDE highlights this file name TIP To add several files at once highlight the name of each file you want to add and then issue the Add command 4 Select VCS gt Add The Comment dialog box appears Figure 3 7 shows this dialog box Figure 3 7 The Comment Dialog Box Comment x Please enter a comment for the file s to be added to ClearCase Source file added to ClearCase using the mwClearCase plug in Use For All Remaining Files Cancel mwClearCase Plug in User Guide MWCC 27 Using the mwClearCase Plug in mwClearCase Plug in Command Reference 5 Optionally type a comment in the Comment dialog box 6 Click OK The Comment dialog box closes The plug in adds the selected file and comment if any to ClearCase and changes the file s check out status icon to X Adding a Project To add a project to ClearCase follow these steps 1 Run the Code Warrior IDE
33. es and projects in the plug in s ClearCase view 3 Click OK The plug in copies the latest version of each file and project from ClearCase into the plug in s ClearCase view History You can apply the History command to a file or to a project You cannot apply it recursively If applied to a file the History command lists each revision and check in comment made to the file since it was first added to ClearCase If applied to a project the Hist ory command lists each revision and check in comment made to the project s mcp file since it was first added to ClearCase mwClearCase Plug in User Guide MWCC 39 Using the mwClearCase Plug in mwClearCase Plug in Command Reference Displaying the Revision History of a File To display the revision history of a file follow these steps 1 Open the project that contains the file for which you want to obtain a revision history The Code Warrior IDE displays the project window for this project 2 Inthe project window click the name of the file for which to you want to obtain a revision history The IDE highlights this file name TIP To get the revision history of several files highlight the name of each file and then issue the History command 3 Select VCS gt History The plug in displays the file s revision history in the ClearCase History Browser window Figure 3 12 shows this window Figure 3 12 The ClearCase History Browser Window ss Rational ClearC
34. ew version of the project file being checked in b Mark the project file not checked out The plug in then changes the projects s check out status icon to This icon is in the lower left corner of the project window NOTE Ifyou check out a project do not change it and then check it back in the Check in command fails Use the Undo Checkout command in this case mwClearCase Plug in User Guide MWCC 63 Tutorial Checking in a Project MWCC 64 mwClearCase Plug in User Guide Index A about ClearCase 6 the mwClearCase plug in 5 about command 26 activating the mwClearCase plug in 10 17 add command 27 add command 29 Always show login dialog configuration option 11 C check out status icons in a project window 20 interpretation 21 checkin command 32 checkout command 35 ClearCase learning more about 6 command locations 21 24 editor window 23 project window context menu 22 VCS menu 21 commands about 26 add 27 add 29 checkin 32 checkout 35 connect 36 difference 36 disconnect 37 get 38 history 39 project window context menu 22 properties 49 status 51 subtree add 41 subtree add 43 subtree checkin 45 subtree checkout 47 subtree get 48 synchronize selection 52 synchronize status 53 undo checkout 54 mwClearCase Plug in User Guide variables 55 commands supported by the plug in 24 55 configuration options Always show login dialog 11 Connect on open 11 Databas
35. f your Code Warrior projects To create a default plug in configuration follow these steps 1 Run the Code Warrior IDE 2 Close any open projects mwClearCase Plug in User Guide MWCC 57 Tutorial Creating a Default Plug in Configuration 3 Select Edit gt VCS Settings The VCS Settings window appears 4 Display the VCS Setup settings panel To do this select the item labeled VCS Setup This item is in the pane labeled VCS Settings Panels This pane is on the left side of the VCS Settings window Figure 4 1 shows the VCS Setup settings panel Figure 4 1 The VCS Setup Panel of the VCS Settings Window YES Setup M Use Version Control Method Mu ClearCase y V Use global settings as default m Login Settings Usemame Password MV Connect on open V Remember password Always show login dialog m Database Path M Aiew_java Choose I Tiy to mount shared volume Local Path M view_java Choose 5 Check the box labeled Use Version Control The Method dropdown menu and the Use global settings as default check box become active 6 Select the item labeled Mw ClearCase from the Method dropdown menu The IDE activates the rest of the items in the VCS Setup panel 7 Check the box labeled Use global settings as default MWCC 58 This setting makes this plug in configuration the default configuration The IDE uses this configuration for each CodeWarrior proj
36. hapter contains these topics e Obtaining the mwClearCase Plug in Installing the mwClearCase Plug in e Activating the mwClearCase Plug in e Deactivating the mwClearCase Plug in Obtaining the mwClearCase Plug in The Metrowerks ClearCase plug in is free To obtain the latest version of the plug in follow these steps 1 If the CodeWarrior IDE is running exit the program 2 Go to the Metrowerks version control tool download page by clicking the URL below or by typing it into your Internet browser http www metrowerks com MW Develop Desktop VersionControl htm Your Internet browser starts and displays the Metrowerks version control tool download page 3 Inthe Windows section of the download page click the name of the zip file that contains the mwClearCase plug in 4 Use the file download capabilities of your browser to obtain a local copy of the mwClearCase plug in s zip file mwClearCase Plug in User Guide MWCC 7 Setting Up the mwClearCase Plug in Installing the mwClearCase Plug in 5 Quit the Internet browser You now have a local copy of the zip file that contains the latest version of the mwClearCase plug in Installing the mwClearCase Plug in This section explains how to install the mwClearCase plug in NOTE If your Code Warrior product includes the mwClearCase plug in that product s installation program automatically installs the plug in Use the procedure in this section to instal
37. he Select an Access Path dialog box displays Use this dialog box to select the same ClearCase view chosen in step 9 Click OK The selected path appears in the read only field to the left of the Choose button NOTE You must select the same view for Local Path and Database Path discussed above 10 Click OK The VCS Settings window closes The IDE activates the mwClearCase plug in globally and adds the VCS menu to its menu bar MWCC 14 mwClearCase Plug in User Guide Setting Up the mwClearCase Plug in Activating the mwClearCase Plug in Refer to Using the mwClearCase Plug in on page 19 for instructions that explain how to use each feature of the plug in Creating a Project specific mwClearCase Plug in Configuration A project specific plug in configuration is one that applies to just the Code Warrior project that is open and selected when you create the configuration To create a project specific plug in configuration follow these steps 1 Run the Code Warrior IDE 2 Close any open projects 3 Open the Code Warrior project to which you want to assign a custom plug in configuration 4 Choose Edit gt Version Control Settings The VCS Settings window appears 5 Display the VCS Setup settings panel in the VCS Settings window To do this select the item labeled VCS Setup This item is in the pane labeled VCS Settings Panels This pane is on the left side of the VCS Settings window NOTE Because a proje
38. he Undo Checkout command to the file Checking in a Project To check a project into ClearCase follow these steps 1 Run the Code Warrior IDE 2 Open the Code Warrior project whose project file you want to check in The Code Warrior IDE displays the project window for this project 3 Select VCS gt Project gt Checkin The Comment dialog box appears Figure 3 10 on page 33 shows this dialog box mwClearCase Plug in User Guide MWCC 33 Using the mwClearCase Plug in mwClearCase Plug in Command Reference 4 Optionally type a comment in the Comment dialog box 5 Click OK The Comment dialog box closes The plug in checks the project file and comment if any into ClearCase and changes the project s check out status icon to X This icon is in the lower left corner of the project window NOTE Ifyou try to check in a project file that has not changed the check in fails In this case apply the Undo Checkout command to the project file Checking in Files and Projects Recursively To check files and projects into ClearCase recursively follow these steps 1 Run the CodeWarrior IDE 2 Select VCS gt Recursive gt Checkin The Comment dialog box appears Figure 3 10 on page 33 shows this dialog box NOTE You do not have to open a project before issuing the recursive Checkin command because this form of the command does not affect a specific project Instead it affects all files and projects in the plug in s view 3 O
39. he username database path and local path assigned to the mwClearCase plug in To issue the Variables command select VCS gt Variables The Metrowerks ClearCase Variables dialog box displays Figure 3 24 shows this dialog box Figure 3 24 Variables Dialog Box for the mwClearCase Plug in Metrowerks CleareCase Variables a Username wwalker Database Path C view_java_snap Local Path C view_java_snap mwClearCase Plug in User Guide MWCC 55 Using the mwClearCase Plug in mwClearCase Plug in Command Reference MWCC 56 mwClearCase Plug in User Guide Tutorial This chapter consists of a tutorial The tutorial shows you how to e Create a default configuration for the mwClearCase plug in Use the plug in to perform common ClearCase tasks from within the Code Warrior M IDE NOTE To perform the lessons in this tutorial you must have a ClearCase view available Further if you use a dynamic ClearCase view you must start this view before beginning the tutorial The tutorial contains these lessons e Creating a Default Plug in Configuration e Checking out a File e Checking out a Project e Checking in a File e Checking in a Project Creating a Default Plug in Configuration Although you can create a custom plug in configuration for each every Code Warrior project it is often easier to create a default plug in configuration This approach is easier because the default plug in configuration works for all o
40. in This chapter explains how to use the mwClearCase plug in The chapter contains these topics e Preparation The Project Window e mwClearCase Plug in Command Locations e mwClearCase Plug in Command Reference Preparation Before you can use the mwClearCase plug in with a CodeWarrior project you must first create a ClearCase view that contains your project Further if you are using a dynamic ClearCase view you must first start this view you can use the plug in Refer to the ClearCase documentation for instructions that explain how to accomplish these tasks Once you have set up your ClearCase view open a CodeWarrior project in the CodeWarrior IDE If you created the default plug in configuration or assigned a custom configuration to the project you can now use the mwClearCase plug in with this project See Creating a Default mwClearCase Plug in Configuration on page 12 and Creating a Project specific mwClearCase Plug in Configuration on page 15 for instructions that explain how to configure the mwClearCase plug in mwClearCase Plug in User Guide MWCC 19 Using the mwClearCase Plug in The Project Window The Project Window To use the mwClearCase plug in you must understand how the plug in interacts with the project window of a Code Warrior project This is because the project window e Shows you the ClearCase status of each file in the project and of the project itself e Lets you apply ClearCa
41. ion of a file follow these steps 1 Open the project that contains the file for which you want to get the latest version The CodeWarrior IDE displays the project window for this project 2 Inthe project window click the name of the file for which to get the latest version The IDE highlights this file name TIP To get the latest version of several files highlight the name of each file and then issue the Get command 3 Select VCS gt Get The plug in copies the latest version of the selected file into the plug in s ClearCase view Getting a Project To get the latest version of a project follow these steps 1 Open the project for which you want to get the latest version The CodeWarrior IDE displays the project window for this project MWCC 38 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference 2 Select VCS gt Project gt Get The plug in copies the latest version of the project that is of the project s mcp file from ClearCase into the plug in s ClearCase view Getting Files and Projects Recursively To get the latest version of each file and project from the plug in s ClearCase view recursively follow these steps 1 Run the CodeWarrior IDE 2 Select VCS gt Recursive gt Get NOTE You do not have to open a project before issuing the recursive Get command because this form of the command does not affect a specific project Instead it affects all fil
42. is window Synchronize Selection You can apply the Synchronize Selection command to a file or files in a project You cannot apply the command to a project or recursively The command verifies that the check out status icon displayed in the project window for the selected file matches the status of that file in ClearCase If there is a discrepancy the plug in displays the correct check out status icon MWCC 52 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference The mwClearCase plug in can display the wrong check out status icon if you change the check out status of a file outside of the Code Warrior IDE for example by using the Rational ClearCase Explorer program You can use the Synchronize Selection command to rectify this situation To issue the Synchronize Selection command follow these steps 1 Run the Code Warrior IDE 2 Open the project that contains the file for which to synchronize status The Code Warrior IDE displays the project window for this project 3 In the project window click the name of the file for which to synchronize status The IDE highlights this file name NOTE To synchronize the status of several files at once highlight the name of each file and then issue the Synchronize Selection command 4 Select VCS gt Synchronize Selection The plug in verifies that the check out status icon displayed for the selected file is correct If not the plug in d
43. isplays the correct check out status icon Synchronize Status The Synchronize Status command is applied to all files in a project and to the project itself It cannot be applied to an individual file or recursively The command updates the check out status icon of each file in the project and of the project file itself that is of the project s mcp file The mwClearCase plug in can sometimes display incorrect check out status icons For example if you change the check out status of a file or project outside of the CodeWarrior IDE for example by using the Rational ClearCase Explorer program the plug in might display incorrect status icons Use the Synchronize Status command to rectify this situation To issue the Synchronize Status command follow these steps 1 Run the CodeWarrior IDE mwClearCase Plug in User Guide MWCC 53 Using the mwClearCase Plug in mwClearCase Plug in Command Reference 2 Open the project whose status you want to synchronize The Code Warrior IDE displays the project window for this project 3 Select VCS gt Synchronize Status The plug in updates the check out status icon for each file for which it finds a discrepancy Undo Checkout You can apply the Undo Checkout command to a file or project You cannot apply the command recursively If applied to a checked out file the Undo Checkout command changes the ClearCase status of the file to not checked out All changes made to the file are
44. ject follow these steps 1 Open the project for which you want to obtain a revision history The Code Warrior IDE displays the project window for this project 2 Select VCS gt History The plug in displays the revision history of the project s mcp file in the ClearCase History Browser window Figure 3 12 on page 40 shows this window Subtree Add The Subtree Add command is a recursive command You can apply it to any subdirectory of the plug in s ClearCase view You cannot apply the command to an individual file or to a project The Subtree Add command first lets you select a subdirectory of the plug in s ClearCase view Next the command recurses into each subdirectory of the selected root directory and adds each file project and subdirectory not already under source code control to ClearCase To add a subtree of the plug in s ClearCase view to ClearCase follow these steps 1 Run the CodeWarrior IDE 2 Select VCS gt Recursive gt Subtree Add The Please Select an Access Path dialog box displays Figure 3 13 shows this dialog box mwClearCase Plug in User Guide MWCC 41 Using the mwClearCase Plug in mwClearCase Plug in Command Reference Figure 3 13 The Please Select an Access Path Dialog Box Please Select an Access Path 7 ax Path Type absolute Path gt 5 view_java_snap B vob_ady_java Prob01 Ey Probo2 5 Probo3 t AA MM TK 14 pal cns NOT
45. l the mwClearCase plug in once you have downloaded it from the Metrowerks website To install the mwClearCase plug in follow these steps 1 MWCC 8 Using Windows Explorer create a temporary directory on your local hard disk You can name this directory anything you want Using Windows Explorer select the directory that contains the mwClearCase plug in s zip file 3 For instructions that explain how to get this file see Obtaining the mwClearCase Plug in on page 7 Double click the name of the plug in s zip file WinZip or another archive decompression program runs and displays the contents of the zip file Extract the contents of the zip file to the temporary directory created earlier The decompression program creates these files in the temporary directory mwClearCase_UG chm mwClearCase_UG pdf e mwClearCase_Release_Notes_ win321 txt e VCSClearCase dll mwClearCase Plug in User Guide Setting Up the mwClearCase Plug in Installing the mwClearCase Plug in NOTE At the time of this writing the installation steps that follow were correct That said before executing these steps please check the release notes for changes to the installation procedure The name of the release notes file is mwClearCase_Release_Notes_win32i txt 5 Copy the file vcSClearCase dll from the directory YourTempDir to the directory CodeWarriorInstallDir Bin Plugins version control where
46. le files to a project or recursively The Difference command displays the differences between the copy of the selected file in the plug in s ClearCase view and the latest version of this file in ClearCase MWCC 36 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference To use the Difference command follow these steps 1 Open the project that contains the file to which you want to apply the Difference command The Code Warrior IDE displays the project window for this project In the project window click the name of the file to which to apply the Difference command The IDE highlights this file name Select VCS gt Difference The plug in compares the local copy of the selected file to the latest version of this file in ClearCase The plug in then displays the results in the ClearCase Diff Merge window Figure 3 11 shows the ClearCase Diff Merge window Refer to the ClearCase documentation for instructions that explain how to use this window Figure 3 11 The ClearCase Diff Merge Window B Comparing C view_java_snap vob_adw_java Prob01UDPServer javyad0 main 3 Diff Merge File Edit Yiew Navigate Tools Help Ready 4 BRO Fla NAM AAA AS import java net import java 10 class UDPServer extends Thread class UDPServer extends Thread private DatagramPacket txPacket_ rxPacket_ private DatagramPacket txPacket_ rxPack private Datagramso
47. learCase Plug in User Guide MWCC 59 Tutorial Checking out a File 15 Click OK The VCS Settings window closes The IDE activates the mwClearCase plug in globally and adds the VCS menu to the IDE s menu bar You have finished creating the default mwClearCase plug in configuration Checking out a File Now that you have created a default plug in configuration you can use the plug in to check out files from a Code Warrior project while within the IDE To check out a file follow these steps 1 Run the Code Warrior IDE 2 Open one of the Code Warrior projects in the ClearCase view selected in the last lesson The IDE displays the project window of the selected project 3 Select VCS gt Synchronize Status The project window displays the check out status icon for each file in the project and for the project itself Figure 4 2 shows the project window for a CodeWarrior project Figure 3 2 on page 21 explains how to interpret each of the check out status icons Figure 4 2 A CodeWarrior Project Window ox Problem 1 Release iB Y amp B E gt Files Link Order Targets Y File Code Data A ProbO1 java 805 Do Nm UDPServer java 2175 Do fx M TCPServer java 2429 Do Xy z PF 3 files 5K 0 A 4 In the project window click the name of one of the files in the project The project window highlights this file name MWCC 60 mwClearCase Plug in User Guide Tutorial Checking
48. log box 6 Click OK The Comment dialog box closes The ClearCase Add File dialog box displays Figure 3 9 shows this dialog box Figure 3 9 The ClearCase Add File Dialog Box ClearCase Add File m File Type f ClearCase Autodetect v Cancel I7 Store only the latest copy of the file no deltas Keep checked out 7 Use the ClearCase Add File dialog box to select the ClearCase file addition options you want 8 Click OK The ClearCase Add File dialog box closes The plug in adds the selected file and comment if any to ClearCase and changes the file s check out status icon to X MWCC 30 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference Adding a Project using the Add Command To add a project to ClearCase using the Add command follow these steps 1 2 Run the Code Warrior IDE Open the Code Warrior project whose project file you want to add to ClearCase The Code Warrior IDE displays the project window for this project Select VCS gt Project gt Add The Comment dialog box appears Figure 3 7 on page 27 shows this dialog box Optionally type a comment in the Comment dialog box Click OK The Comment dialog box closes The ClearCase Add File dialog box displays Figure 3 9 on page 30 shows this dialog box Use the ClearCase Add File dialog box to select the ClearCase file addition options you want Click
49. lost If applied to a checked out project the Undo Checkout command changes the ClearCase status of the project file that is of the project s mcp file to not checked out All changes made the project file are lost Undoing a File Check Out To undo a file check out follow these steps 1 Run the CodeWarrior IDE 2 Open the project that contains the file for which to undo the check out The CodeWarrior IDE displays the project window for this project 3 In the project window click the name of the file for which to undo the check out The IDE highlights this file name NOTE To undo the check out for several files at once highlight the name of each file and then issue the Undo Checkout command 4 Select VCS gt Undo Checkout The plug in undoes the check out of the selected file and changes its check out status icon to X MWCC 54 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference Undoing a Project Check Out To undo a project check out follow these steps 1 Run the Code Warrior IDE 2 Open the project for which to undo the check out The Code Warrior IDE displays the project window for this project 3 Select VCS gt Project gt Undo Checkout The plug in undoes the check out of the selected project and changes its check out status icon to X This icon appears in the lower left corner of the project window Variables The Variables command displays t
50. mmand adds the selected file to ClearCase If applied to an open project the Add command adds the project file that is the project s mcp file to ClearCase If applied recursively the Add command adds all files and projects contained in the plug in s ClearCase view to ClearCase NOTE The Add command is different from the Add command The Ada command gives you more control over how a file is added to ClearCase See Add on page 27 for an explanation of the Add command Adding a File using the Add Command To add a file to ClearCase using the Add command follow these steps 1 Run the CodeWarrior IDE 2 Open the project that contains the file you want to add to ClearCase The CodeWarrior IDE displays the project window for this project 3 In the project window click the name of the file you want to add The IDE highlights this file name TIP To add several files at once highlight the name of each file you want to add and then issue the Add command mwClearCase Plug in User Guide MWCC 29 Using the mwClearCase Plug in mwClearCase Plug in Command Reference 4 Select VCS gt Add The Comment dialog box appears Figure 3 8 shows this dialog box Figure 3 8 The Comment Dialog Box I x Please enter a comment for the file s to be added to ClearCase File added using the Add plua h command M Use For All Remaining Files Cancel 5 Optionally type a comment in the Comment dia
51. n the CodeWarrior IDE mwClearCase Plug in User Guide MWCC 45 Using the mwClearCase Plug in mwClearCase Plug in Command Reference 2 Select VCS gt Recursive gt Subtree Checkin The Please Select an Access Path dialog box displays Figure 3 13 shows this dialog box Figure 3 18 The Please Select an Access Path Dialog Box Path Type absolute Path y 5 view_java_snap 8 0 vob_ady_java y ProbO1 Ey Probo2 5 Prob03 O Tia E M4 TK 104 pon coca NOTE You do not have to open a project before issuing the Subtree Checkin command because this command does not affect a specific project Instead it affects the selected subtree of the plug ins ClearCase view 3 Use the Please Select and Access Path dialog box to select a subtree of the plug in s ClearCase view to use as the starting point for a recursive check in 4 Click OK The Please Select and Access Path dialog box closes The Comment dialog box appears Figure 3 19 shows this dialog box Figure 3 19 The Comment Dialog Box Please enter a comment for the file s to be checked into ClearCase The TCP Server now runs in its own thread J Use For All Remaining Files Cancel MWCC 46 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference 5 Optionally type a comment in the Comment dialog box 6 Click OK The Comment dialog box closes The plug in recurses into e
52. oject and subdirectory not already under source code control to ClearCase NOTE The Subtree Add command is different from the Subtree Add command in that the Subtree Add command gives you more control over how each file is added to ClearCase To add a subtree of the plug in s ClearCase view to ClearCase follow these steps 1 Run the CodeWarrior IDE 2 Select VCS gt Recursive gt Subtree Add The Please Select an Access Path dialog box displays Figure 3 13 shows this dialog box mwClearCase Plug in User Guide MWCC 43 Using the mwClearCase Plug in mwClearCase Plug in Command Reference Figure 3 15 The Please Select an Access Path Dialog Box Please Select an Access Path q ax Path Type absolute Path gt 5 view_java_snap B vob_ady_java Prob01 Ey Probo2 5 Probo3 t A MM TK 1nd pal cns NOTE You do not have to open a project before issuing the Subtree Add command because this command does not affect a specific project Instead it affects the selected subtree of the plug in s ClearCase view 3 Use the Please Select and Access Path dialog box to select a subtree of the plug in s ClearCase view to use as the starting point for a recursive add 4 Click OK The Please Select and Access Path dialog box closes The Comment dialog box appears Figure 3 16 shows this dialog box Figure 3 16 The Comment Dialog Box I x Please enter a comment for the file s
53. ot affect a specific project Instead the command affects the selected subtree of the plug in s ClearCase view Figure 3 21 The Please Select an Access Path Dialog Box Please Select an Access Path E 2 x Path Type Absolute Path z B view_java_snap E vob_ady_java 5 Prob01 Ey Prob02 5 Probo3 ES A MM TK Ine pal c 3 Use the Please Select and Access Path dialog box to select a subtree of the plug in s ClearCase view to use as the starting point for a recursive get 4 Click OK The Please Select and Access Path dialog box closes The plug in recurses into each subdirectory of the selected root directory and gets the latest version of each file and project Properties You can apply the Properties command to a single file or to a project You cannot apply it to multiple files or recursively mwClearCase Plug in User Guide MWCC 49 Using the mwClearCase Plug in mwClearCase Plug in Command Reference The Properties command displays the ClearCase property dialog box for the selected file or project Displaying the Properties of a File To display a file s properties follow these steps 1 Run the Code Warrior IDE 2 Open the project that contains the file whose properties you want to display The Code Warrior IDE displays the project window for this project 3 In the project window click the name of the file whose properties you want to display The IDE highlights this file
54. ptionally enter a comment in the Comment dialog box 4 Click OK The Comment dialog box closes The plug in checks in all files and projects in its ClearCase view NOTE The recursive checkin command fails for each checked out file that has not changed For these files issue the Undo Checkout command MWCC 34 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference Checkout You can apply the Checkout command to a file to a project or recursively If applied to a file the Checkout command creates a modifiable copy of the file in the plug ins ClearCase view If applied to a project the Checkout command creates a modifiable version of the project file that is of the mcp file in the plug in s ClearCase view If applied recursively the Checkout command checks out each file and project in each subdirectory of the plug in s ClearCase view See Checkin on page 32 for instructions the explain how to check in a file that you have checked out Checking out a File To check out a file follow these steps 1 Open the project that contains the file you want to check out The CodeWarrior IDE displays the project window for this project 2 Inthe project window click the name of the file to check out The IDE highlights this file name TIP To check out multiple files highlight the name of each file and then issue the Checkout command 3 Select VCS gt Checkout
55. roduct described herein and spe cifically disclaims any and all liability Metrowerks software is not authorized for and has not been designed tested manufactured or intended for use in developing applications where the failure malfunction or any inaccuracy of the application carries a risk of death serious bodily injury or damage to tangible property including but not limited to use in factory control systems medical devices or facilities nuclear facilities aircraft or automobile navi gation or communication emergency systems or other applications with a similar degree of potential hazard USE OF ALL SOFTWARE DOCUMENTATION AND RELATED MATERIALS ARE SUB JECT TO THE METROWERKS END USER LICENSE AGREEMENT FOR SUCH PRODUCT How to Contact Metrowerks Corporate Headquarters Metrowerks Corporation 9801 Metric Blvd Austin TX 78758 U S A World Wide Web http www metrowerks com Ordering amp Technical Support Voice 800 377 5416 Fax 512 997 4901 Table of Contents 1 Overview 5 About the mwClearCase Plug in System Requirements ee Learning More About mwClearCase 6 2 Setting Up the mwClearCase Plug in 7 Obtaining the mwClearCase Plug in 7 Installing the mwClearCase Plug in 8 Activating the mwClearCase Plug in 2 0 Deactivating the mwClearCase Plug in 2 17 3 Using the mwClearCase Plug in 19 Preparaliom lt a s s 6 ae do eRe ok ee He ee ew
56. s command reports the ClearCase status of the selected file or project Displaying the Status of a File To display the status of a file follow these steps 1 Run the CodeWarrior IDE 2 Open the project that contains the file for which you want to obtain status The CodeWarrior IDE displays the project window for this project 3 In the project window click the name of the file for which to you want to obtain status The IDE highlights this file name mwClearCase Plug in User Guide MWCC 51 Using the mwClearCase Plug in mwClearCase Plug in Command Reference TIP To get the status of several files highlight the name of each file and then issue the Status command 4 Select VCS gt Status The plug in displays the file s status in the VCS Messages window Figure 3 12 shows this window Figure 3 23 The Status Window Emvrs Messages olx Ol o Al Oo 1 VOS Messages for Prob01 mep sjal IB File status for C v File is under sou ut ser at local path is exclusively checked out Displaying the Status of a Project To display the status of a project follow these steps 1 Run the CodeWarrior IDE 2 Open the project for which you want to obtain status The CodeWarrior IDE displays the project window for this project 3 Select VCS gt Project gt Status The plug in displays the status of the project that is of the project s mcp file in the VCS Messages window Figure 3 23 on page 52 shows th
57. se commands to files in the project and to the project itself e Shows you the results of ClearCase commands The Project Window and the Plug in Once you have activated the mwClearCase plug in a new column appears in the project window of the project for which the plug in was activated or in all project windows if you activated the plug in globally This column contains icons that signify the check out status of each file in the project In addition an icon in the lower left corner of the project window indicates the check out status of the project file itself the mcp file Figure 3 1 shows the project window of a project for which the mwClearCase plug in has been activated Figure 3 2 explains how to interpret each check out status icon Figure 3 1 A Project Window with the mwClearCase Plug in Active Problem 1 Release 18 Y A p e Files is Order Targets Check Out Status Column AB Prob01GUIL java i sf RB Prob01 java 459 Do R x AB Temp java 307 Doe of a BTemp_ReadOnly java 327 Do sd _ e B BA files 0 7 t Project Check Out Status Icon File Check Out Status Icons MWCC 20 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Locations Figure 3 2 Check Out Status Icons Interpretation Icon Check Out Status o File has not been added to ClearCase File is writable a File has not been added to ClearCase File is read only
58. th y B view_java_snap B vob_ady_java H ProbO1 Ey Prob02 5 Probo3 gt O m A WwTK1Nd pa cea 3 Use the Please Select and Access Path dialog box to select a subtree of the plug ins ClearCase view to use as the starting point for a recursive check out 4 Click OK The Please Select and Access Path dialog box closes The plug in recurses into each subdirectory of the selected root directory and checks out each file project file and subdirectory not already checked out Subtree Get The Subtree Get command is a recursive command You can apply it to any subdirectory of the plug in s ClearCase view You cannot apply the command to an individual file or to a project The Subtree Get command first lets you select a subdirectory of the plug in s ClearCase view Next the command recurses into each subdirectory of the selected root directory and gets the latest version of each file and project To get the latest version of each file in a subtree of the plug in s ClearCase view follow these steps 1 Run the CodeWarrior IDE MWCC 48 mwClearCase Plug in User Guide Using the mwClearCase Plug in mwClearCase Plug in Command Reference 2 Select VCS gt Recursive gt Subtree Get The plug in displays the Please Select an Access Path dialog box Figure 3 21 shows this dialog box NOTE You do not have to open a project before issuing the Subtree Get command because this command does n
59. ttings as default 11 subtree checkout command 47 Use Version Control 11 subtree get command 48 Username 11 synchronize selection command 52 synchronize status command 53 system requirements 5 T tasks activating the mwClearCase plug in 10 17 creating a default plug in configuration 12 15 creating a project specific plug in configuration 15 17 deactivating the mwClearCase plug in 17 18 installing the mwClearCase plug in 8 10 obtaining the mwClearCase plug in 7 8 Try to mount shared volume configuration option 11 tutorial checking in a file 61 63 checking in a project 63 checking out a file 60 61 checking out a project 61 default plug in configuration creating 57 60 U undo checkout command 54 Use global settings as default configuration option 11 Use Version Control configuration option 11 Username configuration option 11 using the mwClearCase plug in 19 55 V variables command 55 VCS menu 21 VCS Setup settings panel explanation of options 11 12 figure 10 options Always show login dialog 11 Connect on open 11 Database Path 11 Local Path 12 Login Settings 11 Method 11 Password 11 Remember password 11 Try to mount shared volume 11 mwClearCase Plug in User Guide MWCC 67 MWCC 68 mwClearCase Plug in User Guide
60. ug in Activating the mwClearCase Plug in Table 2 1 VCS Setup Settings Panel Components Panel Component Description Local Path Groups items that pertain to the location of the ClearCase view group box that the plug in uses The bulleted items below explain each of these items NOTE You must specify the same ClearCase view for Local Path and for Database Path explained above e Choose Displays the Select an Access Path dialog box button Use this dialog box to select the same ClearCase view selected for Database Path explained above You can specify an absolute compiler relative or system relative path Also if a project is open you can specify a project relative path Path Displays the selected local path text field This field is read only There are two kinds of plug in activation e Global activation To activate the mwClearCase plug in globally create a default plug in configuration In this case the IDE activates the mwClearCase plug in for each Code Warrior project that has not been assigned a project specific plug in configuration e Project specific activation To activate the mwClearCase plug in for a specific project assign a plug in configuration to just this Code Warrior project In this case the IDE activates the mwClearCase plug in only when this project is both open and selected The procedures in this section explain how to activate the plug in each of these ways These procedures
61. up box Groups items that pertain to logging into a ClearCase view The bulleted items below explain each item in this group NOTE For the plug in to connect to ClearCase successfully you must enter the login settings exactly as specified below Username Leave the Username field blank text field e Password Leave the Password field blank text field Remember password Always check the Remember password check box check box e Connect on open Always check the Connect on open check box check box Always show login dialog Never check the Always show login dialog check box check box Database Path Groups items that pertain to the location of the ClearCase view group box that the plug in uses The bulleted items below explain each of these items e Choose Displays the Select an Access Path dialog box button Use this dialog box to select the directory that contains the ClearCase view for the plug in to use You can specify an absolute compiler relative or system relative path If a project is open you can also specify a project relative path NOTE You must specify the same ClearCase view for Database Path and for Local Path explained below Path Displays the name of the selected ClearCase view text field This field is read only Try to mount shared volume check box mwClearCase Plug in User Guide Reserved for future use Leave unchecked MWCC 11 Setting Up the mwClearCase Pl

Download Pdf Manuals

Related Search

Related Contents

Patron à télécharger 507A Veste ••• de burdafashion.com    取扱説明書 - 株式会社トヨトミ    BETRIEBSANLEITUNG USER MANUAL R 1260 R  MANUAL INSTALACION OKSOL-150.indd    FETATRACK SERIES 21T CARDIOTOCOGRAPH SERVICE MANUAL  

Copyright © All rights reserved. Failed to retrieve file