Customize, test, and distribute menu registry files

Before you begin

About this task

Parameterized build provides menu items for the ClearCase® Explorer and the Windows Explorer. DevOps Code ClearCase users can select these menu items to compile, upload copybook member to host, or link their COBOL files. The parameterized build context menu items for ClearCase Explorer and for Windows Explorer are shipped in the files compileCC.reg and compileWin.reg. A DevOps Code ClearCase administrator needs to customize, test, and distribute these files to DevOps Code ClearCase users. Afterward, DevOps Code ClearCase users can run the registry file to create the context menus in both the ClearCase Explorer and the Windows Explorer.

Procedure

To customize, test, and distribute these files, do these steps.

Note: This procedure is required only for using parameterized build from the ClearCase or Windows Explorer. If your users are running parameterized build from the TSO Client or from the Rational® Developer for System z® or Eclipse platforms, you can skip this step.

Using a text editor, edit the compileCC.reg file to point to the hostname and directory path where the parameterized build scripts are installed.

If, for example, the hostname is CCHOSTNAME and the installation path is C:\ccstg_d\Triggers, then the compileCC.reg file needs to be modified as shown in bold italics in the following example. If the DevOps Code ClearCase client is not in the same network as the server, the hostname must be fully qualify, such as CCHOSTNAME.svl.ibm.com.

REGEDIT4

[HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ContextMenus\DetailsView]

[HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ContextMenus\DetailsView\MenuContents]

[HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ContextMenus\DetailsView\MenuContents\ElemFile]
"SelSingle"="19,28,7,28,21,42,12,28,16,54,28,20"
"SelMulti"="19,28,7,5,2,28,16,54,28,503,28,20,28"

[HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ContextMenus\DetailsView\MenuContents\ElemFileCO]
"SelSingle"="19,28,5,49,28,21,42,12,28,16,54,28,501,503,502,28,20,28"
"SelMulti"="19,28,7,5,2,28,16,54,28,503,28,20,28,501,502"

[HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ContextMenus\DetailsView\MenuContents\SsElemFile]
"SelSingle"="19,28,58,28,7,28,21,42,12,28,16,54,28,501,502,28,20,28"
"SelMulti"="19,28,58,28,7,5,2,28,16,54,28,503,28,20,28"

[HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ContextMenus\DetailsView\MenuContents\SsElemFileCO]
"SelSingle"="19,28,5,49,28,21,42,12,28,16,54,28,501,502,28,20,28"
"SelMulti"="19,28,58,28,7,5,2,28,16,54,28,503,28,20,28"

[HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ContextMenus\DetailsView\MenuContents\VpFile]
"SelSingle"="2,28,41,28,20,28"

[HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ContextMenus\DetailsView\MenuTable]

[HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ContextMenus\DetailsView\MenuTable\501]
"Text"="Compile"
"HelpText"="Compile a COBOL program"
"DoHelpSubst"=""
"DispType"="Executable"
"Exe"="ccperl -I\\\\CCHOSTNAME\\ccstg_d\\Triggers"
"Params"="\\\\CCHOSTNAME\\ccstg_d\\Triggers\\bccpmbld_main.pl  -d $dir_or_file1 $file"
"DirParams"="$dir_or_file1"
"ShowDlg"="FALSE"
"Comment"=""

[HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ContextMenus\DetailsView\MenuTable\502]
"Text"="Compile Xpediter"
"HelpText"="Compile a COBOL program with Xpediter option"
"DoHelpSubst"="FALSE"
"DispType"="Executable"
"Exe"="ccperl -I\\\\CCHOSTNAME\\ccstg_d\\Triggers"
"Params"="\\\\CCHOSTNAME\\ccstg_d\\Triggers\\bccpmbld_main.pl  -x -d $dir_or_file1 $file"
"DirParams"="$dir_or_file1"
"ShowDlg"="FALSE"
"Comment"=""

[HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ContextMenus\DetailsView\MenuTable\503]
"Text"="Compile Multiple COBOL Programs"
"HelpText"="Compile Multiple COBOL Programs"
"DoHelpSubst"=""
"DispType"="Executable"
"Exe"="ccperl -I\\\\CCHOSTNAME\\ccstg_d\\Triggers"
"Params"="\\\\CCHOSTNAME\\ccstg_d\\Triggers\\bccpmbld_main.pl  -d $dir_or_file1 $filelist"
"DirParams"="$dir"
"ShowDlg"="FALSE"
"Comment"=""

[HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ContextMenus\DetailsView\MenuTable\505]
"Text"="Submit Link Job"
"HelpText"="Submit Link Job"
"DoHelpSubst"="FALSE"
"DispType"="Executable"
"Exe"="ccperl -I\\\\CCHOSTNAME\\ccstg_d\\Triggers"
"Params"="\\\\CCHOSTNAME\\ccstg_d\\Triggers\\bccpmbld_main.pl  -l -d $dir_or_file1 $file"
"DirParams"="$dir_or_file1"
"ShowDlg"="FALSE"
"Comment"=""

[HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ContextMenus\DetailsView\MenuTable\506]
"Text"="Upload Copy member to host"
"HelpText"="Upload copybook member to host"
"DoHelpSubst"=""
"DispType"="Executable"
"Exe"="ccperl -I\\\\CCHOSTNAME\\ccstg_d\\Triggers"
"Params"="\\\\CCHOSTNAME\\ccstg_d\\Triggers\\copybook_main.pl  -d $dir_or_file1 $file"
"DirParams"="$dir_or_file1"
"ShowDlg"="FALSE"
"Comment"=""

You need to decide what parameterized build functions your site needs and customize the menu items on the ClearCase Explorer by editing this file.
For instance, running the registry file compileCC.reg puts the Compile, Compile Xpediter, and Compile Multiple COBOL Programs on the context menu for checked out files. If you do not need any of these functions or want to add Submit Link Job and Upload copybook member to host, you have to update the menu items list. The following change will put Compile, Compile Xpediter, Submit Link Job, and Upload copybook member to host on a single selection context menu and put Compile Multiple COBOL Programs on multiple sections of the context menu.
```
[HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\ContextMenus\DetailsView\MenuContents\ElemFileCO]
"SelSingle"="19,28,5,49,28,21,42,12,28,16,54,28,501,502,504,505,28,20,28"
"SelMulti"="19,28,7,5,2,28,16,54,28,503,28,20,28"
```
Important: The above change enables the parameterized build menu items for checked out files only. You need to decide how you want these menu items to be used and alter or expand the change accordingly.
Run the compileCC.reg file and verify that the context menu has been updated on ClearCase Explorer.
Make similar changes to the compileWin.reg file, run the compileWin.reg file, and verify the change.
To test your changes, start the clearmenuadmin program by doing one of the following actions:
- From the Windows Taskbar, click Start > Run, type clearmenuadmin in the Open field, and click OK.
- From a windows command prompt, type clearmenuadmin and press Enter. This program should be in the search path.
To apply these changes to the ClearCase Explorer context menu, do these steps.

Important: The following procedure enables the parameterized build menu items for checked out files only. You need to decide how you want these menu items to be used and alter or expand this procedure accordingly.
1. From the menu bar, select Application > ClearCase Explorer.
2. Select Configuration > Load from File and then select the file compileCC.reg.
3. After the file is loaded, select the File in Object Type window.
4. In the Object State window, select Checked Out.
5. In Select Type, select Single Selection.
6. In Available Menu Choices, select Compile.
7. Click Add to add the Compile menu item into This Menu Contents.
8. Repeat steps 6.e through 6.g for the Upload Copy Member to Host, Submit Link Job, and Compile Xpediter menu items.
9. In Select Type, select Multiple Selection.
10. In Available Menu Choices, select Compile Multiple COBOL Programs.
11. Click Add to add the Compile menu item into This Menu Contents.
12. Use the Move Up or Move Down buttons to change the position of these items on the menu.
13. From the Context Menu Editor, select Configuration > Apply.
Repeat step 6 selecting Application > Windows Explorer and the compileWin.reg file to load the menu items into the Windows Explorer context menu.
After you have successfully tested these files, place them in a location from which ClearCase users can easily import them.

What to do next

Next step: Configuring the build project VOB