1 :Info: bj_mgr_call: bjmc:  1985-04-05  bj_mgr_call, bjmc
  2 
  3 Syntax as a command:  bjmc OPERATION {PATHs} {-control_args}
  4 
  5 
  6 Syntax as an active function:  [bjmc OPERATION {PATHs} {-control_args}]
  7 
  8 
  9 Function: enables you to manipulate before journals in your process by
 10 calling before_journal_manager_ entry points from command level.  This
 11 command is part of the command level interface to Multics data
 12 management (DM) (see the Programmer's Reference Manual).
 13 
 14 
 15 Arguments:
 16 OPERATION
 17    designates the before journal manager operation to be performed.
 18    See "List of operations" below for a description of each operation.
 19 PATH
 20    specifies the absolute or relative pathname of the before journals
 21    being manipulated (required for all operations except
 22    get_default_path).  Give -pathname (-pn) PATH with pathnames
 23    constructed with leading minus signs to distinguish them from
 24    control arguments.  If you supply no .bj suffix, one is assumed.
 25 
 26 
 27 List of operations:
 28    Information about each before journal operation may be obtained
 29    by typing: help bjmc.OPERATION
 30 close, cl
 31    closes the before journals specified by PATHs.
 32 closed
 33    returns true if the before journal specified by PATH is not
 34    open in your process, false otherwise.
 35 create, cr
 36    creates the before journals specified by PATHs
 37 get_default_path, gdp
 38    returns the pathname of the process's default before journal.
 39 
 40 
 41 open, o
 42    opens the before journals specified by PATHs.
 43 opened
 44    returns true if the before journal specified by PATH is opened in
 45    your process, false otherwise.
 46 set_default_path, sdp
 47    sets the default before journal for the process to the specified
 48    pathname.
 49 set_attribute, sattr
 50    sets an attribute of the before journals specified by PATHs.
 51 
 52 
 53 Control arguments:
 54 -control_arg
 55    optional control arguments that vary by operation.
 56 
 57 
 58 :Info: bjmc.close: bjmc.cl:  1985-04-05  bjmc close operation
 59 
 60 Syntax as a command:  bjmc cl PATHs
 61 
 62 
 63 Syntax as an active function:  [bjmc cl PATHs]
 64 
 65 
 66 Function: closes the before journals specified by PATHs.  Separate
 67 pathnames by spaces if multiple journals are to be closed.
 68 Specifically close by name each journal opened in the process.  The
 69 active function returns true if the journals were closed successfully,
 70 false otherwise.
 71 
 72 
 73 Arguments:
 74 close, cl
 75    the operation to be performed.
 76 PATHs
 77    are the absolute or relative pathnames of before journals to be
 78    closed.  You can use -pathname (-pn) to specify the journal paths.
 79    If you supply no .bj suffix, it is assumed.
 80 
 81 
 82 Notes: If a before journal being closed by this operation is the
 83 default journal, the last journal opened in the process becomes the
 84 default.
 85 
 86 
 87 :Info: bjmc.closed:  1985-04-05  bjmc closed operation
 88 
 89 Syntax as a command:  bjmc closed PATH
 90 
 91 
 92 Syntax as an active function:  [bjmc closed PATH]
 93 
 94 
 95 Function: returns true if the before journal specified by PATH is not
 96 open in your process, false otherwise.
 97 
 98 
 99 Arguments:
100 closed
101    the operation to be performed.
102 PATH
103    is the absolute or relative pathname of a before journal.  You can
104    use -pathname (-pn) to specify the journal path.  If you don't give
105    the .bj suffix, it is assumed.
106 
107 
108 :Info: bjmc.create: bjmc.cr:  1985-04-05  bjmc create operation
109 
110 Syntax as a command:  bjmc cr PATHs {-control_args}
111 
112 
113 Syntax as an active function:  [bjmc cr PATHs {-control_args}]
114 
115 
116 Function: creates the before journals specified by PATHs.  The active
117 function returns true if the journals are created successfully, false
118 otherwise.
119 
120 
121 Arguments:
122 create, cr
123    the operation to be performed.
124 PATHs
125    are the absolute or relative pathnames of the before journals to be
126    created.  You can use -pathname (-pn) to specify the journal path.
127    If you supply no .bj suffix, it is assumed.
128 
129 
130 Control arguments:
131 -length N, -ln N
132    specifies the size of the before journal, where N is the number of
133    4096-byte control intervals.  Once established, you can't alter a
134    journal's size.  (Default: if you specify no value at the time of
135    creation, the size is 64 control intervals).
136 -transaction_storage_limit N, -tsl N
137    specifies the maximum number of bytes a single transaction can use
138    in the before journal (Default: the entire journal, see the
139    set_attriubute operation for more info).
140 
141 
142 Notes: Before journals are extended entry types; you can delete them
143 using the delete command.  You can only delete before journals if they
144 are not required for recovery.
145 
146 
147 :Info: bjmc.get_default_path: bjmc.gdp:  1985-04-05  bjmc get_default_path operation
148 
149 
150 Syntax as a command:  bjmc gdp
151 
152 
153 Syntax as an active function:  [bjmc gdp]
154 
155 
156 Function: returns the pathname of the process's default before
157 journal.
158 
159 
160 Arguments:
161 get_default_path, gdp
162    the operation to be performed.
163 
164 
165 :Info: bjmc.open: bjmc.o:  1985-04-05  bjmc open operation
166 
167 Syntax as a command:  bjmc o PATHs
168 
169 
170 Syntax as an active function:  [bjmc o PATHs]
171 
172 
173 Function: opens the before journals specified by PATHs.  The active
174 function returns true if the journals are opened successfully, false
175 otherwise.
176 
177 
178 Arguments:
179 open, o
180    the operation to be performed.
181 PATHs
182    are the absolute or relative pathnames of before journals to be
183    opened in your process.  You can use -pathname (-pn) to specify the
184    journal path.  If you supply no .bj suffix, it is assumed.
185 
186 
187 Notes: If no journal has been specifically designated as the default
188 (see the set_default_path operation) for your process, the last before
189 journal opened in the process becomes the default.  If no journal is
190 opened in your process when a transaction is started, the system before
191 journal is opened and used as the default.
192 
193 
194 :Info: bjmc.opened:  1985-04-05  bjmc opened operation
195 
196 Syntax as a command:  bjmc opened PATH
197 
198 
199 Syntax as an active function:  [bjmc opened PATH]
200 
201 
202 Function: returns true if the before journal specified by PATH is
203 opened in your process, false otherwise.
204 
205 
206 Arguments:
207 opened
208    the operation to be performed.
209 PATH
210    is the absolute or relative pathname of a before journal.  You can
211    use -pathname (-pn) to specify the journal path.  If you supply no
212    .bj suffix, it is assumed.
213 
214 
215 :Info: bjmc.set_default_path: bjmc.sdp:  1985-04-05  bjmc set_default_path operation
216 
217 
218 Syntax as a command:  bjmc sdp PATH
219 
220 
221 Syntax as an active function:  [bjmc sdp PATH]
222 
223 
224 Function: sets the default before journal for the process to the
225 specified pathname.  The active function returns true if the pathname
226 is successfully set, false otherwise.
227 
228 
229 Arguments:
230 set_default_path, sdp
231    the operation to be performed.
232 PATH
233    is the absolute or relative pathname of the before journal to be
234    used as the default by your process.  You can use -pathname (-pn) to
235    specify the journal path.  If you supply no .bj suffix, it is
236    assumed.
237 
238 
239 Notes: If no default before journal is set for your process, the last
240 journal opened in the process is used as the default (see the open
241 operation).  If no before journal is open in the process when a
242 transaction is started, the system before journal is opened and used as
243 the default.
244 
245 
246 :Info: bjmc.set_attribute: bjmc.sattr:  1985-04-05  bjmc set_attribute operation
247 
248 
249 Syntax as a command:  bjmc sattr PATHs -control_arg
250 
251 
252 Syntax as an active function:  [bjmc sattr PATHs -control_arg]
253 
254 
255 Function: sets an attribute of the before journals specified by PATHs.
256 The active function returns true if the attribute is successfully set,
257 false otherwise.
258 
259 
260 Arguments:
261 set_attribute, sattr
262    the operation to be performed.
263 PATHs
264    are the absolute or relative pathnames of the before journal(s) to
265    have attributes set.  You can use -pathname (-pn) to specify the
266    journal path.  If you supply no .bj suffix, it is assumed.
267 
268 
269 Control arguments:
270 -transaction_storage_limit N, -tsl N
271    specifies the maximum number of bytes a single transaction can use
272    in the before journals.  An attempt to write more bytes than allowed
273    causes the transaction_bj_full_ condition.  A value of zero
274    indicates a transaction can use an entire journal (the default at
275    journal creation time).
276 
277 
278 Notes: When this operation completes, the before journal header
279 containing the new attributes is not guaranteed to be flushed if the
280 journal is active.  Any changes do take effect immediately for current
281 user of the journal.
282 
283 
284 :hcom:
285 
286 
287 
288 
289 /****^  HISTORY COMMENTS:
290   1) change(2020-05-29,GDixon), approve(2021-02-22,MCR10088),
291      audit(2021-05-27,Swenson), install(2021-05-27,MR12.6g-0056):
292      Change to Operations Format info segment, and correct problems reported by
293      verify_info tool.
294                                                    END HISTORY COMMENTS */
295 
296 
297