How do I know if my server supports XHDR? Try to get a subject list with XOVER enabled. If there are no articles found, you should disable this option.
Some newsservers DO support XOVER but they use a different implementation. This can produce scrambled subject lists. In that case, you should also disable the XOVER commands.
If you want to try other public newsservers, you should visit the site at http://login.eunet.no/~kjetilm/news.htm which contains a directory of public newsservers.
UUDEVIEW.EXE -i +d -p D:\DOWNLOAD %
where D:\DOWNLOAD is the path you want to have the decoded files saved.
Please note:
Please note:
On the second page you can specify the maximum number of article headers you want to receive at a time. The remaining article subjects are not lost; you can get them after marking the received article subjects 'as read'. Use this options if you have very large newsgroups which use too much time or memory. Another option allows to specify the minimum number of text lines an article must contain. BNR doesn't display articles having less lines than specified. Be aware: It is possible to suppress the (small) last part of a multi-part article when specifying a minimum number of lines. The disabled option "Eliminate crossposted articles" isn't available yet.
It is possible that BNR receives slightly more or less articles than specified in the value mentioned above. This is because a newsserver only delivers an estimated value of available articles. BNR reduces the number of the highest article number to match the maximum number of articles to load. If the estimated value received from the newsserver was not correct, the result can slightly differ.
Blocker
On this page you can maintain a list of e-mail identifications of authors you want to exclude (block) from your subject list. Articles from one of those authors won't be displayed on the screen. You can also add an author to the blocklist using the Ctrl+B command on the main window. There, you'll add the author of the currently selected article to the blocklist. You can also add generic E-Mail IDs to the blocklist. They must have the format *@myhost.net
. This would exclude all posts submitted by an E-Mail address at myhost.net.
Hangup
This command is used to hang up when "Hangup now" or "Hangup after download" is selected on the main window. If you are connected to the Internet through a network (a leased line), you just can ignore this. Usually, the hangup command tells the dialer to hang up.
Decoder
These commands are used to decode the UUE- or BASE64-coded downloaded articles' content. Substitute a '%' for the name of the file to be decoded. A valid command could be 'DECODER.EXE -d %'. If you have a decoder which is able to decode both UUE- and BASE64-coded articles (such as UUDEVIEW) or if you want to write your own batchfile to decide which decoder shall be used, you can enable the "General decoder" option. If you have this option enabled, BNR doesn't analyze the received data, which can be slightly faster. Furthermore, BNR never calls the editor to display unrecognized articles. If you want to do so, you can select "Remove received articles from list". This removes received articles immediately from your subject list. If you do not select this option, received articles get a "REC" marker. You shouldn't remove downloaded articles from your list if you want to reply to one of them. You can automatically mark downloaded articles 'as read'. They won't be displayed the next time you reload the headers of this newsgroup (or they already have a "REC" marker). However, from time to time, you still have to mark the entire newsgroup 'as read' (up to a certain article number) to mark all unwanted articles as well.
If you use UUDEVIEW, you can use the following command: UUDEVIEW.EXE -i +d -p D:\DOWNLOAD %
where D:\DOWNLOAD is the path you want to have the decoded files saved.
There is one more variable available: Use the %N
variable to decode the articles of different newsgroups to different subdirectories. BNR replaces the %N variable with the name of the current newsgroup. Be sure to create the directory prior to use.
Encoder
This command is used to encode binary files you are uploading (posting) to a newsserver. Substitute a '%' for the name of the file to be encoded. If you do not want to upload your own binary files using the BNR you can ignore this page. UUE is the only supported encoder type.
Servers
You can specify the names of two newsgroup servers. They are used as a primary and alternate (backup) server. You can specify the name of the server or the IP-adress (in the format nnn.nnn.nnn.nnn) of the server. In the first case, BNR will ask the TCP/IP defined nameserver for the appropriate IP-address of your newsserver. If your newsserver doesn't listen at port 119, you can specify a different port using a server address like 'myserver.net:nnn' where nnn is your new port number. The option "Use XOVER NNTP command" should be checked if your server supports the XOVER command. If you can receive a correct subject list with XOVER enabled, you can leave it that way. If you get an empty (or scrambled) list, you can disable XOVER (which enables the usage of XDHR). For a detailed description see Chapter 3.0 'The newsserver'.
Posting
This information is used when sending (posting) articles to the server. Enter your real Mail-ID here! Your registration name is automatically added to your Mail-ID: "ralf.christen@ibm.net" gives ralf.christen@ibm.net (Ralf Christen)". If you want to have replies to a different address, you can specify this address in the "Reply to" field. If you want to have the name of your organization in the header information of your article, you can enter this in the "organization" field. The field "Timezone" is to specify the timezone of your location. Usually, you refer to the next known timezone (such as GMT, EST etc) and specify the appropriate offset (GMT+1, EST-1 etc). You can use test newsgroups (alt.test) to test your postings.
Prompt
If you receive an article which cannot be decoded, (neither UUE nor BASE64), you can display the content on the screen, using an editor of your choice. This function is used to display non-binary articles (maybe an announcement of an upcoming binary file) which contain text. Because BNR is a binary newsreader, this shouldn't be the usual case. However, there are 3 options: "Always display", "Display if automatic hangup is disabled" (to avoid the display of many articles while being in unattended mode) and "Never display". Valid OS/2 editor commands can be "E.EXE", "EPM.EXE" or any oder OS/2 editor
which is currently installed on your system.
Register
Here's the place to fill in the registration information you have received from the BMT Micro Shareware Registration. If you have questions on how to register, see Chapter 9.0 'Registration'.
Display
You can use the OS/2 functions to customize to following objects of the BNR screens:
Logon
Some servers require a user identification and password to log on. If you want to connect to one of those servers, you can enter the logon information on this screen. Newsservers of access providers do not require a login, because they test your IP adress to grant access. In that case you have to leave the fields blank!
Options
The BNR can ask you if you really want to quit. There are two options "Confirm leaving BNR" and "Confirm leaving BNR with jobs in queue" to enable this function. If you want to have a copy of the receiver job queue saved to disk, you should enable "Save reciever job queue to disk". Then, you can terminate and restart the BNR anytime and continue working with your receiver queue. Sometimes, the receiver task can fail due to a communication or server error. A "watchdog timer" checks the active connection every few minutes and restarts a failed receiver job.
On the second page you can enter the name of the Web Browser you want to use for actions such as sending mail, reading the documentation or going to web pages.
Logging
If you are processing scripts, you do not want the BNR to display error messages in a message window. There are several logging options available when processing BNR scripts:
C:\SYSLOG\LOGGER.EXE -t BNR %
Option | Impact | When |
---|---|---|
Eliminate crossposted articles | CPU | Receiving headers |
Mark received articles 'as read' | Harddisk | Put articles into queue |
Use of XOVER disabled | Line | Receiving headers |
Save receiver queue to disk | Harddisk | Whenever the queue changes |
Important: If you mark received articles automatically 'as read' you should reorganize the BNR.MRK file from time to time. The BNR.MRK file is a OS/2 INI-file which can grow very fast and slow down the entire BNR work (heavy disk work when pressing the RECEIVE button). Because the OS/2 INI-file management still hasn't an effective algorithm to reduce deleted records you have to do this manually using a utility software such as INIMAINT. In some cases, this reduces the BNR.MRK file size by 90%. This also applies to BNR.INI.
/D | starts BNR in debug mode. Use this function if you have to submit an error report after one of these symptoms: - BNR closes after an error without further information - OS/2 issues SYS3175 (GUI problem). |
/CS | connects automatically to the newsserver after starting and gets the newsgroup status. |
/I= | Specify a different path for the internal BNR work files. The example /I=D:\DATA tells BNR to put the work files to the D:\DATA directory. Use this in a Client/Server environment (to force saving personal work files on the clinet) or to connect to different access providers with different newsservers. |
/R | Restarts a reloaded receiver queue automatically when starting BNR. |
/MIN | Start minimized |
/S | Removed since V1.20 |
/C | Removed since V1.25 |
This is the complete syntax diagram:BNR.EXE [/D] [/CS] [/MIN] [/I=datapath] [/R] [script.bsc]
BNR.INI | Configuration settings, subscribed newsgroups |
BNR.GRP | Plain ASCII-file of all available newsgroups |
BNR.MGP | Plain ASCII-file of top level hierarchy of all newsgroups |
BNR.MRK | Single marked articles |
BNR.QUE | Plain ASCII-file of the saved receiver job queue |
You can redirect the path of those files using the /I command line parameter.
CONNECT n
Doesn't really connect to your newsserver but selects your server where 'n' can be 1 or 2. 1 means your primary server, 2 means your secondary server. If you omit 'n', you select your primary server.
END
This command ends the script immediately. Use it you want to end script execution within a script.
EXECUTE pgm parms
The EXECUTE command provides a handy way to execute OS/2 commands while processing scripts. The following command example can be used to call the PKZIP packer: EXECUTE D:\PACKER\PKZIP.EXE PICS.ZIP E:\DOWNLOAD\*.JPG
If you want to use an internal OS/2 command (such as DIR, COPY or TYPE), you have to call the CMD.EXE program like this: EXECUTE CMD.EXE /C COPY E:\DOWNLOAD\*.JPG A:
FILTER f1 f2 f3 f4 f5 f6
The FILTER command overrides the 6 filters defined on the 'Filter' page of the configuration notebook. If you omit one or more of the 6 possible filters, they are blanked out and are not in use.
GOTO xxx
Jump to the script line containing the label 'xxx' which has been defined using the LABEL command.
GROUP xxx
Switches to the newsgroup 'xxx' and receives the list of subject headers. You can even switch to newsgroups you are not subscribed to.
HANGUP
Just hangs up using the 'Hangup' command specified in the configuration notebook.
LABEL xxx
This command defines a label 'xxx' which can be reached using the GOTO or ONERROR command.
MARKREAD
Marks all articles in the article list 'as read'. This command must be after a GROUP command because it marks all articles as read that have been loaded using GROUP.
MESSAGE xxx
You can send your own message to the BNR logfile or to your external logging utility (see the 'Logging' page of the configuration notebook). Use this command to write additional information to your log; error messages issued by BNR are being logged anyway.
ONERROR xxx
This command defines to go to the label 'xxx' if we encounter a problem during script processing. The label must be defined using the LABEL command. If you omit the label 'xxx', BNR ignores errors and continues with the next script line.
PAUSE
This command suspends the execution of your script and returns control to the BNR. You can continue or stop the execution using the appropriate options on the menubar (-> Scripts).
QUIT
This ends the script and quits the BNR immediately without further notice.
RECEIVE
Puts the selected articles to the receiver job queue. This command must be after one or more SELECT commands because it receives the articles evaluated by SELECT.
SELECT xxx yyy zzz ...
This selects articles to download from the subject headers which contain the string 'xxx' AND 'yyy' AND 'zzz' in their subject or author-id. You can specify as many strings as you want. If you have the 'auto subpart detect' feature enabled (what I recommend), this also selects all subparts to download. Be sure NOT to mark subparts; this will the mentioned 'auto subpart feature' do for you; therefore you should include a SELECT like '1/'. Please note that the parameters of this command are NOT case sensitive. This command must be after a GROUP command because it processes article headers received by GROUP.
TRACE ON|OFF
You can turn on the script trace using the TRACE ON command which enables logging of every script command. Use TRACE OFF to turn the command logging off.
WAIT
Waits until the receiver job queue is empty and all articles have been received. You can stop the execution of WAIT using the appropriate option on the menubar (-> Scripts). Issue a WAIT command after a RECEIVE but before a QUIT, END or HANGUP command.
CONNECT 1 | Select the primary newsserver |
GROUP alt.binaries.pictures | Switch to alt.binaries.pictures |
SELECT .JPG 1/ | Select all 1st part JPG files |
RECEIVE | Put them to the receiver job queue |
MARKREAD | Mark them 'as read' |
GROUP alt.binaries.pictures.nature | Switch to alt.binaries.pictures.nature |
SELECT sunset 1/ | Select all 1st part sunset pictures |
RECEIVE | Put them also to the job queue |
MARKREAD | Mark them 'as read' |
WAIT | Wait until all articles have been received and the queue is empty |
HANGUP | Hang up |
And here's an example with error processing:
MESSAGE The script starts now | Send a message to the log |
CONNECT 1 | Select the primary newsserver |
ONERROR ERRLABEL1 | Define the error exit label 1 |
GROUP alt.binaries.pictures | Switch to alt.binaries.pictures |
SELECT .JPG 1/ | Select all 1st part JPG files |
RECEIVE | Put them to the receiver job queue |
MARKREAD | Mark them 'as read' |
GOTO RECEIVE2 | Jump to label RECEIVE2 |
LABEL ERRLABEL1 | This is the error exit label 1 |
MESSAGE Error in alt.binaries.pictures | Send a message to the log |
LABEL RECEIVE2 | Define the label RECEIVE2 |
ONERROR ERRLABEL2 | Define the error exit label 2 |
GROUP alt.binaries.pictures.nature | Switch to alt.binaries.pictures.nature |
SELECT sunset 1/ | Select all 1st part sunset pictures |
RECEIVE | Put them also to the job queue |
MARKREAD | Mark them 'as read' |
GOTO WAIT-FOR-END | Jump to label WAIT-FOR-END |
LABEL ERRLABEL2 | This is the error exit label 2 |
MESSAGE Error in alt.binaries.pictures.nature | Send a message to the log |
LABEL WAIT-FOR-END | Define the label WAIT-FOR-END |
ONERROR | Ignore errors |
WAIT | Wait until all articles have been received and the queue is empty |
HANGUP | Hang up |
Where are the text files stored ?
Downloaded UUE or BASE64 articles are stored in the BNR directory with names like ARTnnnnn.TMP and are deleted after the decoding process. Plain text articles remain there.
My decoder does not work (but it's configured correctly)
How does the automatic subpart detector work ?
This feature automatically finds and marks subparts (articles which are made of more than one part) after you have doubleclicked the first part. Usually, their headers contain some text, indicating the sequence of this part and the total number of all parts (eg 01/05 means part 1 of 5). BNR recognizes subject headers which contain the following strings as a first-part article: '(1/' or '(01/' or '[1/' or '[01/'. Of course, the number behind the slash must have a value other than 1 otherwise it would be a single-part article. BNR starts with its search with the article following the marked 1st part and automatically stops if all parts have been found. If it reaches the end of the list it restarts from the top down to the 1st part. If some subparts are missing, a message is displayed.
How can I unmark an article which I have marked to download ?
You can unmark an article with a simple doubleclick. If it's already in the receiver job queue, you can use the 'Delete entry' function on the menubar. However, you cannot delete the entry being received right now.
In that case, you have to stop the receiver job queue, delete the entry and restart the queue.
How does the BNR determine if we have a UUEncoded or a BASE64 article?
UUEncoded files do have a string like 'begin nnn' at the beginning of a new line. BASE64 articles must have the keyword 'base64'. However, if you have selected to use a 'general decoder', BNR doesn't determine the coding scheme.
Sometimes, the automatic subpart feature doesn't recognize parts 2 to 9
There may be an article which is marked with different 'madeof' lengths such as [1/14] [2/14] .... [10/14] .... [14/14]
. The correct markers should be (if >9 parts): [01/14] [02/14] .... [10/14] .... [14/14]
. BNR identifies an article as a subpart if the following is true: Exact the same subject after removing the bytes between '[' and ']' or '(' and ')' of the first part. If the first part contains a [1/14]
let's say at position 35, the subparts must have the same subject ignoring the bytes 35 to 40. If the subpart contains a longer madeof-marker, this test fails.
Will there ever be a Windows 95 version of this software ?
No.
What the hell am I doing here?
You're reading the documentation
There are many ways to register:
The progress bars do not adjust when resizing the window
*@myhost.net
. This would exclude all posts submitted by an E-Mail address at myhost.net.
F5
key.