The dospace command displays data on VOB disk space used for shared derived objects. The report shows which views refer to shared DOs and shows how much disk space is used by the shared DOs that each view refers to.
You can use this information to identify views that should no longer refer to the DOs. Removing references to the DOs in those views can allow the disk space used by the DOs in the VOB to be reclaimed. When a DO no longer appears in any view, the scrubber utility, usually run as a periodically scheduled job, can remove the DO and its associated storage from the VOB.
The dospace command has a number of options that determine the range of derived objects and views it reports. By default, the command displays total disk space used for DOs in the specified VOBs and then lists the top 10 views in order of disk space used by DOs that appear in those views.
By default, dospace uses previously generated, cached data. The –update option generates fresh data and updates the cache before displaying the report.
The –generate option is intended for use by scheduled jobs. By default, the ClearCase scheduler periodically runs dospace with the –generate option to generate and cache data on disk space used by derived objects for all local VOBs. For information about describing and changing scheduled jobs, see the schedule reference page.
The UNIX examples in this section are written for use in csh. If you use another shell, you may need to use different quoting and escaping conventions.
The Windows examples that include wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.
In cleartool single-command mode, cmd-context represents the UNIX shell or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt.
cmd-context dospace –references 1 /projects/bigapp
K Bytes Date.Time VOB
141284 25-Jul-99.01:51:53 /projects/bigapp
K Bytes View
11026 dave
7722 sue_bl4
7500 cindy_v3.2.1
7224 release
6263 jack_build
5159 terry_v4
4871 v3.2.1.win -region rd_windows
4855 birdseye
4268 v3.2.win -region rd_windows
3903 andrea_40
cmd-context dospace –before 01-Jun-1999 –all –size 3000 \bigapp
Using 02-May-99.01:45:06 ("3 months") for before date.time.
01-Jun-99.01:45:06 ("2 months") is next before bucket.
K Bytes Date.Time VOB
159562 01-Aug-99.01:51:53 \bigapp
K Bytes View
28734 v3.1.1_pfm.re
28734 v3.1.1_pfm.bld
19208 v3.1.1.bld
19197 v3.1.1.re
14169 dave
7501 cindy_v3.2.1
7231 release
4866 birdseye
4102 v3.2.win
3987 kim_v3.2
3714 v3.2_pfm.bld
3587 sue_mtypes
3538 proj_v3.nt
3386 [uuid: f532a8f2.afb711d2.a4e2.00:01:72:31:df:c2]
machine1:c:\users\jack\jack_v3.3
cmd-context dospace –update /projects/bigapp
Job is running on remote host ("server1"), waiting for it to finish.
..........
Job completed successfully on remote host ("server1").
K Bytes Date.Time VOB
371523 01-Aug-99.01:45:06 /projects/bigapp
K Bytes View
30428 v3.2.1.bld
30329 v3.1.1_rev.bld
30329 v3.1.1_rev.re
29986 joe_v4.0_merge
29905 v3.2.1.re
29888 v3.2_rev.bld
28152 v3.2_rev.re
26549 winapp_v4.0.bl4.nt -region rd_windows
25670 v3.2.1.bld
25663 v3.2.1.re
cmd-context dospace –dump \smallapp
start time: 932879789
run time: 14
bucket 0: 86400 1 day
bucket 1: 259200 3 days
bucket 2: 604800 1 week
bucket 3: 1209600 2 weeks
bucket 4: 2592000 1 month
bucket 5: 5270400 2 months
bucket 6: 7862400 3 months
bucket 7: 10540800 4 months
bucket 8: 13132800 5 months
bucket 9: 15811200 6 months
bucket 10: 23673600 9 months
bucket 11: 31536000 1 year
bucket 12: 47347200 1.5 years
bucket 13: 63158400 2 years
bucket 14: 94694400 3 years
bucket 15: 0 more than 3 years
pool: ddft 73e0001b.747d11cb.a0ea.08:00:09:25:75:d8
all: 0 1 0 0 0 0 0 0 92321 0 0 0 0 0 0 0 0 0
all: 0 -2 0 0 0 96198 0 0 0 27647 0 0 0 0 0 0 0 0
view: 59f62178.580511d2.af73.00:01:80:9a:19:fe machine2
C:\views\app2.1_win.vws
view: 0 -2 0 0 0 96198 0 0 0 27647 0 0 0 0 0 0 0 0
view: 8054b303.63ba11d2.bcef.00:01:80:90:ae:6d machine8
D:\users\mary\vws\mary_test.vws
view: 0 -2 0 0 0 96198 0 0 0 27647 0 0 0 0 0 0 0 0
view: e7ca6e7a.990811d2.a1dc.00:01:80:85:f3:f5 machine4
C:\views\jeff\jeff_build.vws
view: 0 -2 0 0 0 96198 0 0 0 0 0 0 0 0 0 0 0 0
view: ac6db1f1.bd4811d2.b314.00:01:80:a2:f2:c3 machine7
D:\users\sue\views\app_axp.vws
view: 0 1 0 0 0 0 0 0 92321 0 0 0 0 0 0 0 0 0
Copyright© 2003 Rational Software. All Rights Reserved.