1 11/09/89 set_volume_log
2
3 Syntax as a command: set_volume_log VLNAME -control_arg
4
5
6 Function: alters certain parameters that describe the contents of a
7 volume log.
8
9
10 Arguments:
11 VLNAME
12 is the name of the volume log. The volog suffix is assumed if not
13 specified.
14
15
16 Control arguments:
17 -cons_sets SET_VALUE, -cs SET_VALUE
18 Sets the number of consolidated dump volume sets to retain in the
19 volume log whenever it is purged. The value of SET_VALUE may be a
20 non-zero positive integer or the word "all" or the letter "a". A
21 consolidated dump set is defined as all volumes that are used in
22 one cycle of the consolidated volume dumper. By default all
23 consolidated dump volumes are kept for each reload group. The
24 default operation will result if the SET_VALUE is set to "all" or
25 "a". See "Notes" section for further explanation of the rules
26 on how volume sets are retained or purged.
27
28
29 -incr_sets SET_VALUE, -is SET_VALUE
30 sets the number of incremental dump volume sets to retain in the
31 volume log whenever it is purged. The value of SET_VALUE may be a
32 non-zero positive integer or the word "all" or the letter "a". An
33 incremental dump set is defined as all volumes that are used in all
34 cycles of the incremental volume dumper that take place between
35 cycles of the consolidated volume dumper. By default all
36 incremental dump volumes are kept for each reload group. The
37 default operation will result if the SET_VALUE is set to "all" or
38 "a". See "Notes" section for further explaination of the rules
39 on how volume sets are retained or purged.
40
41 -reload_groups N, -rg N
42 sets the number of reload groups to N, where N>1. The default
43 value, set at volume log creation, is 2.
44
45
46 Notes:
47
48 1) All incremental volume sets are retained by default and are
49 purged when the reload group they are in is purged. This
50 default operation is set up when the volume log is created.
51 This default operation can also be set with the following
52 command line;
53
54 set_volume_log VLNAME -is all -cs all -reload_groups 2
55
56 When the incr_sets value is a non-zero positive integer, then
57 that number of incremental volume sets are retained. All other
58 incremental volume sets are purged, even if they are in the
59 current reload group.
60
61
62 2) All consolidated volume sets are retained by default and are
63 purged when the reload group they are in is purged. This
64 default operation is set up when the volume log is created and
65 can also be set up with the following command line;
66
67 set_volume_log VLNAME -is all -cs all -reload_groups 2
68
69 No consolidated volume sets are purged in the current reload
70 group. Using the number of consolidated dump sets in all the
71 reload groups, consolidated volume sets are purged from previous
72 reload groups to satisfy the value given with the -cons_sets
73 option if this value is a non-zero positive integer.
74
75
76 3) No incremental or consolidated volume set is retained if it
77 exists outside of the configured number of reload groups. If it
78 is desired to keep more consolidated or incremental volumes
79 sets, the number of reload groups must be increased.
80
81
82 Examples:
83
84 1. set_volume_log VLNAME -is 1 -cs 5 -reload_groups 8
85
86 This will be the result on the Wednesday before the consolidated dump
87 of the eighth week assuming you are running less incremental runs than
88 consolidated runs, consolidated runs are done once per day M-F, and a
89 complete is run on Saturday.
90
91
92 group SA SN MN TU WD TH FR
93 1 |comp|
94 2 |comp|
95 3 |comp|
96 4 |comp|
97 5 |comp|
98 6 |comp|
99 7 |comp|
100 |cons||cons||cons|
101 8 |comp|
102 |incr||incr...
103 |cons||cons|
104
105
106 2. set_volume_log VLNAME -incr_sets 5 -cons_sets 10 -reload_groups 8
107
108 This will be the result on the Wednesday before the consolidated dump
109 of the eighth week assuming you are running less incremental runs than
110 consolidated runs, consolidated runs are done once per day M-F, and a
111 complete is run on Saturday.
112
113
114 group SA SN MN TU WD TH FR
115 1 |comp|
116 2 |comp|
117 3 |comp|
118 4 |comp|
119 5 |comp|
120 6 |comp|
121 |cons||cons||cons|
122 7 |comp|
123 |incr||incr||incr|
124 |cons||cons||cons||cons||cons|
125 8 |comp|
126 |------incr------||incr||incr...
127 |cons||cons|
128
129
130 3. set_volume_log VLNAME -incr_sets 2 -cons_sets 10 -reload_groups 2
131
132 This will be the result on the Wednesday before the consolidated dump
133 of the second week. The consolidated runs are done once per day M-F
134 and a complete is run on Saturday.
135
136
137 group SA SN MN TU WD TH FR
138 1 |comp| |cons||cons||cons||cons||cons|
139 2 |comp|
140 |------incr------||incr||incr...
141 |cons||cons|
142
143 Notice that there are only 7 consolidated volume sets at this point in
144 the week. This is restricted by the number of reload groups
145 specified, ie, 2. If a full set of 10 consolidated dumps were desired
146 at all times, then 3 reload groups must be configured as in the
147 following example.
148
149
150 4. set_volume_log VLNAME -incr_sets 2 -cons_sets 10 -reload_groups 3
151
152 This will be the result on the Wednesday before the consolidated dump
153 of the second week. Again, consolidated runs are done once per day
154 M-F and a complete is run on Saturday.
155
156 group SA SN MN TU WD TH FR
157 1 |comp| |cons||cons|
158 2 |comp| |cons||cons||cons||cons||cons|
159 3 |comp|
160 |------incr------||incr||incr...
161 |cons||cons|