source: release-kits/lirk3/resources/gs3-release-maker/ant/docs/manual/OptionalTasks/clearcase.html@ 14982

Last change on this file since 14982 was 14982, checked in by oranfry, 16 years ago

initial import of LiRK3
File size: 23.9 KB
Line 
1<html>
2
3<head>
4<meta http-equiv="Content-Language" content="en-us">
5<title>Clearcase Tasks</title>
6<link rel="stylesheet" type="text/css" href="../stylesheets/antmanual.css">
7</head>
8
9<body>
10<h1>Ant ClearCase Tasks</h1>
11<p>by:<br>
12Curtis White (cwhite at aracnet dot com),<br>
13Sean P. Kane (spkane at genomatica dot com),<br>
14Rob Anderson (Anderson.Rob at vectorscm dot com), and<br>
15Sean Egan (sean at cm-logic dot com)</p>
16
17<p>Version 1.6 - 02/25/2003</p>
18
19<h1>ClearCase Support</h1>
20<h2>Table of Contents</h2>
21<ul>
22 <li><A href="#introduction">Introduction</a>
23 <li><A href="#cccheckin">CCCheckin</a>
24 <li><A href="#cccheckout">CCCheckout</a>
25 <li><A href="#ccuncheckout">CCUnCheckout</a>
26 <li><A href="#ccupdate">CCUpdate</a>
27 <li><A href="#ccmklbtype">CCMklbtype</a>
28 <li><A href="#ccmklabel">CCMklabel</a>
29 <li><A href="#ccrmtype">CCRmtype</a>
30 <li><A href="#cclock">CCLock</a>
31 <li><A href="#ccunlock">CCUnlock</a>
32 <li><A href="#ccmkbl">CCMkbl</a>
33 <li><A href="#ccmkattr">CCMkattr</a>
34 <li><A href="#ccmkdir">CCMkdir</a>
35 <li><A href="#ccmkelem">CCMkelem</a></li>
36
37</ul>
38
39<hr>
40<h2><a name="introduction">Introduction</a></h2>
41<p>Ant provides several optional tasks for working with ClearCase. These tasks correspond to various
42ClearCase commands using the Cleartool program. The current tasks available for Ant correspond to only
43a few of the significant ClearCase commands.</p>
44
45<p>More tasks can be easily added by deriving from the ClearCase class and then adding
46functionality that is specific to that ClearCase command.</p>
47
48
49<hr>
50<h2><a name="cccheckin">CCCheckin</a></h2>
51<h3>Description</h3>
52Task to perform a "cleartool checkin" command to ClearCase.
53<h3>Parameters</h3>
54<table border="1" cellpadding="2" cellspacing="0">
55 <tr>
56 <th>Attribute</th>
57 <th>Values</th>
58 <th>Required</th>
59 </tr>
60 <tr>
61 <td>viewpath</td>
62 <td>Path to the ClearCase view file or directory that the command
63 will operate on</td>
64 <td>No</td>
65 </tr>
66 <tr>
67 <td>comment</td>
68 <td>Specify a comment. Only one of comment or commentfile may be used.</td>
69 <td>No</td>
70 </tr>
71 <tr>
72 <td>commentfile</td>
73 <td>Specify a file containing a comment. Only one of comment or commentfile
74 may be used.</td>
75 <td>No</td>
76 </tr>
77 <tr>
78 <td>nowarn</td>
79 <td>Suppress warning messages</td>
80 <td>No</td>
81 </tr>
82 <tr>
83 <td>preservetime</td>
84 <td>Preserve the modification time</td>
85 <td>No</td>
86 </tr>
87 <tr>
88 <td>keepcopy</td>
89 <td>Keeps a copy of the file with a .keep extension</td>
90 <td>No</td>
91 </tr>
92 <tr>
93 <td>identical</td>
94 <td>Allows the file to be checked in even if it is identical
95 to the original</td>
96 <td>No</td>
97 </tr>
98 <tr>
99 <td>failonerr</td>
100 <td>Throw an exception if the command fails. Default is true</td>
101 <td>No</td>
102 </tr>
103</table>
104<h3>Examples</h3>
105<blockquote>
106<pre>
107&lt;cccheckin viewpath="c:/views/viewdir/afile"
108 commentfile="acomment.txt"
109 nowarn="true"
110 identical="true"/&gt;
111</pre>
112</blockquote>
113<p>Does a ClearCase <i>checkin</i> on the file <i>c:/views/viewdir/afile</i>.
114Comment text from the file <i>acomment.txt</i> is added to ClearCase as a comment.
115All warning messages are suppressed. The file is checked in even if it is
116<i>identical</i> to the original.</p>
117<hr>
118<h2><a name="cccheckout">CCCheckout</a></h2>
119<h3>Description</h3>
120Task to perform a "cleartool checkout" command to ClearCase.
121<h3>Parameters</h3>
122<table border="1" cellpadding="2" cellspacing="0">
123 <tr>
124 <th>Attribute</th>
125 <th>Values</th>
126 <th>Required</th>
127 </tr>
128 <tr>
129 <td>viewpath</td>
130 <td>Path to the ClearCase view file or directory that the command
131 will operate on</td>
132 <td>No</td>
133 </tr>
134 <tr>
135 <td>reserved</td>
136 <td>Specifies whether to check out the file as reserved or not</td>
137 <td>Yes</td>
138 </tr>
139 <tr>
140 <td>out</td>
141 <td>Creates a writable file under a different filename</td>
142 <td>No</td>
143 </tr>
144 <tr>
145 <td>nodata</td>
146 <td>Checks out the file but does not create an editable file
147 containing its data</td>
148 <td>No</td>
149 </tr>
150 <tr>
151 <td>branch</td>
152 <td>Specify a branch to check out the file to</td>
153 <td>No</td>
154 </tr>
155 <tr>
156 <td>version</td>
157 <td>Allows checkout of a version other than main latest</td>
158 <td>No</td>
159 </tr>
160 <tr>
161 <td>nowarn</td>
162 <td>Suppress warning messages</td>
163 <td>No</td>
164 </tr>
165 <tr>
166 <td>comment</td>
167 <td>Specify a comment. Only one of comment or commentfile may be used.</td>
168 <td>No</td>
169 </tr>
170 <tr>
171 <td>commentfile</td>
172 <td>Specify a file containing a comment. Only one of comment or
173 commentfile may be used.</td>
174 <td>No</td>
175 </tr>
176 <tr>
177 <td>notco</td>
178 <td>Fail if it's already checked out to the current view. Set to false to ignore it.<br>
179 Since ant 1.6.1</td>
180 <td>No</td>
181 </tr>
182 <tr>
183 <td>failonerr</td>
184 <td>Throw an exception if the command fails. Default is true.<br>
185 Since ant 1.6.1</td>
186 <td>No</td>
187 </tr>
188</table>
189<h3>Examples</h3>
190<blockquote>
191<pre>
192&lt;cccheckout viewpath="c:/views/viewdir/afile"
193 reserved="true"
194 branch="abranch"
195 nowarn="true"
196 comment="Some comment text"/&gt;
197</pre>
198</blockquote>
199<p>Does a ClearCase <i>checkout</i> on the file <i>c:/views/viewdir/afile</i>.
200It is checked out as <i>reserved</i> on branch called <i>abranch</i>. All
201warning messages are suppressed. A <i>Some comment text</i> is added to
202ClearCase as a comment.</p>
203<hr>
204<h2><a name="ccuncheckout">CCUnCheckout</a></h2>
205<h3>Description</h3>
206Task to perform a UnCheckout command to ClearCase.
207<h3>Parameters</h3>
208<table border="1" cellpadding="2" cellspacing="0">
209 <tr>
210 <th>Attribute</th>
211 <th>Values</th>
212 <th>Required</th>
213 </tr>
214 <tr>
215 <td>viewpath</td>
216 <td>Path to the ClearCase view file or directory that the command
217 will operate on</td>
218 <td>No</td>
219 </tr>
220 <tr>
221 <td>keepcopy</td>
222 <td>Specifies whether to keep a copy of the file with a .keep
223 extension or not</td>
224 <td>No</td>
225 </tr>
226 <tr>
227 <td>failonerr</td>
228 <td>Throw an exception if the command fails. Default is true<br>
229 Since ant 1.6.1</td>
230 <td>No</td>
231 </tr>
232</table>
233<h3>Examples</h3>
234<blockquote>
235<pre>
236&lt;ccuncheckout viewpath="c:/views/viewdir/afile"
237 keepcopy="true"/&gt;
238</pre>
239</blockquote>
240<p>Does a ClearCase <i>uncheckout</i> on the file <i>c:/views/viewdir/afile</i>.
241A copy of the file called <i>c:/views/viewdir/afile.keep</i> is kept.</p>
242<hr>
243<h2><a name="ccupdate">CCUpdate</a></h2>
244<h3>Description</h3>
245Task to perform an "cleartool update" command to ClearCase.
246<h3>Parameters</h3>
247<table border="1" cellpadding="2" cellspacing="0">
248 <tr>
249 <th>Attribute</th>
250 <th>Values</th>
251 <th>Required</th>
252 </tr>
253 <tr>
254 <td>viewpath</td>
255 <td>Path to the ClearCase snapshot view file or directory that the command
256 will operate on</td>
257 <td>No</td>
258 </tr>
259 <tr>
260 <td>graphical</td>
261 <td>Displays a graphical dialog during the update</td>
262 <td>No</td>
263 </tr>
264 <tr>
265 <td>log</td>
266 <td>Specifies a log file for ClearCase to write to</td>
267 <td>No</td>
268 </tr>
269 <tr>
270 <td>overwrite</td>
271 <td>Specifies whether to overwrite hijacked files or not</td>
272 <td>No</td>
273 </tr>
274 <tr>
275 <td>rename</td>
276 <td>Specifies that hijacked files should be renamed with a .keep extension</td>
277 <td>No</td>
278 </tr>
279 <tr>
280 <td>currenttime</td>
281 <td>Specifies that modification time should be written as the
282 current time. Either currenttime or preservetime can be
283 specified.</td>
284 <td>No</td>
285 </tr>
286 <tr>
287 <td>preservetime</td>
288 <td>Specifies that modification time should preserved from the
289 VOB time. Either currenttime or preservetime can be
290 specified.</td>
291 <td>No</td>
292 </tr>
293 <tr>
294 <td>failonerr</td>
295 <td>Throw an exception if the command fails. Default is true.<br>
296 Since ant 1.6.1</td>
297 <td>No</td>
298 </tr>
299</table>
300<h3>Examples</h3>
301<blockquote>
302<pre>
303&lt;ccupdate viewpath="c:/views/viewdir"
304 graphical="false"
305 log="log.log"
306 overwrite="true"
307 currenttime="true"
308 rename="false"/&gt;
309</pre>
310</blockquote>
311<p>Does a ClearCase <i>update</i> on the snapshot view directory <i>c:/views/viewdir</i>.
312A graphical dialog will be displayed. The output will be logged to
313<i>log.log</i> and it will overwrite any hijacked files. The modified
314time will be set to the current time.</p>
315
316
317
318<hr>
319<h2><a name="ccmklbtype">CCMklbtype</a></h2>
320<h3>Description</h3>
321Task to perform a "mklbtype" command to ClearCase.
322<h3>Parameters</h3>
323<table border="1" cellpadding="2" cellspacing="0">
324 <tr>
325 <th>Attribute</th>
326 <th>Values</th>
327 <th>Required</th>
328 </tr>
329 <tr>
330 <td>typename</td>
331 <td>Name of the label type to create</td>
332 <td>Yes</td>
333 <tr>
334 <tr>
335 <td>vob</td>
336 <td>Name of the VOB</td>
337 <td>No</td>
338 <tr>
339 <tr>
340 <td>replace</td>
341 <td>Replace an existing label definition of the same type</td>
342 <td>No</td>
343 <tr>
344 <tr>
345 <td>global</td>
346 <td>Either global or ordinary can be specified, not both. Creates a label type that is global to the VOB or to VOBs that use this VOB</td>
347 <td>No</td>
348 <tr>
349 <tr>
350 <td>ordinary</td>
351 <td>Either global or ordinary can be specified, not both. Creates a label type that can be used only in the current VOB. <B>Default</B></td>
352 <td>No</td>
353 <tr>
354 <tr>
355 <td>pbranch</td>
356 <td>Allows the label type to be used once per branch in a given element's version tree</td>
357 <td>No</td>
358 <tr>
359 <tr>
360 <td>shared</td>
361 <td>Sets the way mastership is checked by ClearCase. See ClearCase documentation for details</td>
362 <td>No</td>
363 <tr>
364 <tr>
365 <td>comment</td>
366 <td>Specify a comment. Only one of comment or cfile may be used.</td>
367 <td>No</td>
368 <tr>
369 <tr>
370 <td>commentfile</td>
371 <td>Specify a file containing a comment. Only one of comment or cfile may be used.</td>
372 <td>No</td>
373 <tr></tr>
374 <tr>
375 <td>failonerr</td>
376 <td>Throw an exception if the command fails. Default is true<br>
377 Since ant 1.6.1</td>
378 <td>No</td>
379 </tr>
380</table>
381
382<h3>Examples</h3>
383<blockquote>
384<pre>
385&lt;ccmklbtype typename="VERSION_1"
386 ordinary="true"
387 comment="Development version 1"/&gt;
388</pre>
389</blockquote>
390<p>Does a ClearCase <i>mklbtype</i> to create a label type named <i>VERSION_1</i>.
391It is created as <i>ordinary</i> so it is available only to the current VOB.
392The text <i>Development version 1</i> is added as a comment.</p>
393
394
395<hr>
396<h2><a name="ccmklabel">CCMklabel</a></h2>
397<h3>Description</h3>
398Task to perform a "mklabel" command to ClearCase.
399<h3>Parameters</h3>
400<table border="1" cellpadding="2" cellspacing="0">
401 <tr>
402 <th>Attribute</th>
403 <th>Values</th>
404 <th>Required</th>
405 </tr>
406 <tr>
407 <td>typename</td>
408 <td>Name of the label type</td>
409 <td>Yes</td>
410 <tr>
411 <tr>
412 <td>viewpath</td>
413 <td>Path to the ClearCase view file or directory that the command will operate on</td>
414 <td>No</td>
415 <tr>
416 <tr>
417 <td>replace</td>
418 <td>Replace a label of the same type on the same branch</td>
419 <td>No</td>
420 <tr>
421 <tr>
422 <td>recurse</td>
423 <td>Process each subdirectory under viewpath</td>
424 <td>No</td>
425 <tr>
426 <tr>
427 <td>version</td>
428 <td>Identify a specific version to attach the label to</td>
429 <td>No</td>
430 <tr>
431 <tr>
432 <td>vob</td>
433 <td>Name of the VOB</td>
434 <td>No</td>
435 <tr>
436 <tr>
437 <td>comment</td>
438 <td>Specify a comment. Only one of comment or cfile may be used.</td>
439 <td>No</td>
440 <tr>
441 <tr>
442 <td>commentfile</td>
443 <td>Specify a file containing a comment. Only one of comment or cfile may be used.</td>
444 <td>No</td>
445 <tr></tr>
446 <tr>
447 <td>failonerr</td>
448 <td>Throw an exception if the command fails. Default is true<br>
449 Since ant 1.6.1</td>
450 <td>No</td>
451 </tr>
452</table>
453
454<h3>Examples</h3>
455<blockquote>
456<pre>
457&lt;ccmklabel viewpath="c:/views/viewdir/afile"
458 comment="Some comment text"
459 recurse="true"
460 version="\main\2"
461 typename="VERSION_1"/&gt;
462</pre>
463</blockquote>
464<p>Does a ClearCase <i>mklabel</i> on the file <i>c:/views/viewdir/afile</i> under
465the main branch for version 2 (<i>\main\2</i>). Text <i>Some comment text</i> is added
466as a comment. It will <i>recurse</i> all subdirectories.
467
468
469<hr>
470<h2><a name="ccrmtype">CCRmtype</a></h2>
471<h3>Description</h3>
472Task to perform a "rmtype" command to ClearCase.
473<h3>Parameters</h3>
474<table border="1" cellpadding="2" cellspacing="0">
475 <tr>
476 <th>Attribute</th>
477 <th>Values</th>
478 <th>Required</th>
479 </tr>
480 <tr>
481 <td>typekind</td>
482 <td>The kind of type to create. Valid types are:
483 <table border="0" width="40%">
484 <tr>
485 <td width="15%"> </td>
486 <td><b>attype</b><br>
487 <b>brtype</b><br>
488 <b>eltype</b><br>
489 <b>hltype</b><br>
490 <b>lbtype</b><br>
491 <b>trtype</b>
492 </td>
493 <td>- <br>
494 - <br>
495 - <br>
496 - <br>
497 - <br>
498 -
499 </td>
500 <td>attribute type<br>
501 branch type<br>
502 element type<br>
503 hyperlink type<br>
504 label type<br>
505 trigger type
506 </td>
507 </tr>
508 </table>
509 </td>
510 <td>Yes</td>
511 <tr>
512 <tr>
513 <td>typename</td>
514 <td>The name of the type to remove</td>
515 <td>Yes</td>
516 <tr>
517 <tr>
518 <td>ignore</td>
519 <td>Used with trigger types only. Forces removal of trigger type even if a pre-operation trigger would prevent its removal</td>
520 <td>No</td>
521 <tr>
522 <tr>
523 <td>rmall</td>
524 <td>Removes all instances of a type and the type object itself</td>
525 <td>No</td>
526 <tr>
527 <tr>
528 <td>comment</td>
529 <td>Specify a comment. Only one of comment or cfile may be used.</td>
530 <td>No</td>
531 <tr>
532 <tr>
533 <td>commentfile</td>
534 <td>Specify a file containing a comment. Only one of comment or cfile may be used.</td>
535 <td>No</td>
536 <tr></tr>
537 <tr>
538 <td>failonerr</td>
539 <td>Throw an exception if the command fails. Default is true
540 Since ant 1.6.1</td>
541 <td>No</td>
542 </tr>
543</table>
544
545<h3>Examples</h3>
546<blockquote>
547<pre>
548&lt;ccrmtype typekind="lbtype"
549 typename="VERSION_1"
550 commentfile="acomment.txt"
551 rmall="true"/&gt;
552</pre>
553</blockquote>
554<p>Does a ClearCase <i>rmtype</i> to remove a label type (<i>lbtype</i>) named <i>VERSION_1</i>.
555Comment text from the file <i>acomment.txt</i> is added as a comment. All instances of the type
556are removed, including the type object itself.</p>
557<hr>
558
559<h2><a name="cclock">CCLock</a></h2>
560<h3>Description</h3>
561Task to perform a "cleartool lock" command to ClearCase.
562<h3>Parameters</h3>
563 <table border="1" cellpadding="2" cellspacing="0">
564 <tr>
565 <th>Attribute</th>
566 <th>Values</th>
567 <th>Required</th>
568 </tr>
569 <tr>
570 <td>replace</td>
571 <td>Specifies replacing an existing lock</td>
572 <td>No</td>
573 <tr>
574 <tr>
575 <td>nusers</td>
576 <td>Specifies user(s) who can still modify the object</td>
577 <td>No</td>
578 <tr>
579 <tr>
580 <td>obsolete</td>
581 <td>Specifies that the object should be marked obsolete</td>
582 <td>No</td>
583 <tr>
584 <tr>
585 <td>comment</td>
586 <td>Specifies how to populate comments fields</td>
587 <td>No</td>
588 <tr>
589 <tr>
590 <td>pname</td>
591 <td>Specifies the object pathname to be locked.</td>
592 <td>No</td>
593 <tr>
594 <td>objselect</td>
595 <td>This variable is obsolete. Should use <i>objsel</i> instead.</td>
596 <td>No</td>
597 <tr>
598 <tr>
599 <td>objsel</td>
600 <td>Specifies the object(s) to be locked.<br>
601 Since ant 1.6.1</td>
602 <td>No</td>
603 <tr>
604 <tr>
605 <td>failonerr</td>
606 <td>Throw an exception if the command fails. Default is true.<br>
607 Since ant 1.6.1</td>
608 <td>No</td>
609 </tr>
610
611 </table>
612<h3>Examples</h3>
613<blockquote>
614<pre>
615&lt;cclock
616 objsel="stream:Application_Integration@\MyProject_PVOB"
617 /&gt;
618</pre>
619</blockquote>
620<p>Does a ClearCase <i>lock</i> on the object <i>stream:Application_Integration@\MyProject_PVOB</i>.</p>
621<hr>
622
623<h2><a name="ccunlock">CCUnlock</a></h2>
624<h3>Description</h3>
625Task to perform a "cleartool unlock" command to ClearCase.
626<h3>Parameters</h3>
627<table border="1" cellpadding="2" cellspacing="0">
628 <tr>
629 <th>Attribute</th>
630 <th>Values</th>
631 <th>Required</th>
632 </tr>
633 <tr>
634 <td>comment</td>
635 <td>Specifies how to populate comments fields</td>
636 <td>No</td>
637 <tr>
638 <tr>
639 <td>pname</td>
640 <td>Specifies the object pathname to be unlocked.</td>
641 <td>No</td>
642 <tr>
643 <td>objselect</td>
644 <td>This variable is obsolete. Should use <i>objsel</i> instead.</td>
645 <td>No</td>
646 <tr>
647 <tr>
648 <td>objsel</td>
649 <td>Specifies the object(s) to be unlocked.<br>
650 Since ant 1.6.1</td>
651 <td>No</td>
652 <tr>
653 <tr>
654 <td>failonerr</td>
655 <td>Throw an exception if the command fails. Default is true.<br>
656 Since ant 1.6.1</td>
657 <td>No</td>
658 </tr>
659
660 </table>
661 <h3>Examples</h3>
662<blockquote>
663<pre>
664&lt;ccunlock
665 objsel="stream:Application_Integration@\MyProject_PVOB"
666 /&gt;
667</pre>
668</blockquote>
669<p>Does a ClearCase <i>unlock</i> on the object <i>stream:Application_Integration@\MyProject_PVOB</i>.</p>
670<hr>
671
672<h2><a name="ccmkbl">CCMkbl</a></h2>
673<h3>Description</h3>
674Task to perform a "cleartool mkbl" command to ClearCase.
675<h3>Parameters</h3>
676<table border="1" cellpadding="2" cellspacing="0">
677 <tr>
678 <th>Attribute</th>
679 <th>Values</th>
680 <th>Required</th>
681 </tr>
682 <tr>
683 <td>comment</td>
684 <td>Specify a comment. Only one of comment or cfile may be
685used.</td>
686 <td>No</td>
687 </tr>
688 <tr>
689 <td>commentfile</td>
690 <td>Specify a file containing a comment. Only one of comment or
691cfile may be used.</td>
692 <td>No</td>
693 </tr>
694 <tr>
695 <td>baselinerootname</td>
696 <td>Specify the name to be associated with the baseline.</td>
697 <td>Yes</td>
698 </tr>
699 <tr>
700 <td>nowarn</td>
701 <td>Suppress warning messages</td>
702 <td>No</td>
703 <tr>
704 <tr>
705 <td>identical</td>
706 <td>Allows the baseline to be created even if it is identical to the
707previous baseline.</td>
708 <td>No</td>
709 </tr>
710 <tr>
711 <td>full</td>
712 <td>Creates a full baseline.</td>
713 <td>No</td>
714 </tr>
715 <tr>
716 <td>nlabel</td>
717 <td>Allows the baseline to be created without a label.</td>
718 <td>No</td>
719 </tr>
720 <tr>
721 <td>failonerr</td>
722 <td>Throw an exception if the command fails. Default is true.<br>
723 Since ant 1.6.1</td>
724 <td>No</td>
725 </tr>
726 </table>
727<h3>Examples</h3>
728<blockquote>
729<pre>
730&lt;ccmkbl
731 baselinerootname="Application_Baseline_AUTO"
732 identical="yes"
733 full="no"
734 viewpath="v:\ApplicationCC"
735 /&gt;
736</pre>
737</blockquote>
738<p>Does a ClearCase <i>mkbl</i> on the Integration view at <i>v:\ApplicationCC</i>
739even if it is <i>identical</i> to a previous baseline. The new baseline with be
740incremental and named "Application_Baseline_AUTO".</p>
741<hr>
742
743<h2><a name="ccmkattr">CCMkattr</a></h2>
744<h3>Description</h3>
745Task to perform a &quot;cleartool mkattr&quot; command to ClearCase.<br>
746Since ant 1.6.1
747<h3>Parameters</h3>
748<table border="1" cellpadding="2" cellspacing="0">
749 <tr>
750 <th>Attribute</th>
751 <th>Values</th>
752 <th>Required</th>
753 </tr>
754 <tr>
755 <td>viewpath</td>
756 <td>Path to the ClearCase view file or directory that the command will operate on</td>
757 <td>Yes</td>
758 </tr>
759 <tr>
760 <td>replace</td>
761 <td>Replace the value of the attribute if it already exists</td>
762 <td>No</td>
763 </tr>
764 <tr>
765 <td>recurse</td>
766 <td>Process each subdirectory under viewpath</td>
767 <td>No</td>
768 </tr>
769 <tr>
770 <td>version</td>
771 <td>Identify a specific version to attach the attribute to</td>
772 <td>No</td>
773 </tr>
774 <tr>
775 <td>typename</td>
776 <td>Name of the attribute type</td>
777 <td>Yes</td>
778 </tr>
779 <tr>
780 <td>typevalue</td>
781 <td>Value to attach to the attribute type</td>
782 <td>Yes</td>
783 </tr>
784 <tr>
785 <td>comment</td>
786 <td>Specify a comment. Only one of comment or cfile may be used.</td>
787 <td>No</td>
788 </tr>
789 <tr>
790 <td>commentfile</td>
791 <td>Specify a file containing a comment. Only one of comment or cfile may be used.</td>
792 <td>No</td>
793 </tr>
794 <tr>
795 <td>failonerr</td>
796 <td>Throw an exception if the command fails. Default is true</td>
797 <td>No</td>
798 </tr>
799 </table>
800<h3>Examples</h3>
801<blockquote>
802<pre>
803&lt;ccmkattr viewpath=&quot;c:/views/viewdir/afile&quot;
804 typename=&quot;BugFix&quot;
805 typevalue=&quot;34445&quot;
806 /&gt;
807</pre>
808</blockquote>
809<p>Does a ClearCase <i>mkattr</i> on the file <i>c:/views/viewdir/afile</i> and
810attaches the attribute <i>BugFix</i> with a value of <i>34445</i> to it.</p>
811<hr>
812
813<h2><a name="ccmkdir">CCMkdir</a></h2>
814<h3>Description</h3>
815Task to perform a &quot;cleartool mkdir&quot; command to ClearCase.<br>
816Since ant 1.6.1
817<h3>Parameters</h3>
818<table border="1" cellpadding="2" cellspacing="0">
819 <tr>
820 <th>Attribute</th>
821 <th>Values</th>
822 <th>Required</th>
823 </tr>
824 <tr>
825 <td>viewpath</td>
826 <td>Path to the ClearCase view directory that the command will operate on</td>
827 <td>Yes</td>
828 </tr>
829 <tr>
830 <td>comment</td>
831 <td>Specify a comment. Only one of comment or cfile may be used.</td>
832 <td>No</td>
833 </tr>
834 <tr>
835 <td>commentfile</td>
836 <td>Specify a file containing a comment. Only one of comment or cfile may be used.</td>
837 <td>No</td>
838 </tr>
839 <tr>
840 <td>nocheckout</td>
841 <td>Do not checkout after element creation</td>
842 <td>No</td>
843 </tr>
844 <tr>
845 <td>failonerr</td>
846 <td>Throw an exception if the command fails. Default is true</td>
847 <td>No</td>
848 </tr>
849 </table>
850<h3>Examples</h3>
851<blockquote>
852<pre>
853&lt;ccmkdir viewpath=&quot;c:/views/viewdir/adir&quot;
854 nochcekout=&quot;true&quot;
855 comment=&quot;Some comment text&quot;/&gt;
856</pre>
857</blockquote>
858<p>Does a ClearCase <i>mkdir</i> on the dir <i>c:/views/viewdir/adir</i> and
859does not automatically check it out.</p>
860<hr>
861
862<h2><a name="ccmkelem">CCMkelem</a></h2>
863<h3>Description</h3>
864Task to perform a &quot;cleartool mkelem&quot; command to ClearCase.<br>
865Since ant 1.6.1
866<h3>Parameters</h3>
867<table border="1" cellpadding="2" cellspacing="0">
868 <tr>
869 <th>Attribute</th>
870 <th>Values</th>
871 <th>Required</th>
872 </tr>
873 <tr>
874 <td>viewpath</td>
875 <td>Path to the ClearCase view file or directory that the command will operate on</td>
876 <td>Yes</td>
877 <tr>
878 <tr>
879 <td>comment</td>
880 <td>Specify a comment. Only one of comment or cfile may be used.</td>
881 <td>No</td>
882 <tr>
883 <tr>
884 <td>commentfile</td>
885 <td>Specify a file containing a comment. Only one of comment or cfile may be used.</td>
886 <td>No</td>
887 <tr>
888 <tr>
889 <td>nowarn</td>
890 <td>Suppress warning messages</td>
891 <td>No</td>
892 <tr>
893 <tr>
894 <td>nocheckout</td>
895 <td>Do not checkout after element creation</td>
896 <td>No</td>
897 <tr>
898 <tr>
899 <td>checkin</td>
900 <td>Checkin element after creation</td>
901 <td>No</td>
902 <tr>
903 <tr>
904 <td>preservetime</td>
905 <td>Preserve the modification time (for checkin)</td>
906 <td>No</td>
907 <tr>
908 <tr>
909 <td>master</td>
910 <td>Assign mastership of the main branch to the current site</td>
911 <td>No</td>
912 <tr>
913 <tr>
914 <td>eltype</td>
915 <td>Element type to use during element creation</td>
916 <td>No</td>
917 <tr>
918 <tr>
919 <td>failonerr</td>
920 <td>Throw an exception if the command fails. Default is true</td>
921 <td>No</td>
922 <tr>
923 </table>
924<h3>Examples</h3>
925<blockquote>
926<pre>
927&lt;ccmkelem viewpath=&quot;c:/views/viewdir/afile&quot;
928 eltype=&quot;text_file&quot;
929 checkin=&quot;true&quot;
930 comment=&quot;Some comment text&quot;/&gt;
931</pre>
932</blockquote>
933<p>Does a ClearCase <i>mkelem</i> on the file <i>c:/views/viewdir/afile</i> with
934element type <i>text_file</i>. It also checks in the file after creation.</p>
935<hr>
936
937<p align="center">Copyright &copy; 2000-2004 The Apache Software Foundation. All rights
938reserved.</p>
939</body>
940</html>
Note: See TracBrowser for help on using the repository browser.