-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathBRO.DOC
276 lines (191 loc) · 10.7 KB
/
BRO.DOC
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
BRO - Browse library catalogs offline
Version 1.26d
Function:
BRO allows you to view forum library catalogs, either
complete catalogs or IBMNET summary files, search for files
of interest thru a variety of methods, and generate an Autosig
script for fast downloading of those files you've selected.
Syntax:
BRO [forum.dl]
where "forum" is the exact forum name, 1 to 7 characters
"dl" is a number from 0 to 17
if omitted, you are prompted for the forum name, etc.
Input:
The DL catalog file is created by capturing the output of
a CAT /DES command while online.
Output:
A file called "DL.SCR" is created if any entries are M)arked and
the D)ownload function is selected from the main screen. Any previous
DL.SCR files are overwritten.
Catalog file structure:
#1 - transaction file; capture of CAT/DES, or .SUM file input
#2 - optional .SCR script output file
#3 - data for DL/LIB entries (.DAT)
.INX - index to .DAT entries
SORTF.COM and SORTF.DOC are also included in the distribution file.
SORTF.COM is used for sorting the BRO database and must be in the
current directory or in your path.
While not needed for operation of BRO check out the docs for SORTF
as you might find other uses for it. It's highly flexible and an
excellent replacement for the DOS SORT program.
BRO data files:
Prior to starting BRO you should have a library catalog
available to you. BRO accepts catalogs in two formats:
IBMNET summary file format. Summary files are one line
entries of library files and can be found in library 0 of
most IBMNET forums (all except PCVENx and IBMJR). The name of
the summary file changes depending on the forum but BRO
/KEY=SUMMARY will always display it.
Full catalog files. These are catalogs that are created if
you use a SCA /DES command (for non-stop, or, if you will, if
you were BROwsing a file). The command:
SCA /DES
will give you files in non-stop mode or you can download the
files in compressed format in library 0 of each IBMNET forum.
Like the summary files the names of the files change but
they are the "quick reference word" names for each forum;
that is for IBMCOM the filename is IBMCOM.ZIP.
If you're not familar with how to manually catalog a library
please consult the file LIB.HLP in the Download Help library (lib 1)
of IBMNEW.
BRO is also compatible with the output of DLSCAN which is located
in the Autosig library (lib 1) of IBMCOM. DLSCAN is an ATO script
generator like BRO that will catalog a single library or multiple
libraries, via a script, on a number of criteria. High recommended.
Starting BRO:
If you start BRO without any arguments you'll get the
following menu:
A U T O S I G
-----------------
Browse Forum Catalog
Forum: DL:
--------------------------------------------
(B) Browse current ATO catalog
(D) Download selected files
(A) Add to catalog from CAT/DES
capture file
(U) Update catalog from DL summary
file
(S) Sort catalog by forum, DL,
filename
(K) Delete current ATO catalog
(Q) Quit, return to DOS
¯ ® Select one
--------------------------------------------
The first time you use BRO you'll need to add a catalog from
a library capture (discussed above) or from a summary file.
If you're using a full catalog file select the (A)dd
function. If you'll be using a summary file select the
(U)pdate function.
Important note: Do NOT attempt to use both summary files AND
full catalog files. This will cause confusion.
When you select (A) or (U) you'll receive the following
screen:
A U T O S I G
--------------------
Browse Forum Catalog
Forum: DL:
File name :
Forum name:
DL number :
Press PgDn when ready.
Press ESCape to abort.
The file name entry should be the name of the file that
contains the catalog (IBMCOM.CAT or whatever). The forum name
entry is critical; it should be the same name as the forum
name set up in Autosig. The library number can be set to
0 if the library number is embedded in the catalog, otherwise
use the starting library number of your catalog.
Browsing files:
When you select the B(rowse) function you'll receive a
display of the first file in the catalog. The format is as
follows:
A U T O S I G
--------------------
Browse Forum Catalog
Forum: IBMNEW DL: 1
[76703,750]
LIB.HLP [SEL] 31-Jul-88 30290 1371
Keywords: LIB LIBRARY DATABASE PROGRAMS FILES DOWNLOAD HELP
Everything you need to know in order to download from the
Libraries. Explains how to use the various protocols, the
various types of files (ARC, etc.), how to set your CIS
"defaults", how to find files of interest and some solutions
to common problems. Please leave a message for the SysOps if
you have any problems. To get this file just use the <R>ead
command and capture to disk, a protocol DOWnload is not
necessary. [Rev. 5/88, previous count = 9947].
Enter Home End M)ark O)mit C)omments F)ind A)gain Q)uit ?
In this example the file has been M)arked and the [SEL]
"flag" to the file of the filename indicates that it has been
selected for download.
BRO keys:
The up and down arrow keys move forward or backward one file
at a time.
The home key takes you to the top of the file.
The M key marks a file for downloading.
The O key unmarks a file that has been selecting for
downloading.
The C (comment) key is not implemented at this time.
The F (find) key allows you to search for a specific string.
Case is not significant.
The A (again) key allows you to repeat a find.
The Q (quit) key terminates the BRO session and returns you
to the main menu.
Generating a download script:
After marking files for download Q(uit) the current marking
session and return to the main menu and select the Download
Selected Files function. This will generate a script to
download the files. In addition to filenames and library
locations "GO" words for forums will be generated as well.
The script will be named DL.SCR.
Note: The Download function overwrites any previous DL.SCR
files!
At the time the DL.SCR file is created the [SEL] flag on any
selected file is changed to [DOW] (so you know that you've
downloaded it!).
Executing the script:
From Autosig on-line mode hit Alt-T and reply DL to the
script name prompt. DL.SCR will log you onto the first forum
in the DL.SCR script, select the first library, download the
file(s) and continue to other libraries and other forums. BRO
automatically inserts a logoff at the end of the script. If
you wish you may edit the script and pass off DL.SCR to an
ATO auto pass. Any text editor or word processor that will
produce standard ascii files will work just fine for
modifying the script.
Cautions:
The actual download syntax for a complete catalog is:
DOW FILENAME.EXT[USER_ID]
As the user id of the uploader isn't carried in a summary file
this information is not available.
Thus if there are two files of the same name the library software
will display the filenames and ask for a selection. DL.SCR is not
capable of handling this condition.
Legal and other stuff:
This program is, of course, offered as is. We can't
guarantee it will work on every permutation of equipment. We
will make an honest effort to correct and/or add any features
that you ask for. If you do have a problem please be sure
and let us know.
Copying and sharing BRO:
This document and the BRO.EXE file comprise the BRO program
("software"). This software is copyrighted material and is
subject to limitations by the copyright holders ("authors")
as to its use and distribution.
You may use the software; make copies of the software; give
copies to anyone; and distribute it via electronic means.
There is no charge for this software, but you must include a
copy of this document file with any copies that you make.
You are specifically prohibited from charging or requesting
donations for any copies; from modifying the software; from
distributing the software with commercial products without
prior written permission; and from distributing this
software, either alone or with other material, if any fee is
charged. There are no exceptions without written permission.
There is no warranty of any kind given. The authors are not
liable for damages of any kind. By using this free software,
you agree to this.
The software and documentation are:
Copyright (C) 1989, 1990 by Vernon D. Buerg and Don W. Watkins