                                                  NEWSRDR User's Guide                 October, 1993       ;           This manual describes NEWSRDR, an NNTP-based news !           reader for VMS systems.         A           Revision/Update Information:  This is a revised manual.   >           Operating System and Version: VAX/VMS V5.0 or later;A                                         OpenVMS AXP V1.0 or later   4           Software Version:             NEWSRDR V4.5                 Matthew Madison            MadGoat Software                                                       "           ________________________           09 October 1993   =           Permission is granted to copy and redistribute this *           document for no commercial gain.  ?           The information in this document is subject to change 9           without notice and should not be construed as a 9           commitment by the author. The author assumes no ?           responsibility for any errors that may appear in this            document.   <           DISCLAIMER: The author, the author's employer, and@           MadGoat Software make no representations or warranties>           with respect to the contents hereof and specifically?           disclaim any implied warranties of merchantability or -           fitness for any particular purpose.   ;           The following are trademarks of Digital Equipment            Corporation:  8           AXP                DEC                 OpenVMS            VAX                VMS             __________@           Copyright 1993 MadGoat Software. All Rights Reserved.                       A           _______________________________________________________              Contents  A                 _________________________________________________ A                 PREFACE                                       vii   A                 _________________________________________________ A                 NEW AND CHANGED FEATURES                       ix   A           _______________________________________________________ A           CHAPTER 1  USING NEWSRDR                            1-1   A                 _________________________________________________ A                 1.1   USING NEWSRDR FOR THE FIRST TIME        1-2   A                 1.1.1     Cancelling a Subscription  _____    1-2   A                 _________________________________________________ A                 1.2   READING NEW NEWS                        1-3   A                 1.2.1     Redisplaying an Article  _______    1-3   A                 1.2.2     Following a Thread  ____________    1-4   A                 1.2.3     Reading by Subject  ____________    1-4   A                 _________________________________________________ A                 1.3   SKIPPING ARTICLES                       1-5   A                 _________________________________________________ 0                 1.4   MARKING ARTICLES FOR LATERA                       REFERENCE                               1-5   A                 _________________________________________________ 4                 1.5   PERMANENTLY IGNORING TOPICS ORA                       AUTHORS                                 1-6   A                 1.5.1     Removing Ignore Settings  ______    1-6   A                 _________________________________________________ A                 1.6   READING SPECIFIC ARTICLES               1-7   A                                                               iii                     Contents          A                 _________________________________________________ A                 1.7   SAVING ARTICLES                         1-7   A                 _________________________________________________ A                 1.8   PRINTING ARTICLES                       1-8   A                 1.8.1     Specifying PRINT Defaults  _____    1-8   A                 _________________________________________________ A                 1.9   POSTING ARTICLES                        1-9   A                 1.9.1     Followup Articles  _____________   1-10   A                 1.9.2     Cancelling an Article  _________   1-10   A                 _________________________________________________ A                 1.10  SENDING MAIL MESSAGES                  1-10   A                 _________________________________________________ A                 1.11  PROFILE SETTINGS                       1-11   A                 1.11.1    Personal Name  _________________   1-11   A                 1.11.2    Article Headers  _______________   1-12   3                 1.11.3    Automatic Editing, Editor A                           Name  __________________________   1-12   A                 1.11.4    Signature  _____________________   1-13   A                 _________________________________________________ A                 1.12  SUBPROCESSES                           1-13   A                 _________________________________________________ A                 1.13  KEYPAD KEYS                            1-14   A                 _________________________________________________ A                 1.14  SETTING YOUR REPLY-TO ADDRESS          1-14   A                 _________________________________________________ A                 1.15  HEADER CACHING                         1-14   A                 _________________________________________________ A                 1.16  MOVING YOUR NEWSRDR PROFILE            1-15              iv         A                                                          Contents           A                 _________________________________________________ A                 1.17  USING A NEWSRC FILE                    1-15   A                 1.17.1    Specifying Newsgroup Order  ____   1-16   A           _______________________________________________________   '           PART II  COMMAND DESCRIPTIONS :                 ATTACH                               CMD-3:                 BACK                                 CMD-4:                 CANCEL                               CMD-5:                 CURRENT                              CMD-6:                 DEFINE/KEY                           CMD-7:                 DIRECTORY                           CMD-10:                 DIRECTORY/GROUP                     CMD-13:                 EXIT                                CMD-15:                 EXTRACT                             CMD-16:                 FOLLOWUP                            CMD-18:                 FORWARD                             CMD-19:                 GROUP                               CMD-21:                 HELP                                CMD-22:                 MAIL                                CMD-23:                 NEXT                                CMD-25:                 POST                                CMD-26:                 PRINT                               CMD-29:                 READ                                CMD-33:                 REPLY                               CMD-36:                 SET ARCHIVE_DIRECTORY               CMD-41:                 SET AUTO_READ_NEW                   CMD-42:                 SET AUTO_SAVE_PROFILE               CMD-43:                 SET DIRECTORY_WIDTH                 CMD-44:                 SET EDIT                            CMD-45:                 SET FORCE_MAIL_PROTOCOL             CMD-48:                 SET FORM                            CMD-49:                 SET HEADERS                         CMD-50:                 SET IGNORE                          CMD-53:                 SET NEWGROUP_ACTION                 CMD-55:                 SET NEWSRC                          CMD-56:                 SET PERSONAL_NAME                   CMD-58  A                                                                 v                     Contents          :                 SET QUEUE                           CMD-59:                 SET REPLY                           CMD-60:                 SET SEEN                            CMD-61:                 SET SIGNATURE                       CMD-63:                 SET UNSEEN                          CMD-65:                 SHOW                                CMD-67:                 SPAWN                               CMD-70:                 STORE                               CMD-73:                 SUBSCRIBE                           CMD-74:                 UNSUBSCRIBE                         CMD-76:                 UPDATE                              CMD-78    A           _______________________________________________________            FIGURES   0                 CMD-1     Spawned editor commandA                           procedure  _____________________ CMD-47   A           _______________________________________________________            TABLES  A                 CMD-1     Header names  __________________ CMD-50                                              vi                   A           _______________________________________________________              Preface   9           There are several USENET news-related utilities =           available for VMS, some of which provide full local =           storage of news and UUCP protocol support, and some <           of which provide emulation of various network news-           readers available for UNIX systems.   <           With the advent of NNTP, it becomes easier to gain<           access to USENET news by using one local system to=           store news and using "remote" news readers on other            systems.  =           The NEWSRDR utility provides an interface to USENET 9           news that should be more familiar to VMS users. ?           NEWSRDR attempts to follow the conventions of the VMS @           MAIL utility in its presentation and command structure           whenever possible.  L           __________________________________________________________________             Intended Audience   >           This manual is intended for all users of the NEWSRDR@           utility and system managers responsible for installing!           and setting up NEWSRDR.   L           __________________________________________________________________             Document Structure  @           This document consists of two parts. The first briefly@           describes how to use NEWSRDR. The second describes all,           of the NEWSRDR commands in detail.  L           __________________________________________________________________             Related Documents   >           The reader is assumed to know something about USENET@           news, and should probably have as a reference Internet@           RFC 1036, Standard for Interchange of USENET Messages,?           which explains the structure of USENET news articles. >           The system manager should also have RFC 977, Network  A                                                               vii                     Preface           ;           News Transfer Protocol, which describes NNTP news            service.                                                                                       viii                   A           _______________________________________________________   "           New and Changed Features  @           See the file AAAREADME.TOO in the NEWSRDR distribution,           kit for a complete change history.                                                                      A                                                                ix                      A           _______________________________________________________       1      Using NEWSRDR       ?           NEWSRDR is designed to be executed as a VMS "foreign" <           command. To set up the command symbol, you need to@           know where the NEWSRDR executable image is located for           the command:  ;                            $ NEWSRDR :== $disk:[dir]NEWSRDR   @           Once the symbol is set up, you can invoke NEWSRDR with           the command:  $                            $ NEWSRDR  5           The NEWSRDR command can take one qualifier: 9           /[NO]UPDATE. The default is /UPDATE=FULL, which <           causes NEWSRDR to obtain information from the NNTP@           server about all available newsgroups. You can specify;           /UPDATE=PARTIAL, which has the same effect as the :           UPDATE/PARTIAL command, or /NOUPDATE, to have no           updates occur at all.   ;           You can also specify /UPDATE=BOTH, which causes a ?           full update to occur, immediate followed by a partial <           update. This may be needed at some sites where the<           news server's "active" file is not kept up-to-date?           with the low-bound article number for its newsgroups. @           If you get extraneous "new articles" messages with the>           default NEWSRDR update behaviour, using /UPDATE=BOTH5           should eliminate those extraneous messages.             A                                                               1-1                     Using NEWSRDR         L           __________________________________________________________________  *    1.1    Using NEWSRDR for the First Time  =           If you have never used NEWSRDR before, NEWSRDR will >           inform you that it cannot find a NEWSRDR profile and?           that it will create one for you. Your NEWSRDR profile =           contains information about which editor you use for ?           composing messages, which article headers you wish to =           see when reading articles, and which newsgroups you <           are subscribed to. It is by default placed in your=           login directory and is called NEWSRDR_PROFILE.NRPF.   >           To start reading news, the first thing you will need=           to do is to subscribe to one or more newsgroups. If <           you already know what newsgroups are available and>           which ones you want to subscribe to, you can use the;           SUBSCRIBE command right away to subcribe to those            groups:   D                            News> SUBSCRIBE newsgroup [,newsgroup...]  9           You can use wildcards in the newsgroup names to ?           subscribe to a collection of newsgroups with a single            command.  6           If you want to look at the list of available&           newsgroups, use the command:  4                            News> DIRECTORY/GROUP/ALL  <           Once you have subscribed to the newsgroups you are@           interested in, you should next use the EXIT command to>           leave NEWSRDR and save your subscription information>           in your profile. When you next start NEWSRDR, you'll)           be ready to begin reading news.   %           ___________________________   #    1.1.1  Cancelling a Subscription   9           The UNSUBSCRIBE command (format the same as for <           SUBSCRIBE, above) is used to cancel a subscription           to a newsgroup.   
           1-2          A                                                     Using NEWSRDR         L           __________________________________________________________________      1.2    Reading New News  6           Once you have subscribed to some newsgroups,;           information about which articles you have seen in =           those newsgroups is stored in your NEWSRDR profile.            The command   )                            News> READ/NEW   =           is used to start reading news articles you have not :           yet seen. This command is executed by default if>           you simply press RETURN at the first NEWSRDR command%           prompt, much like VMS MAIL.   ?           News articles are presented in a page-by-page format, =           also like VMS MAIL. At the bottom of each page, the :           number of remaining lines in the article and the@           message "Press RETURN for more..." will appear. Simply=           pressing the RETURN key will cause the next page of =           the article to be displayed. If you wish to skip to @           the next unseen article, you can use the READ/NEXT/NEW=           (or just NEXT) command. At the end of each article, ;           just pressing RETURN will have the same effect as !           entering READ/NEXT/NEW.   %           ___________________________   !    1.2.1  Redisplaying an Article   >           The CURRENT command is used to redisplay the article>           you are currently viewing from the beginning. If the=           article is encoded with the ROT13 cipher (sometimesS<           done for articles containing potentially sensitive?           or offensive material), you can read the encoded textn*           with the command CURRENT/ROTATE.        A                                                               1-3i                    Using NEWSRDR         %           ___________________________t      1.2.2  Following a Thread  =           You can use the READ command to follow a discussion_>           thread within a newsgroup. While reading an article,           entert  ,                            News> READ/THREAD  6           to cause NEWSRDR to scan forward through the;           newsgroup, displaying those articles that containe;           the same subject as the article you are currentlyh>           reading. Once started, just press RETURN to continue=           reading the thread. When there are no more articles =           with matching subject lines, the current article isa=           set back to the first article in the thread, so yout2           can continue reading where you left off.  %           ___________________________n      1.2.3  Reading by Subject  <           If you wish to read articles on a group of topics,@           you can use the READ/SUBJECT command to specify one or>           more wildcard patterns to match subject headers. For           example the command,  ;                            News> READ/SUBJECT=(*DEC*,*VAX*)s  9           would cause NEWSRDR to scan forward through the_<           newsgroup, displaying those articles whose subject)           headers contain "DEC" or "VAX"._  <           Once the first matching article is displayed, just?           pressing the RETURN key will page through the article_@           and continue the subject scan using the same patterns.=           If you don't want to see an entire article, use the_           command_  -                            News> READ/SUBJECTI  >           to move ahead to the next matching article. Once all=           matching articles have been found, the patterns are >           cleared and the current article is set back to where7           you were before doing the first READ/SUBJECT.   
           1-4  _  _    A                                                     Using NEWSRDRN        L           __________________________________________________________________      1.3    Skipping Articles   <           If you have just subscribed to a particularly busy?           newsgroup, you may wish to skip over all the articles =           already posted to the newsgroup and read only those_2           that are posted from now on. The command  C                            News> SET SEEN [/ALL] [article-range...]_  @           can be used to mark articles in a newsgroup as "seen",=           so they will not show up when you use READ/NEW. You <           can specify /ALL to mark all available articles as?           seen, or you can specify the articles to be marked by @           number (or use a dot to refer to the current article).<           A range of articles can be specified by giving the;           number of the first and last article in the range_=           separated by a hyphen (such as "23-45"; a dot (".")T?           can be used to refer to the current article, if there @           is one, and the keywords FIRST and LAST can be used to?           refer to the first and last available articles in the_?           newsgroup. Multiple numbers or ranges can be given by &           separating them with commas.  =           You can also use SET SEEN to skip over a collectionN;           of articles related to one topic. When reading an.           article, the command  0                            News> SET SEEN/THREAD  9           can be used to skip all further articles in theT?           newsgroup with subject text that contains the subject 2           of the article you're currently reading.  L           __________________________________________________________________  .    1.4    Marking Articles for Later Reference  <           If you have read an article or a group of articles?           that you want to come back to later, you can mark the_8           articles "unseen" with the SET UNSEEN command:  E                            News> SET UNSEEN [/ALL] [article-range...]_  ?           If you don't specify /ALL or any article numbers, the_-           current article is marked "unseen".   A                                                               1-5_ _  _               Using NEWSRDR         L           __________________________________________________________________  0    1.5    Permanently Ignoring Topics or Authors  7           If you wish to follow a newsgroup but are not =           interested in a particular topic being discussed in_;           the newsgroup, you can use the SET IGNORE command ;           to permanently ignore articles with subject lines_%           containing particular text:   H                            News> SET IGNORE [/GLOBAL] /SUBJECT="pattern"  <           The pattern you specify can contain VMS wildcards.>           Any articles in the newsgroup with subjects matching>           the pattern will automatically be skipped and marked@           "seen". If you wish to ignore matching articles in any/           newsgroup, use the /GLOBAL qualifier.   ?           If you wish to ignore articles posted by a particular_=           person, rather than about a particular subject, use7,           the /FROM qualifier on SET IGNORE:  E                            News> SET IGNORE [/GLOBAL] /FROM="pattern"   =           Any article with a From line matching the specified "           pattern will be ignored.  <           You can also ignore articles that are cross-posted=           to newsgroups you aren't interested in by using the4.           /NEWSGROUPS qualifier on SET IGNORE.  %           ___________________________   "    1.5.1  Removing Ignore Settings  ;           Ignore settings are kept in your NEWSRDR profile. @           After a particular thread or author has died down, you@           may wish to remove the ignore settings for a newsgroup(           with the SET NOIGNORE command:  V                            News> SET NOIGNORE [/GLOBAL] [/FROM="pat"] [/SUBJECT="pat"]  ?           You can find out what the ignore settings are for the 9           current newsgroup with the SHOW IGNORE command.   
           1-6          A                                                     Using NEWSRDRL        L           __________________________________________________________________  #    1.6    Reading Specific Articles   6           To read a particular article in a particular@           newsgroup, you first have to select the newsgroup with           the GROUP command:  2                            News> [GROUP] groupname  >           (Note that the word GROUP is optional.) You can then<           use the READ command, specifying the number of the#           article you wish to read:   5                            News> [READ] articlenumber   ?           (Note that the word READ is optional.) If you are not ?           sure of the article number, you can use the DIRECTORY <           command to obtain a listing of articles, including@           the article number, address of the article poster, and!           subject of the article:   M                            News> DIRECTORY [/SEEN] [/UNSEEN] [article-number]5  ;           If you specify an article number on the DIRECTORY 8           command, the directory listing begins with the=           specified article. Otherwise, the directory listing @           begins with the article you are currently reading, or,@           if you haven't read any articles, the first article in           the newsgroup.  <           Directory listings are presented in a paged format"           just like news articles.  L           __________________________________________________________________      1.7    Saving ArticlesW  :           You can save the text of any article or range of<           articles into a VMS file with the EXTRACT command:  U                            News> EXTRACT [/[NO]APPEND] [file-spec] [article-range...]M  >           If you omit the file-spec, the file name defaults to=           the current newsgroup name (with special characters >           translated to underscores), and /APPEND is turned on@           by default. You can specify a single article by number@           or an entire range or articles (see the description of  A                                                               1-7_ _  _               Using NEWSRDR           @           SET SEEN, above, for a description of article ranges).@           Multiple numbers or ranges can be specified, separated=           by commas. If you do not specify any article number <           at all, the current article is copied to the file.@           You must specify a file-spec if you want to specify an           article range.  L           __________________________________________________________________      1.8    Printing Articless  <           You can send any article or range of articles to a-           print queue with the PRINT command:n  9                            News> PRINT [article-range...]o  :           You can specify a single article by number or an>           entire range or articles (see the description of SET<           SEEN, above, for a description of article ranges).@           Multiple numbers or ranges can be specified, separated@           by commas. If you do not specify any article number at=           all, the current article is added to the print job.   =           A single print job is maintained by NEWSRDR for all_@           articles to be printed. The print job is released when@           you exit NEWSRDR or you use the PRINT/NOW command. You>           can cancel a pending print job with the PRINT/CANCEL           command.  ?           The PRINT command has several options for controlling =           the print job; see the complete command descriptions"           for further information.  %           ___________________________h  #    1.8.1  Specifying PRINT Defaultse  ;           You can define a default print queue with the SET_           QUEUE command:  5                            News> SET QUEUE queue-name   7           This will direct subsequent print jobs to the 4           specified queue, rather than to SYS$PRINT.  
           1-8          A                                                     Using NEWSRDRl          =           You can also define the default form to be used forr#           print jobs with SET FORM:   3                            News> SET FORM form-name   <           Use SET NOFORM to revert to using the queue's form           default.  ;           Both of these settings can be overridden by using >           the appropriate qualifiers on the PRINT command. The5           settings are saved in your NEWSRDR profile._  L           __________________________________________________________________      1.9    Posting Articles  ?           The POST command is used to post an article to one oro           more newsgroups:  U                            News> POST [/EDIT] [/[NO]SUBJECT="subject"] [groupname...]   ?           If you omit the "groupname", the article is posted to ?           the current newsgroup. The /EDIT qualifier is used to >           invoke a text editor to compose the article (see the>           description of the SET command, below). The /SUBJECT<           qualifier can be used to specify or omit a subject>           line for the article. If you do not use the /SUBJECT=           qualifier, you will be prompted for a subject line.   ?           Once you have been prompted for the text of your news <           article, or if editing, you have saved the article=           text with the text editor, you will be asked if you ?           really want to post the article. If you answer "yes", ;           or just press the RETURN key, the article will be =           posted. If you answer "no", the article will not be            posted.w  >           If you decide not to post an article, or the article>           posting fails for some reason, you will be given the=           opportunity to keep the file containing the article            text you entered.   A                                                               1-9d    e               Using NEWSRDRe        %           ___________________________e      1.9.1  Followup Articlesa  =           A followup article is a reply to a specific articleu?           which can either be posted or mailed to the author ofa>           the original article. You must be reading an article>           to send a reply. REPLY (or FOLLOWUP) command is used&           to compose and send replies:  a                            News> REPLY [/MAIL] [/POST] [/EDIT] [/NOEXTRACT] [/[NO]SUBJECT="text"]_  ?           By using the /POST and /MAIL qualifiers, you can poste@           your reply to the newsgroup, send it by mail, or both.<           If you do not specify /MAIL or /POST, the reply is<           posted. The /EDIT and /SUBJECT qualifiers mean the?           same as for the POST command. If you use an editor to =           compose the reply, the text of the original articlei=           is automatically placed in the reply (prefixed withp?           greater-than signs) before the editor is invoked. Theo?           /NOEXTRACT qualifier can be used to prevent this from            occurring.  %           ___________________________e      1.9.2  Cancelling an Article   >           If you post an article that you wish you hadn't, you>           can have the article removed from the news system by#           using the CANCEL command:   0                            News> CANCEL [artnum]  :           You must either specify the article number or be<           reading the article you wish to cancel in order to#           issue the CANCEL command.   L           __________________________________________________________________      1.10   Sending Mail Messagese  8           You can use the MAIL (or SEND) command to send:           messages to other users, which has much the same1           format as the SEND command in VMS MAIL:y  Z                            News> MAIL [/EDIT] [/TO=(address...)] [/SUBJECT="subj"] [fspec]             1-10 s  p    A                                                     Using NEWSRDRR          >           The only difference between this command and the VMS>           MAIL SEND command is the use of the /TO qualifier to@           specify the destination(s) of the mail message. If you>           omit the /TO qualifier, you will be prompted for the*           address(es) of the recipient(s).  =           Note that mail addresses within NEWSRDR are NOT theE>           same as for VMS MAIL, but are addresses used by your?           Internet mailer. For example, if you use PMDF's "IN%" :           prefix to direct mail to Internet addresses from=           VMS MAIL, you would not use that prefix in NEWSRDR; ?           NEWSRDR will tack the prefix onto the address for youh=           automatically when sending your message through VMS ;           MAIL. You also need to use quotation marks around 9           addresses only if you specify them with the /TO (           qualifier on the MAIL command.  L           __________________________________________________________________      1.11   Profile Settings  ;           NEWSRDR has several settings which you can changef@           with the SET command. These settings are saved in your>           NEWSRDR profile, preserved between NEWSRDR sessions.@           You can display the current settings with the SHOW ALL?           command, which will also display the node name of the <           news server and the name of the current newsgroup.  %           ___________________________m      1.11.1 Personal Namet  ;           Just as VMS MAIL allows you to set up a "personalt;           name" which is included with your address on your_9           outgoing mail, NEWSRDR allows you to do on news            articles you post:  >                            News> SET PERSONAL_NAME "your name"  >           You may use any name you like as your personal name.  A                                                              1-11g t  i               Using NEWSRDRo        %           ___________________________x      1.11.2 Article Headersd  :           News articles are generally accompanied by large8           numbers of header lines which identify various<           aspects of the articles, some of which you may not'           be interested in. The command   >                            News> SET HEADERS [NO]headername...  =           is used to turn on or off the display of particulare9           header lines when you read subsequent articles. ;           The header names you can specify are: FROM, DATE,e7           NEWSGROUPS, SUBJECT, MESSAGE_ID, PATH, REPLY_ 7           TO, SENDER, FOLLOWUP_TO, EXPIRES, REFERENCES, @           DISTRIBUTION, ORGANIZATION, KEYWORDS, APPROVED, LINES,;           and XREF. Specifying NO in front of a header name 7           turns off its display in subsequent messages.a  %           ___________________________   (    1.11.3 Automatic Editing, Editor Name  ?           If you would like to use a text editor every time you_=           compose an article or mail message, you can use theo7           SET EDIT command to enable automatic editing:s  I                            News> SET [NO]EDIT [/EDITOR=(editorname,CALL)]s  3           If you use SET EDIT, the text editor willo=           automatically be invoked for every POST, REPLY, and*=           MAIL command, unless you use the /NOEDIT qualifier. @           You can turn off automatic editing with the SET NOEDIT           command.  ;           In either case, you can specify which text editorr;           you would like to use with the /EDITOR qualifier.i?           Any callable editor may used; TPU (a.k.a. EVE) is thes<           default. VMS comes with one other callable editor::           EDT. The DEC Language-Sensitive Editor (LSE), if?           installed on your system, can also be used. There maya@           also be other callable editors available at your site.             1-12 t  p    A                                                     Using NEWSRDRw          @           If the editor you wish to use is not callable, you can?           instead set up a command procedure to be spawned as a 2           subprocess which will invoke the editor:  T                            News> SET [NO]EDIT [/EDITOR=("@command-procedure",SPAWN)]  <           The command procedure must be of the form shown in           Figure CMD-1.y  %           ___________________________       1.11.4 Signature   <           Some people like to have a standard "signature" be=           included at the end of each article they post. ThisS>           signature usually contains the person's name, E-mail?           address, company name, and a disclaimer of some kind.o=           The SET SIGNATURE command allows you to specify the ?           name of a file to be used as a signature for articlesy.           you post and mail messages you send:  <                            News> SET [NO]SIGNATURE file-spec  8           The specified file should contain no more than;           eight lines of text, each line containing no moree;           than 80 characters. The contents of the file will =           automatically be appended to every article you post >           and every mail message you send through NEWSRDR. Use>           the SET NOSIGNATURE command to disable the inclusion           of a signature file.  L           __________________________________________________________________      1.12   Subprocesses  8           NEWSRDR provides SPAWN and ATTACH commands for@           creating and moving among subprocesses. These commands=           are patterned after their counterparts in VMS MAIL.a    A                                                              1-13h b  t               Using NEWSRDRc        L           __________________________________________________________________      1.13   Keypad Keys_  <           NEWSRDR provides a DEFINE/KEY command for defining;           keys to perform NEWSRDR commands. This command iso;           also patterned after its counterpart in VMS MAIL.u9           In addition, you can create a file containing aS=           collection of DEFINE/KEY commands to be loaded eachL@           time NEWSRDR is executed. The file should be placed in@           your SYS$LOGIN directory and should be called NEWSRDR_=           KEYDEFS.NRKEY. Alternatively, you can place the key <           definitions in another file and assign the name of8           that file to the logical name NEWSRDR_KEYDEFS.  L           __________________________________________________________________  '    1.14   Setting Your Reply-To Address   9           Typically, when you post an article, the "From"s;           address that is entered in the article is used too=           address E-mail for replies that are mailed directlyi9           to you. If you prefer to have replies sent to a <           different E-mail address, you can define a logical8           name containing your preferred E-mail address:  H                            $ DEFINE NEWSRDR_REPLY_TO "username@hostname"  =           No syntax checking is performed on this address, so ?           you must specify your address carefully. Also, please ?           note that some systems do not use the Reply-To header            to address replies.p  >           Note: Your system manager can prevent you from using           this feature.F  L           __________________________________________________________________      1.15   Header Caching  =           Some NEWSRDR commands, such as READ/THREAD, require ?           access to article headers for their operation. To cutr=           down on network and news server load, and generallyt9           improve performance over multiple uses of thesee?           header-intensive commands, article headers are cached1?           in memory by NEWSRDR when they are retrieved from thee             1-14 o  e    A                                                     Using NEWSRDR           >           server. By default, up to 128 sets of headers may be=           cached at once. However, you can control the headerw:           cache size by defining the logical name NEWSRDR_<           HEADER_CACHE_SIZE to be the maximum number of sets:           of headers you wish to have cached. For example:  A                            $ DEFINE NEWSRDR_HEADER_CACHE_SIZE 256   ;           This will cause NEWSRDR to hold up to 256 sets of_           article headers.  @           Please note that the header cache works on a per-group<           basis only. This means that it works best when you>           do all your work in one group at a time, rather than?           jumping around to different newsgroups, reading a fewU           articles at a time.   L           __________________________________________________________________  %    1.16   Moving Your NEWSRDR Profiler  ?           By default, NEWSRDR expects your profile to be called >           NEWSRDR_PROFILE.NRPF and to be located in your login?           directory. You can alter this by defining the logical @           name NEWSRDR_PROFILE to be the full file specification#           for your NEWSRDR profile:   =                            $ DEFINE NEWSRDR_PROFILE file-spect  ?           Add the logical name definition to your login command[@           procedure to have it take effect each time you log in.  L           __________________________________________________________________      1.17   Using a NEWSRC FileO  :           By default, all information about newsgroups you8           subscribe to and the articles you have seen in;           those groups is kept in your NEWSRDR profile. Youe<           may additionally have that information stored in a?           "newsrc" file. There are two main reasons for using a_           newsrc file:  @           1  You use another news reader besides NEWSRDR and you@              want to be able to use either and maintain the same  A                                                              1-15                     Using NEWSRDRA          <              subscription/article information for both. Most=              other news readers use a newsrc file by default.u  >           2  You want to be able to control the order in which>              you visit newsgroups during your NEWSRDR session.  ;           You specify the use of a newsrc file with the SETo           NEWSRC command:t  J                            News> SET NEWSRC [file-spec] [/SUBSCRIBED_ONLY]  3           If you omit the file-spec, it defaults to :           SYS$LOGIN:XX.NEWSRC. Specifying the /SUBSCRIBED_;           ONLY qualifier causes NEWSRDR to include only thed<           newsgroups you subscribe to in the newsrc file; by?           default, all newsgroups are listed (for compatibility ;           with other news readers). Use the SET NONEWSRC to +           disable the use of a newsrc file._  >           NEWSRDR reads in your newsrc file after reading your;           NEWSRDR profile, and updates the subscription andt>           article information. On exiting, NEWSRDR updates the=           newsrc file after updating your NEWSRDR profile. Itl>           will not overwrite an existing newsrc file, but will'           instead create a new version.i  %           ___________________________   $    1.17.1 Specifying Newsgroup Order  ;           The newsrc file is a plain text file which can bef<           modified with any VMS text editor. You can specify9           the order in which NEWSRDR visits newsgroups byd>           rearranging the lines in the newsrc file. Be careful8           not to change the contents of the lines as you?           rearrange them; only news reader programs should makeo           such changes.n                 1-16 c  a              A           _______________________________________________________N  '           Part II  Command Descriptionsn         A                                              Command DescriptionsoA                                                            ATTACH         A           _______________________________________________________p             ATTACH  =           Switches control of your terminal from your current>5           process to another process in the same job.b  A           _______________________________________________________              FORMAT              ATTACH  [process-name]  A           _______________________________________________________ )           Command Qualifiers     Defaults              /PARENT   A           _______________________________________________________F             PARAMETERS           process-name;           Name of the process to which the connection is to >           be made. The process must be in the same job as your           current process.  A           _______________________________________________________R             DESCRIPTION_?           This command is a parallel to the DCL ATTACH command. <           It allows you to transfer your terminal to another<           subprocess in your job by name, or directly to the8           process which created your current subprocess.  A           _______________________________________________________a             QUALIFIERS           /PARENTh<           Specifies that your terminal should be attached to?           the process that created the subprocess to which your @           terminal is currently attached. This is the default if'           no process name is specified.s  A                                                             CMD-3T                    Command Descriptions           BACK        A           _______________________________________________________              BACK  $           Synonym for READ/PREVIOUS.  A           _______________________________________________________              FORMAT             BACK  A           _______________________________________________________r             DESCRIPTION ?           Please see the description of the READ command (READ)o"           for further information.                                                         CMD-4o o  r    A                                              Command DescriptionsnA                                                            CANCEL         A           _______________________________________________________              CANCEL  @           Cancels an article by sending a cancel control message           to the server.  A           _______________________________________________________i             FORMAT             CANCEL  [artnum]  A           _______________________________________________________o             PARAMETERS           artnum;           Article number of the article to be cancelled. If >           not specified, the current article is cancelled. You=           should only cancel those articles for which you areA           the author.p  A           _______________________________________________________.             DESCRIPTION <           This command constructs and posts a Usenet control5           message that cancels the specified article.                           A                                                             CMD-5o i                  Command Descriptions           CURRENTy        A           _______________________________________________________d             CURRENTE  <           Redisplays the current article from the beginning.  A           _______________________________________________________l             FORMAT             CURRENT   A           _______________________________________________________c)           Command Qualifiers     Defaults              /EDITc           /FULL_HEADERS            /ROTATEC  A           _______________________________________________________r             DESCRIPTION @           While reading an article, if you are paged part or all?           the way through the article, the CURRENT command will_?           rewind the article to the beginning and redisplay the            first page.   A           _______________________________________________________,             QUALIFIERS           /EDITt?           Displays the article using a text editor (the one setN           with SET EDIT).r             /FULL_HEADERS[@           Includes all available headers in the article display,3           not just those selected with SET HEADERS.              /ROTATEe=           Applies the ROT13 cipher to the article text beforen:           display. Some articles are enciphered with ROT139           because they may contain sensitive or offensivet<           material, leaving it up to the reader to determine?           whether the article warrants deciphering and reading.s             CMD-6     E    A                                              Command Descriptions A                                                        DEFINE/KEY         A           _______________________________________________________              DEFINE/KEY  5           Defines a key to execute a NEWSRDR command.t  A           _______________________________________________________s             FORMAT  %           DEFINE/KEY  key-name stringi  A           _______________________________________________________h)           Command Qualifiers     Defaultsm  &           /[NO]ECHO              /ECHO           /IF_STATE=state-list.           /[NO]LOCK_STATE        /NOLOCK_STATE-           /[NO]SET_STATE=state   /NOSET_STATEn-           /[NO]TERMINATE         /NOTERMINATE   A           _______________________________________________________e             PARAMETERS           key-name=           Specifies the name of the key you are defining. Usew5           the following key names when defining keys:   A           ________________________________________________________A           Key_name___________VT100_key______LK201_key____________t  /           PF1                PF1            PF1   /           PF2                PF2            PF2y  /           PF3                PF3            PF3o  /           PF4                PF4            PF4   6           KP0, KP1-KP9       keypad 0-9     keypad 0-9  9           PERIOD             keypad         keypad periodm#                              period   8           COMMA              keypad comma   keypad comma  8           MINUS              keypad minus   keypad minus  A                                                             CMD-7l c  p               Command Descriptions           DEFINE/KEY      A           _______________________________________________________nA           Key_name___________VT100_key______LK201_key____________   5           ENTER              ENTER key      Enter keys  0           E1, FIND           n/a            Find  7           E2, INSERT_HERE    n/a            Insert Here   2           E3, REMOVE         n/a            Remove  2           E4, SELECT         n/a            Select  7           E5, PREV_SCREEN    n/a            Prev ScreenE  7           E6, NEXT_SCREEN    n/a            Next ScreenP  0           HELP               n/a            Help  .           DO                 n/a            Do  A           F17-F20____________n/a____________F17-F20_______________             string>           Specifies the string you want entered when you press           the defined key.  A           _______________________________________________________              DESCRIPTIONd;           This command is implemented by passing the entireN=           command to the VMS Screen Management (SMG) routinesy;           for processing by SMG$DEFINE_KEY. NEWSRDR does nol$           processing on the command.  <           Key definitions are not remembered between NEWSRDR@           sessions. To have keys defined automatically each time>           you run NEWSRDR, create a file containing DEFINE/KEY;           commands called NEWSRDR_KEYDEFS.NRKEY, located int9           SYS$LOGIN. Alternatively, you can call the files=           something else and define the logical name NEWSRDR_ (           KEYDEFS to point to that file.  A           _______________________________________________________y             QUALIFIERS           /[NO]ECHO ?           Specifies whether the command line is echoed when you @           press the defined key. You cannot specify both /NOECHO             CMD-8E D       A                                              Command DescriptionscA                                                        DEFINE/KEY         1           and /NOTERMINATE. The default is /ECHO.              /IF_STATE=state-list@           Specifies one or more states, any one of which must be>           set in order to enable the specified key definition.:           If you omit this qualifier, the current state is<           used. To specify more than one state, separate the<           state names with commas and surround the list with           parentheses.             /[NO]LOCK_STATEs@           Causes the state specified by the /SET_STATE qualifier<           to be permanently retained when the defined key is?           pressed. The state is retained until changed by using ?           another key that sets a state. If omitted or negated,s>           the specified state is retained only until you press           another key.             /[NO]SET_STATE=state:           Establishes a state that is set when the defined>           key is pressed. A state name can be any alphanumeric@           string. The state lasts for one further keypress only,@           unless /LOCK_STATE is specified. If you omit or negate>           this qualifier, the state remains unchanged when the?           defined key is pressed. You cannot specify both /SET__           STATE and /TERMINATE._             /[NO]TERMINATE<           Determines whether the specified command string is:           executed when the defined key is pressed. If not;           terminated, you must press RETURN for the commando6           to be executed. The default is /NOTERMINATE.                A                                                             CMD-9                     Command Descriptions           DIRECTORY_        A           _______________________________________________________F             DIRECTORYi  9           Lists information about articles in the currentd           newsgroup.  A           _______________________________________________________y             FORMAT  $           DIRECTORY  [article-range]  A           _______________________________________________________c)           Command Qualifiers     Defaults              /GROUP,           /EXCLUDE=(keyword=(pattern...)...)           /FROM=(pattern...)           /KEYWORD=(keyword...)            /SUBJECT=(pattern...)            /SEENf           /UNSEENl           /WIDTH=(keyword...)E  A           ________________________________________________________             PARAMETERS           article-rangeT;           Range of articles to be included in the directoryt>           listing. If omitted, the current article through the/           last article in newsgroup are listed.a  A           _______________________________________________________e             DESCRIPTIONi9           The DIRECTORY command lists the article number, <           originator, and subject of articles in the current<           newsgroup, one article per line. Articles you have5           seen are marked with an "x" in the listing.r             CMD-10    t    A                                              Command DescriptionseA                                                         DIRECTORYi        9           Specifying any of /EXCLUDE, /FROM, /KEYWORD, ori;           /SUBJECT can narrow down the directory listing to_9           include or omit articles matching the specified =           criteria. When specified in combination, only those/=           articles matching all of the specified criteria are            listed.   A           _______________________________________________________              QUALIFIERS           /GROUP>           See the description for the DIRECTORY/GROUP command.  ,           /EXCLUDE=(keyword=(pattern...)...):           Causes articles matching the specified exclusion?           criteria to be omitted from the listing. Valid valuesD+           for keyword are FROM and SUBJECT.p             /FROM=(pattern...)>           Specifies one or more patterns to be matched against9           each article's From header. Only those articles <           matching one of the specified patterns are listed.             /KEYWORD=(keyword...)v=           Specifies one or more keywords. Only those articlesE8           with Keywords headers containing the specified            keyword(s) are listed.             /SUBJECT=(pattern...) >           Specifies one or more patterns to be matched against<           each article's Subject header. Only those articles<           matching one of the specified patterns are listed.             /SEENr@           Specifies that seen articles should be included in the=           listing. If neither /SEEN nor /UNSEEN is specified,_"           all articles are listed.      A                                                            CMD-11  r  o               Command Descriptions           DIRECTORY                    /UNSEEN ;           Specifies that unseen articles should be included 9           in the listing. If neither /SEEN nor /UNSEEN isi-           specified, all articles are listed.              /WIDTH=(keyword...)N>           Alters the format of the DIRECTORY display. Possible!           values for keyword are:   ?           FROM=n     Sets the width of the From-address column.   :           SUBJECT=n  Sets the width of the Subject column.  =           By default, DIRECTORY uses approximately 20 columnsf>           for other fields and spacing and divides the rest of?           the terminal width evenly between the From column ande@           the Subject column. Note that it is possible to exceed@           the terminal width by specifying large values for this9           qualifier; this may produce unexpected results.                                                      CMD-12         A                                              Command Descriptions A                                                   DIRECTORY/GROUP         A           _______________________________________________________o             DIRECTORY/GROUP   ?           Lists information about newsgroups available from the            server.   A           _______________________________________________________              FORMAT  &           DIRECTORY/GROUP  [group-pat]  A           _______________________________________________________ )           Command Qualifiers     Defaultsp             /ALL(           /[NO]SORT              /NOSORT           /UNSEEN   A           _______________________________________________________              PARAMETERS           group-pat =           A group name or a pattern containing wildcards. All <           groups matching the specified pattern are included>           in the directory listing. If omitted, all groups are           listed.a  A           _______________________________________________________s             DESCRIPTIONr>           DIRECTORY/GROUP lists the names of the newsgroups to;           which are subscribed along with the number of thee:           first and last article available from the server9           in each newsgroup. Also indicated is whether or :           not you subscribe to the group (more useful with:           DIR/GROUP/ALL) and the number of articles in the9           group that you have not yet read. DIR/GROUP/ALLi?           lists information about all groups available from theu           server.   A                                                            CMD-13a n  h               Command Descriptions           DIRECTORY/GROUP         9           Note: DIR/GROUP/ALL will not display any usefulw>           information unless you have done an full information>           update with the UPDATE/FULL command first. DIR/GROUP?           will not flag unmoderated groups unless you have donem           an UPDATE/FULL first.   A           _______________________________________________________              QUALIFIERS           /ALL:           Lists information about all available newsgroups>           that match, rather than just the groups to which you           subscribe.             /[NO]SORTm;           Causes the groups to be listed alphabetically. Bya;           default, the listing is displayed in the order in_=           which they appear in your NEWSRDR profile (which ise@           alphabetical also) or in your newsrc file (if you have/           set one with the SET NEWSRC command).f             /UNSEENP;           Specifies that the list should include only those_5           newsgroups where there are unseen articles.s                                           CMD-14 n  t    A                                              Command DescriptionsoA                                                              EXIT_        A           _______________________________________________________c             EXIT  "           Ends an NEWSRDR session.  A           _______________________________________________________p             FORMAT             EXIT  A           _______________________________________________________              DESCRIPTION_@           Ends the current NEWSRDR session, updates your NEWSRDR.           profile, and returns control to DCL.                                              A                                                            CMD-15m l                  Command Descriptions           EXTRACTo        A           _______________________________________________________              EXTRACTT  +           Copies news articles into a file.   A           ________________________________________________________             FORMAT  2           EXTRACT  [file-spec] [article-range ...]  A           ________________________________________________________)           Command Qualifiers     Defaults   *           /[NO]APPEND            See text.)           /[NO]HEADERS[=FULL]    /HEADERSO           /ROTATEe  A           _______________________________________________________e             PARAMETERS           file-spec =           Name of the file into which the selected article(s) =           will be copied. If omitted, the name of the file is @           taken from the current newsgroup name. For example, an@           article extracted from newsgroup "comp.sys.belch-fire">           would be placed in the file COMP_SYS_BELCH-FIRE.TXT.             article-range :           A single article number or a starting and ending<           article number separated by a hyphen. All articles=           in the specified range are copied into the file. If_6           omitted, only the current article is copied.  :           The SET ARCHIVE_DIRECTORY command can be used to>           specify a default device and directory for extracted@           articles. If no archive directory is specified, and no@           device/directory is specified in file-spec the file is5           placed in the current directory by default.T             CMD-16 m  d    A                                              Command DescriptionstA                                                           EXTRACT       A           _______________________________________________________o             DESCRIPTION :           This command can be used to save articles into a=           file for future reference. One or more articles can <           be extracted into a file, but all articles must be<           in the current newsgroup. Using /APPEND causes the@           articles to appended to the specified file (which must>           already exist). Otherwise, a new file is created for!           the extracted articles.   A           ________________________________________________________             QUALIFIERS           /[NO]APPEND_:           Causes the articles to appended to the file. The=           default when file-spec is present on the command is >           /NOAPPEND; when file-spec is omitted, the default is           /APPEND.             /[NO]HEADERS[=FULL]i;           Causes the article header lines to be included in_?           the extraction (the default). Use /NOHEADERS to cause ;           the header lines to be omitted. Use /HEADERS=FULL <           to include all article headers, overriding the SET#           HEADERS/EXTRACT settings.              /ROTATE =           Causes the article body to be deciphered, using the 1           ROT13 cipher, when written to the file.h                      A                                                            CMD-17     a               Command Descriptions           FOLLOWUP        A           _______________________________________________________r             FOLLOWUP  =           This is a synonym for REPLY. See the description of 4           the REPLY command for further information.  A           _______________________________________________________              FORMAT  $           FOLLOWUP  [group-name,...]  A           _______________________________________________________e)           Command Qualifiers     Defaults_  "           /DISTRIBUTION=(dist ...)           /[NO]EDIT            /[NO]EXTRACT"           /FOLLOWUP_TO=(group ...)           /MAIL_           /POST_           /[NO]SIGNATURE%           /[NO]SUBJECT="subject-text"u           /TO=(user-spec ...)                                          CMD-18         A                                              Command Descriptions A                                                           FORWARD         A           _______________________________________________________              FORWARD   8           Forwards a copy of a news article to a user by           electronic mail.  A           ________________________________________________________             FORMAT  #           FORWARD  [article-number]a  A           _______________________________________________________ )           Command Qualifiers     Defaults              /[NO]EDIT2           /[NO]SELF '           /[NO]SUBJECT[="subject-text"]            /[NO]SIGNATURE           /TO=(user-spec...)  A           _______________________________________________________              PARAMETERS           article-number;           Number of the article to be sent. If omitted, the "           current article is sent.  A           _______________________________________________________              DESCRIPTION <           This command sends the specified article by E-mail?           to the specified user or users. The complete article,_>           including all headers, is treated as the text of the>           message. You can edit the text before it is sent, if           desired.  A           _______________________________________________________              QUALIFIERS           /[NO]EDIT =           Specifying /EDIT causes a text editor to be invoked >           so the message text can be edited before being sent.  A                                                            CMD-19                     Command Descriptions           FORWARD         =           The default action for this qualifier is determinedn>           by the current SET EDIT setting (see the SET command,           description for more information).             /[NO]SELFt=           Specifying /SELF causes a copy of the message to be.;           sent to your username in addition to the intended_@           recipients. Specifying /NOSELF prevents the extra copy@           from being sent. If omitted, the default is taken from0           the SET COPY_SELF setting in VMS MAIL.  '           /[NO]SUBJECT[="subject-text"] ;           The /SUBJECT qualifier can be used to specify then:           subject for the message on the command line. Use7           /NOSUBJECT to omit a subject from the message <           altogether. If not specified, you are prompted for           a subject line.F             /[NO]SIGNATURE:           The /SIGNATURE qualifier can be used to indicate<           that your "signature" file should or should not be?           included automatically at the end of the message when_>           it is sent. The default action for this qualifier is:           determined by the current SET SIGNATURE setting.             /TO=("user-spec"...)6           The /TO qualifier can be used to specify the=           destination users for the message. If the user-spec =           includes an at-sign ("@"), the message will be sent >           via your Internet mail system; otherwise, it will be?           sent via regular VMS MAIL. Specify multiple addressest?           by separating them with commas and enclosing the listh>           in parentheses. If omitted, you are prompted for the#           destination address list.q                       CMD-20         A                                              Command Descriptions A                                                             GROUP.        A           _______________________________________________________              GROUPr  =           Selects a newsgroup to be your "current" newsgroup.   A           _______________________________________________________              FORMAT             GROUP  groupname  A           _______________________________________________________e             PARAMETERS           groupnameS/           Name of the group to be made current.t  A           _______________________________________________________b             DESCRIPTION ;           You can use this command to explicitly select the @           current newsgroup, to be able to extract articles from=           the newsgroup, etc. Note that some NEWSRDR commands @           (DIRECTORY, READ) implicitly set the current newsgroup           for you.                            A                                                            CMD-21n s                  Command Descriptions           HELP        A           _______________________________________________________              HELP  $           Displays help information.  A           _______________________________________________________-             FORMAT             HELP  [topic...]  A           ________________________________________________________             PARAMETERS           topicE@           The name of a topic in the help library. If omitted, a&           list of topics is displayed.  A           _______________________________________________________O             DESCRIPTIONR>           This command should be relatively straightforward to           use.                                           CMD-22         A                                              Command Descriptions A                                                              MAILB        A           _______________________________________________________(             MAIL  +           Sends an electronic mail message._  A           _______________________________________________________              FORMAT             MAIL  [file-spec]e  A           _______________________________________________________e)           Command Qualifiers     Defaultsi             /[NO]EDIT_           /[NO]SELF_'           /[NO]SUBJECT[="subject-text"]            /[NO]SIGNATURE           /TO=(user-spec...)  A           _______________________________________________________t             PARAMETERS           file-specp@           Name of the file to be sent by E-mail. If omitted, you3           are prompted for the text of the message.   A           _______________________________________________________              DESCRIPTION @           This command is similar to the SEND command in the VMS5           MAIL utility, with three small differences:T  A           1  You can specify the destination users on the command )              line with the /TO qualifier.   8           2  The destination usernames are assumed to be<              Internet-style names and are automatically sent7              through the system's Internet mail system._  A           3  After composing or editing the text of your message, A              you are asked for confirmation before the message is               sent.  A                                                            CMD-23i e  u               Command Descriptions           MAIL      A           _______________________________________________________              QUALIFIERS           /[NO]EDITn=           Specifying /EDIT causes a text editor to be invokede>           so the message text can be edited before being sent.=           The default action for this qualifier is determinedr>           by the current SET EDIT setting (see the SET command,           description for more information).             /[NO]SELF =           Specifying /SELF causes a copy of the message to be ;           sent to your username in addition to the intendedn@           recipients. Specifying /NOSELF prevents the extra copy@           from being sent. If omitted, the default is taken from0           the SET COPY_SELF setting in VMS MAIL.  '           /[NO]SUBJECT[="subject-text"]i;           The /SUBJECT qualifier can be used to specify the :           subject for the message on the command line. Use7           /NOSUBJECT to omit a subject from the message <           altogether. If not specified, you are prompted for           a subject line.c             /[NO]SIGNATURE:           The /SIGNATURE qualifier can be used to indicate<           that your "signature" file should or should not be?           included automatically at the end of the message whena>           it is sent. The default action for this qualifier is:           determined by the current SET SIGNATURE setting.             /TO=("user-spec"...)6           The /TO qualifier can be used to specify the=           destination users for the message. If the user-spec =           includes an at-sign ("@"), the message will be sent >           via your Internet mail system; otherwise, it will be?           sent via regular VMS MAIL. Specify multiple addresses ?           by separating them with commas and enclosing the list >           in parentheses. If omitted, you are prompted for the#           destination address list.              CMD-24         A                                              Command Descriptions A                                                              NEXT         A           _______________________________________________________              NEXT  &           A synonym for READ/NEXT/NEW.  A           ________________________________________________________             FORMAT             NEXT  A           _______________________________________________________a)           Command Qualifiers     Defaults_             /GROUP  A           _______________________________________________________L             DESCRIPTION ?           This command, a synonym for READ/NEXT/NEW, causes the_.           next unseen article to be displayed.  A           _______________________________________________________a             QUALIFIERS           /GROUP=           Instructs NEWSRDR to move on to the next subscribed ?           newsgroup before searching for new articles, skippingi=           any unread articles in the current newsgroup. If no_;           new article are found in any other newsgroup, theR?           NEWS-W-NONEW message will be displayed, even if theres4           are new articles in the current newsgroup.              A                                                            CMD-25i e  s               Command Descriptions           POST        A           _______________________________________________________n             POST             Posts a news article./  A           _______________________________________________________o             FORMAT  ,           POST  [group-name,...] [file-spec]  A           _______________________________________________________o)           Command Qualifiers     Defaults              /APPROVEDL'           /DISTRIBUTION=(dist-name ...)            /[NO]EDITu           /EXPIRES=date-time           /FILE=file-spec "           /FOLLOWUP_TO=(group ...)            /KEYWORDS=(keyword...)           /[NO]SIGNATURE"           /[NO]SUBJECT[="subject"]           /SUMMARY="summary"  A           _______________________________________________________              PARAMETERS           group-name:           Name of the newsgroup to which the article is to=           be posted. If omitted, the article is posted to the            current newsgroup.             file-spect:           File whose contents should be posted as the text<           of the article. You must specify group-name if you=           wish to specify file-spec. If omitted, and no /FILEy>           qualifier is specified, you will be prompted for the           article text.              CMD-26 p  f    A                                              Command DescriptionseA                                                              POST       A           _______________________________________________________a             DESCRIPTION 7           This command is used to compose and post news_@           articles. If you do not specify a file either with the=           file-spec parameter or the /FILE qualifier, and youo=           are not using a text editor to compose the article,_=           you are prompted for the article text one line at a_>           time. Once you have entered the text of the article,=           you are asked to confirm the posting. If you do so,a=           the article is transmitted to the NNTP server to be.'           entered into the news system.   A           _______________________________________________________1             QUALIFIERS           /APPROVEDs<           Adds an Approved: header to the article, with your           address on it.  '           /DISTRIBUTION=(dist-name ...) 4           This qualifier can be used to restrict the;           distribution of the article to a particular area. =           If not specified, no restrictions are placed on the @           article's distribution. Typical distribution names are!           "usa", "na", "ny", etc.              /[NO]EDIT =           Specifying /EDIT causes a text editor to be invoked >           so the article text can be edited before being sent.=           The default action for this qualifier is determined >           by the current SET EDIT setting (see the SET command,           description for more information).             /EXPIRES=date-time;           Sets the expiration time on the article by addinge>           an Expires: header. Specify the date and time in VMS=           format; use quotation marks if the date-time stringL           contains any blanks.    A                                                            CMD-27                     Command Descriptions           POST                   /FILE=file-spece=           Specifies a file whose contents should be posted as =           the text of the article. This qualifier can be usedn;           instead of the file-spec parameter to specify thec<           article text file, if you do not wish to enter the>           name of the newsgroup to which the article should be>           posted. If omitted, you are prompted for the article           text.   "           /FOLLOWUP_TO=(group ...)>           This qualifier can be used to redirect any followups7           to this article to be posted to the specifiedX?           newsgroup(s). By default, followups are posted to the_2           same newsgroup(s) as the posted article.              /KEYWORDS=(keyword...)=           Adds a Keywords: header to the article, listing thea=           specified keywords. Unless quoted, the keywords arel"           converted to lower case.             /[NO]SIGNATURE:           The /SIGNATURE qualifier can be used to indicate<           that your "signature" file should or should not be?           included automatically at the end of the article when @           it is posted. The default action for this qualifier is:           determined by the current SET SIGNATURE setting.  '           /[NO]SUBJECT[="subject-text"] ;           The /SUBJECT qualifier can be used to specify the :           subject for the article on the command line. Use7           /NOSUBJECT to omit a subject from the article <           altogether. If not specified, you are prompted for           a subject line.   !           /SUMMARY="summary-text" 9           Adds a Summary: header to the article, with the            specified text.t                 CMD-28 e  T    A                                              Command Descriptions A                                                             PRINT1        A           _______________________________________________________              PRINT   =           Adds one or more articles to the current print job.c@           The print job is not released to the print queue until8           you exit NEWSRDR or use the PRINT/NOW command.  A           _______________________________________________________              FORMAT  $           PRINT  [article-range] ...  A           _______________________________________________________ )           Command Qualifiers     Defaultsn  )           /AFTER=time            no delay_3           /[NO]BURST[=keyword]   default from queueu           /CANCELt'           /COPIES=n              1 copy 3           /[NO]FEED              default from queue 3           /[NO]FLAG[=keyword]    default from queue 3           /FORM=form-name        default from queueB)           /[NO]HEADERS           /HEADERSp(           /[NO]HOLD              no hold+           /NAME=job-name         /NAME=NEWS            /NOTIFY            /NOW$           /PARAMETERS=(parameter...)           /PRINT1           /QUEUE=queue-name      /QUEUE=SYS$PRINT_*           /[NO]ROTATE            /NOROTATE           /[NO]SPACE3           /[NO]TRAILER[=keyword]default  from queueo  A           ________________________________________________________             PARAMETERS           article-range :           A single article number or a starting and ending<           article number separated by a hyphen. All articles  A                                                            CMD-29     [               Command Descriptions           PRINT         ?           in the specified range are copied into the print job._9           If omitted, only the current article is copied.   A           _______________________________________________________l             DESCRIPTION 7           This command adds the specified article(s) to_;           the current pending print job. If no print job is ?           pending, a new job is created. Using /NOW (or /PRINT)c;           causes the current pending print job to be closedo9           and submitted to the print queue; using /CANCELe<           discards the print job without printing it. If you:           specify attributes on the PRINT command that are?           incompatible with the current pending print job (such =           as a different value for /QUEUE), the current printu;           job is closed and printed and a new job is openedx)           before the articles are copied.   A           _______________________________________________________              QUALIFIERS           /AFTER=timeO8           Requests that the job not be printed until the           specified date/time.             /[NO]BURST[=keyword]?           Controls whether a burst page is printed at the start <           of the print job. Valid keyword values are ALL and;           ONE; if omitted, ALL is assumed. Note that eithera?           value has the same effect, since NEWSRDR combines allF>           printed articles into a single file before printing.             /CANCEL 0           Cancels the current pending print job.             /COPIES=nS9           Indicates the number of copies of the job to bec           printed.             /[NO]FEEDc@           Controls whether form feeds are automatically inserted           at the end of a page.              CMD-30    n    A                                              Command Descriptions A                                                             PRINTt                   /[NO]FLAG[=keyword]u>           Controls whether a flag page is printed at the start<           of the print job. Valid keyword values are ALL and;           ONE; if omitted, ALL is assumed. Note that either ?           value has the same effect, since NEWSRDR combines all.>           printed articles into a single file before printing.             /FORM=form-nameh>           Specifies the name of the form that you want for the           print job.             /[NO]HEADERS@           Controls whether the article headers are included with$           the text in the print job.             /[NO]HOLDp@           Controls whether the job is held in the queue prior to           printing.              /NAME=job-name6           Specifies a name string to identify the job.             /NOTIFY >           Indicates that you should be notified by a broadcast7           message when the job has been printed. May be 8           specified on the PRINT and PRINT/NOW commands.             /NOW9           Closes the pending print job and submits it fors<           printing. You may specify the /NOTIFY qualifier on           this command._  %           /PARAMETERS=(parameter ...) @           Specifies up to eight optional parameters to be passed*           to the print queue with the job.             /PRINT           Synonym for /NOW.e    A                                                            CMD-31_ _  _               Command Descriptions           PRINT                    /QUEUE=queue-namex@           Specifies the name of the print queue to which the job           should be submitted.             /ROTATEo8           If specified, the text of each article will be,           deciphered using the ROT13 cipher.             /[NO]SPACE<           Specifies that the output should be double-spaced.              /[NO]TRAILER[=keyword];           Controls whether a trailer page is printed at the <           end of the print job. Valid keyword values are ALL?           and ONE; if omitted, ALL is assumed. Note that either ?           value has the same effect, since NEWSRDR combines all >           printed articles into a single file before printing.                                                         CMD-32 A  E    A                                              Command Descriptions.A                                                              READ         A           _______________________________________________________I             READ  "           Displays a news article.  A           _______________________________________________________              FORMAT  "           [READ]  [article-number]  A           _______________________________________________________ )           Command Qualifiers     Defaults              /NEXT_           /PREVIOUS_           /NEW           /FIRST           /LAST            /GROUP[=group-name]e"           /SUBJECT[=(pattern ...)]           /THREAD_  A           _______________________________________________________              PARAMETERS           article-number9           The number of the article to be read. Should bet9           omitted when using any of the qualifiers except            /GROUP.e  A           _______________________________________________________              DESCRIPTION_>           This command displays a news article. You can select>           the article to be read by number, or by using one of#           the selection qualifiers.r  @           The READ command name may be omitted only if reading a6           specific article that you specify by number.  A                                                            CMD-33n e  S               Command Descriptions           READ      A           _______________________________________________________              QUALIFIERS           /NEXTr;           When used without /NEW, causes the next availablee?           article in the newsgroup to be displayed, even if you <           have seen it. When used with /NEW, causes the next8           article you have not yet seen to be displayed.             /PREVIOUSa8           Causes the next-lowest-numbered article in the$           newsgroup to be displayed.             /NEW>           When used without /NEXT, causes the first article in>           the newsgroup you have not yet seen to be displayed.>           When used with /NEXT, causes the next unseen article>           after the article you are currently reading (if any)           to be displayed.             /FIRST@           Causes the first available article in the newsgroup to           be displayed.r             /LASTc?           Causes the last available article in the newsgroup too           be displayed.              /GROUP=group-name 9           Makes the specified group the current group and @           selects articles from that group. If omitted, articles.           are selected from the current group.  <           When used with the READ/NEXT/NEW command, no group?           name is specified. In this case, the /GROUP qualifier =           instructs NEWSRDR to move on to the next subscribedq?           newsgroup before searching for new articles, skippinge=           any unread articles in the current newsgroup. If nos;           new article are found in any other newsgroup, thei?           NEWS-W-NONEW message will be displayed, even if there 4           are new articles in the current newsgroup.             CMD-34         A                                              Command DescriptionsdA                                                              READe                    /SUBJECT=(pattern ...)           /SUBJECT>           Causes NEWSRDR to scan forward through the newsgroup7           until it finds an article matching one of thes9           specified wildcard patterns. If no patterns are ?           specified, the search is continued using the patternsw7           last specified. If there are no more matchingh=           articles, NEWSRDR displays a message and clears they=           patterns, resetting the current article back to thea!           first matching article.n             /THREADt>           Causes NEWSRDR to scan forward through the newsgroup?           until it finds another article with the same subject. >           Continued use of READ/THREAD can be used to view all:           articles on one subject, following the thread of<           conversation. If there are no more articles in the<           thread, NEWSRDR displays a message and the current@           article is reset back to the first article you read in           the thread.   <           The /NEW qualifier can be used with READ/THREAD to2           view only unseen articles in the thread.                                  A                                                            CMD-35                     Command Descriptions           REPLY         A           _______________________________________________________              REPLY_  @           Posts a follow-up article and/or sends a reply message/           to the author of the current article.D  A           _______________________________________________________c             FORMAT  !           REPLY  [group-name,...]t  A           _______________________________________________________n)           Command Qualifiers     DefaultsE             /APPROVED "           /DISTRIBUTION=(dist ...)           /[NO]EDITi           /EXPIRES=date-time           /[NO]EXTRACT"           /FOLLOWUP_TO=(group ...)            /KEYWORDS=(keyword...)           /MAILc           /POST            /[NO]SELF            /[NO]SIGNATURE%           /[NO]SUBJECT="subject-text"            /SUMMARY="summary"           /TO=(user-spec ...)   A           _______________________________________________________              PARAMETERS           group-name:           The name of the newsgroup to which the follow-up:           article should be posted. The groups you specify:           override the groups listed in the Followup-To or;           Newsgroups header of the message to which you are            replying.s  =           If you are not posting your follow-up article, thisy           parameter is ignored.E             CMD-36 T  s    A                                              Command Descriptions_A                                                             REPLY       A           _______________________________________________________o             DESCRIPTION @           This command is used to compose and post and/or mail a@           follow-up article to the article currently being read.?           Just as for the MAIL and POST commands, you can use ag@           text editor to compose the message, or be prompted for?           the message text. Once you have finished entering them>           message, you are asked to confirm the sending of the>           reply. Once confirmed, the follow-up message is sent=           to the NNTP server to be entered into the newsgroup @           and/or sent through the Internet mailer to the author.  ?           For posted replies, if you do not specify one or morem:           group names on the REPLY command, the "Followup-<           to:" header in the original article determines the?           newsgroups to which the follow-up is posted. If there <           is no "Followup-to:" header, the follow-up article=           is automatically entered into the same newsgroup(s) ?           as the original article. If the "Followup-to:" header >           specifies the word "poster," then the reply will not;           be posted and will instead be treated as a mailede           reply.  ;           For mailed replies, the "Reply-to:" header in the_<           original aritcle determines the destination of the?           reply message. If there is no "Reply-to:" header, the 8           address in the "From:" header is used instead.  A           _______________________________________________________              QUALIFIERS           /APPROVEDr<           Adds an Approved: header to the article, with your           address on it.  '           /DISTRIBUTION=(dist-name ...)a4           This qualifier can be used to restrict the;           distribution of the article to a particular area.b=           If not specified, no restrictions are placed on theb@           article's distribution. Typical distribution names are!           "usa", "na", "ny", etc.S  A                                                            CMD-37i r  i               Command Descriptions           REPLYt                   /[NO]EDITi=           Specifying /EDIT causes a text editor to be invokeda>           so the article text can be edited before being sent.=           The default action for this qualifier is determined >           by the current SET EDIT setting (see the SET command,           description for more information).             /EXPIRES=date-time;           Sets the expiration time on the article by adding >           an Expires: header. Specify the date and time in VMS=           format; use quotation marks if the date-time stringc           contains any blanks.             /[NO]EXTRACT;           If a text editor is used to compose the follow-upt<           message, the current article text is automatically>           extracted with greater-than signs placed in front of=           each line of text, to be used as part of the reply.f>           You can use the /NOEXTRACT qualifier to prevent this>           extraction from occurring. Note that /EXTRACT has no>           effect if you do not use a text editor for composing           the follow-up.  "           /FOLLOWUP_TO=(group ...)>           This qualifier can be used to redirect any followups7           to this article to be posted to the specifiedr?           newsgroup(s). By default, followups are posted to thei2           same newsgroup(s) as the posted article.              /KEYWORDS=(keyword...)=           Adds a Keywords: header to the article, listing thew=           specified keywords. Unless quoted, the keywords aref"           converted to lower case.             /MAILR@           Specifies that the reply is to be mailed to the author=           of the original message. If neither /MAIL nor /POSTu=           is specified, /POST is assumed. A reply may be bothB           mailed and posted.             CMD-38 l  e    A                                              Command Descriptions A                                                             REPLYe                   /POST ?           Specifies that the reply is to be posted as a follow- >           up article. If neither /MAIL nor /POST is specified,:           /POST is assumed. A reply may be both mailed and           posted.              /[NO]SELF_?           For mailed replies, specifying /SELF causes a copy of @           the message to be sent to your username in addition to>           the intended recipients. Specifying /NOSELF prevents9           the extra copy from being sent. If omitted, the.<           default is taken from the SET COPY_SELF setting in           VMS MAIL.              /[NO]SIGNATURE:           The /SIGNATURE qualifier can be used to indicate<           that your "signature" file should or should not be?           included automatically at the end of the article when >           it is sent. The default action for this qualifier is:           determined by the current SET SIGNATURE setting.  '           /[NO]SUBJECT[="subject-text"] ;           The /SUBJECT qualifier can be used to specify theR:           subject for the message on the command line. Use7           /NOSUBJECT to omit a subject from the messagen:           altogether. If not specified, the subject of the+           message is determined as follows:M  A           o  If there is no subject line in the original message, A              or the subject line is the text "(none)", no subject %              is added to the message.L  ?           o  If the subject line in the original message begins_;              with "Re:" (upper or lower case), it is copied 8              verbatim to the new message's subject line.  <           o  Otherwise, the new subject line is the original<              subject line with "Re:" added at the beginning.  !           /SUMMARY="summary-text"[9           Adds a Summary: header to the article, with the            specified text.i  A                                                            CMD-39t c  e               Command Descriptions           REPLY_                   /TO=("user-spec"...)6           The /TO qualifier can be used to specify the;           destination users for the message, when the replyn?           is to be mailed. If the user-spec includes an at-signe@           ("@"), the message will be sent via your Internet mail<           system; otherwise, it will be sent via regular VMS=           MAIL. Specify multiple addresses by separating themp?           with commas and enclosing the list in parentheses. Ifm?           omitted, the destination address is obtained from then@           Reply-To header in the article (or the From header, if'           there is no Reply-To header).r                                                                     CMD-40         A                                              Command Descriptions A                                             SET ARCHIVE_DIRECTORYo        A           _______________________________________________________O             SET ARCHIVE_DIRECTORYs  @           Establishes a place where extracted articles should be           stored.r  A           _______________________________________________________              FORMAT  -           SET [NO]ARCHIVE_DIRECTORY  [devdir]i  A           _______________________________________________________n             PARAMETERS           devdir=           A device and/or directory specification. This value :           will be used as the default device/directory for&           subsequent EXTRACT commands.  A           _______________________________________________________              DESCRIPTION 9           This command is used to specify where extracted =           articles should be stored if no device/directory is @           specified on EXTRACT commands. If no archive directory=           is set, or you remove the archive directory settingr;           with SET NOARCHIVE_DIRECTORY, EXTRACT defaults to 1           placing files in the current directory.i                    A                                                            CMD-41e l                  Command Descriptions           SET AUTO_READ_NEW         A           _______________________________________________________o             SET AUTO_READ_NEW   >           Controls how NEWSRDR behaves when a READ/NEW command            causes a group change.  A           _______________________________________________________              FORMAT             SET [NO]AUTO_READ_NEW   A           _______________________________________________________              DESCRIPTION :           This command controls how the READ/NEW series of<           commands behave when they run out of articles in a;           newsgroup and jump to the next newsgroup that hasI>           unseen articles. The default is AUTO_READ_NEW, which@           causes the first unseen article in the new group to be>           displayed automatically. If you set NOAUTO_READ_NEW,>           when the group change occurs you are returned to the           News> command prompt.b                                           CMD-42         A                                              Command Descriptions A                                             SET AUTO_SAVE_PROFILE         A           _______________________________________________________x             SET AUTO_SAVE_PROFILEh  ;           Enables automatic saving of your NEWSRDR profile.   A           _______________________________________________________e             FORMAT  #           SET [NO]AUTO_SAVE_PROFILE   A           _______________________________________________________b             DESCRIPTION[<           Causes NEWSRDR to save update your NEWSRDR profile=           automatically each time a READ/NEW or READ/NEXT/NEWw@           command visits a new newsgroup and each time you SPAWN+           or ATTACH to a different process.a                                          A                                                            CMD-43                     Command Descriptions           SET DIRECTORY_WIDTH         A           _______________________________________________________              SET DIRECTORY_WIDTH   =           Specifies the default width for fields in DIRECTORY_           listings._  A           _______________________________________________________              FORMAT             SET DIRECTORY_WIDTH_  A           _______________________________________________________ )           Command Qualifiers     Defaults_             /FROM=columns            /SUBJECT=columns  A           _______________________________________________________              DESCRIPTION <           This command sets the default field widths for the;           From and Subject fields in DIRECTORY listings. By_<           default, the two fields split the available screen?           width evenly. You can set a specific width (includingl=           zero) for one or both fields. If you set a specifich=           width for one field, the remaining available screen_&           width is used for the other.  @           Specifying no qualifiers resets the widths back to the           even-split default.   A           _______________________________________________________              QUALIFIERS           /FROM=columnsD=           Specifies the number of columns for the From field.f             /SUBJECT=columns@           Specifies the number of columns for the Subject field.             CMD-44         A                                              Command Descriptions_A                                                          SET EDITE        A           _______________________________________________________i             SET EDIT  8           Changes the auto-edit setting and text editor.  A           _______________________________________________________l             FORMAT             SET [NO]EDIT  A           _______________________________________________________ )           Command Qualifiers     Defaults.  "           /EDITOR=(editor [,type])  A           _______________________________________________________              DESCRIPTIONb>           This command is used to turn on or off the automatic;           use of a text editor for message composition. Thee@           setting can be overridden on the POST, MAIL, and REPLY0           commands with the /[NO]EDIT qualifier.  A           _______________________________________________________              QUALIFIERS"           /EDITOR=(editor [,type])=           This qualifier can be used to specify the editor to =           be used, which can be either callable or spawned ase=           a subprocess. If type is CALLABLE, then editor mustr?           be the name of a callable editor. NEWSRDR can use anye@           callable editor for message composition that meets the%           following calling standard:   >           o  The callable editor's shareable library name must@              be xxxSHR.EXE, where "xxx" is the name by which the>              editor will be called. The library must reside inA              SYS$SHARE or must have an exec-mode logical pointingS&              to the library elsewhere.  A                                                            CMD-45                     Command Descriptions           SET EDIT        >           o  The shareable library must contain an entry point=              which called xxx$EDIT, which must take the input ;              file-spec and output file-spec, both characterr;              strings passed by descriptor, as the first twol<              arguments. If there are optional arguments, the?              xxx$EDIT routine must not rely on having more thand#              two arguments present.s  >           The Digital-supplied editors TPU, EDT, and TECO, and=           the (layered product) DEC Language-Sensitive Editore1           (LSE) all follow this calling standard.i  >           NEWSRDR uses LIB$FIND_IMAGE_SYMBOL to map the editor>           into the process's virtual address space at runtime.  @           If type is SPAWN, then editor must be a command string>           for invoking a command procedure that follows of the           form in Figure CMD-1.                                                        CMD-46         A                                              Command DescriptionsiA                                                          SET EDITh      8           Figure CMD-1  Spawned editor command procedureA           _______________________________________________________   >           $! Command procedure to invoke an editor for NEWSRDR           $!C           $! To use, put your edit command below and in NEWSRDR useE           $! the command:_           $!G           $!  News> SET EDIT/EDITOR=("@device:[dir]filename.COM",SPAWN)o           $!           $! Inputs:           $!"           $!   P1: input file name#           $!   P2: output file name_           $!%           $! P1 may be a null string.            $!E           $! The example below is for using TPU (for which you should_0           $! really use the callable interface).           $!.           $ DEFINE/USER SYS$INPUT SYS$COMMAND:%           $ EDIT/TPU/OUTPUT='P2' 'P1' A           $_EXIT_________________________________________________                                     A                                                            CMD-47                     Command Descriptions!           SET FORCE_MAIL_PROTOCOL-        A           _______________________________________________________   !           SET FORCE_MAIL_PROTOCOL_  9           Forces NEWSRDR to use the VMS MAIL foreign mailr/           protocol handler for local addresses.w  A           _______________________________________________________u             FORMAT  %           SET [NO]FORCE_MAIL_PROTOCOLp  A           _______________________________________________________              DESCRIPTION =           By default, NEWSRDR sends messages directly via VMS >           MAIL when the destination address does not appear to>           be a network-type mail address. With SET FORCE_MAIL_=           PROTOCOL, you can force all addresses to be handled >           by your network mail handler (called a "foreign mail-           protocol" in VMS MAIL terminology).   ;           This feature may be useful if your network mailer 9           includes support for per-user aliases and othera?           features in which a network mail address might appear +           to NEWSRDR to be a local address.a                                     CMD-48 e       A                                              Command DescriptionstA                                                          SET FORMf        A           _______________________________________________________h             SET FORM  >           Specifies the form to use by default for print jobs.  A           _______________________________________________________              FORMAT  !           SET [NO]FORM  form-name   A           _______________________________________________________r             PARAMETERS           form-namer&           The name of the form to use.  A           _______________________________________________________              DESCRIPTION :           This command sets the default form to be used by@           default for print jobs created with the PRINT command.=           When no form is set, the default form is taken from            the print queue.                              A                                                            CMD-49n o  f               Command Descriptions           SET HEADERSe        A           _______________________________________________________              SET HEADERS_  7           Selects the header lines to appear in articleS           displays.r  A           _______________________________________________________              FORMAT  )           SET HEADERS  [NO]header-name...   A           _______________________________________________________u)           Command Qualifiers     Defaults              /EXTRACT-           /INTERACTIVE           /INTERACTIVE   A           _______________________________________________________              PARAMETERS           header-name 9           The name of a header line to be included or, if <           preceded by "NO", excluded from subsequent article=           displays. You may specify more than one header nameo?           by separating them with commas. Table CMD-1 lists theo0           valid header names and their meanings.  A           Table_CMD-1__Header_names______________________________n             HeaderA           name_______Meaning_____________________________________R  ?           FROM       the "From:" line, which indicates who senta                       the message  ?           DATE       the "Date:" line, which indicates when theoA                      message was originally posted to the network   A           NEWSGROUPS the "Newsgroups:" line, which identifies the <                      newsgroups to which the message belongs             CMD-50    x    A                                              Command Descriptions A                                                       SET HEADERSh        A           Table_CMD-1_(Cont.)__Header_names______________________.             HeaderA           name_______Meaning_____________________________________i  9           SUBJECT    the "Subject:" line, usually a brief =                      description of what the message is abouto  @           MESSAGE_   the "Message-ID:" line, a unique identifier$           ID         for the message  ?           PATH       the "Path:" line, which shows the path ther=                      message took to reach the current systemy  @           REPLY_TO   the "Reply-to:" line, which indicates where2                      mailed replies should be sent  =           SENDER     the "Sender:" line, which identifies theh:                      entity responsible for submitting the+                      message to the networku  A           FOLLOWUP_  the "Followup-to:" line, which indicates the A           TO         newsgroup(s) where follow-up articles should                       be posted  ;           EXPIRES    the "Expires:" line, which indicates a ?                      suggested expiration date and time for the                       article  A           REFERENCES the "References:" line, which identifies the/?                      message(s) that prompted the submission oft!                      the messages   >           DISTRIBUTIOthe "Distribution:" line, which indicates:                      the distribution scope of the message  ?           ORGANIZATIOthe "Organization:" line, which identifiesiA                      the organization to which the sender belongsf  <           KEYWORDS   the "Keywords:" line, which may include@                      some keywords related to the content of the                      message  @           SUMMARY    the "Summary:" line, a brief summary of the                      message  A                                                            CMD-51t    t               Command Descriptions           SET HEADERSm        A           Table_CMD-1_(Cont.)__Header_names______________________e             HeaderA           name_______Meaning_____________________________________j  9           APPROVED   the "Approved:" line, indicating theB8                      moderator that approved the message  @           LINES      the "Lines:" line, which indicates the size#                      of the messageI  >           XREF       the "Xref:" line, which identifies cross-A           ___________postings____________________________________   A           _______________________________________________________              DESCRIPTION ?           This command can be used to omit uninteresting header ?           lines from article displays or extracted articles, to ?           provide more room for article text. Note that not alls?           articles have all the header lines you can specify onA>           this command; the header line types are provided for           completeness.   A           _______________________________________________________              QUALIFIERS           /EXTRACT@           The header settings are applied to extracted articles.             /INTERACTIVE@           The header settings are applied to interactive article           displays.e                         CMD-52 i  .    A                                              Command DescriptionslA                                                        SET IGNOREi        A           _______________________________________________________e             SET IGNORE  <           Establishes or removes a criterion for permanently           ignoring articles.  A           _______________________________________________________e             FORMAT  $           SET [NO]IGNORE  group-name  A           _______________________________________________________ )           Command Qualifiers     Defaults              /GLOBAL            /FROM=pattern            /NEWSGROUPS=pattern            /SUBJECT=pattern  A           ________________________________________________________             PARAMETERS           group-name7           The name of the newsgroup to which the ignorei?           criterion should be added. Not specified when /GLOBAL_9           is used. If omitted, the current group is used.   A           ________________________________________________________             DESCRIPTION_9           This command is used to add or remove an ignoree:           criterion (sometimes called a "kill file") for a?           single newsgroup or for all newsgroups. The criterionf@           can be based on the author of the article (/FROM), the>           subject of the article (/SUBJECT), or the Newsgroups;           header of the article (/NEWSGROUPS). Any articlesr@           matching the criterion will automatically be marked as?           seen and will not be displayed when READ/NEW is used.c  8           Use SET NOIGNORE to remove an erroneous ignore=           criterion or when the subject or author you wish tol8           ignore is at a more reasonable activity level.  A                                                            CMD-53                     Command Descriptions           SET IGNORE        @           Ignore criteria are stored in your NEWSRDR profile and0           are retained between NEWSRDR sessions.  8           This command should be used sparingly and with           caution.  A           ________________________________________________________             QUALIFIERS           /GLOBAL 6           Makes the ignore criterion effective for all           newsgroups._             /FROM=pattern_=           Bases the criterion on the author (From line) of an =           article. The pattern may contain VMS wildcards. Any @           From line matching the wildcard pattern, or containing>           the specified text if no wildcards are used, will be@           ignored. You may specify only one ignore criterion per           command.             /NEWSGROUPS=patternl<           Bases the criterion on the Newsgroups header of an=           article. The pattern may contain VMS wildcards. Anyt;           Newsgroups line matching the wildcard pattern, or ;           containing the specified text if no wildcards arer@           used, will be ignored. You may specify only one ignore            criterion per command.             /SUBJECT=pattern;           Bases the criterion on the subject of an article. <           The pattern may contain VMS wildcards. Any subject;           line matching the wildcard pattern, or containing_>           the specified text if no wildcards are used, will be@           ignored. You may specify only one ignore criterion per           command.                   CMD-54 s  W    A                                              Command DescriptionstA                                               SET NEWGROUP_ACTIONw        A           _______________________________________________________a             SET NEWGROUP_ACTION   @           Sets the action NEWSRDR should taken on discovery of a           new newsgroup.  A           _______________________________________________________              FORMAT  %           SET NEWGROUP_ACTION  action_  A           _______________________________________________________l             PARAMETERS           action6           The action to be taken on discovery of a new9           newsgroups. This can be one of NONE, PROMPT, or =           SUBSCRIBE. See the description section for details._  A           ________________________________________________________             DESCRIPTIONn<           The default action, NONE, has NEWSRDR announce the9           presence of each new newsgroup, with no furtherT>           action. Setting the PROMPT action has NEWSRDR prompt9           you interactively for whether you would like to.8           subscribe to each new newsgroup. The SUBSCRIBE<           action has NEWSRDR subscribe you to new newsgroups+           automatically, with no prompting.                   A                                                            CMD-55e r  _               Command Descriptions           SET NEWSRC        A           _______________________________________________________f             SET NEWSRC  4           Enables/disables the use of a newsrc file.  A           _______________________________________________________h             FORMAT  %           SET [NO]NEWSRC  [file-spec]T  A           _______________________________________________________i)           Command Qualifiers     Defaults   3           /[NO]SUBSCRIBED_ONLY   /NOSUBSCRIBED_ONLYi  A           _______________________________________________________I             PARAMETERS           [file-spec]_=           Name of the newsrc file. If omitted, it defaults to            SYS$LOGIN:XX.NEWSRC.  A           ________________________________________________________             DESCRIPTION >           This command enables or disables the use of a newsrc@           file. Newsrc files are described in Section 1.17. They<           are plain text files, typically used by other news=           readers, that describe the newsgroups you subscribe_=           to and which articles you have seen. Using a newsrc ;           file increases NEWSRDR's compatibility with otherf=           news readers and allows you to control the order ine>           which newsgroups are visited during NEWSRDR sessions>           by ordering the newsgroups in the newsrc file as you           desire._  A           _______________________________________________________              QUALIFIERS           /[NO]SUBCRIBED_ONLY =           By default, the newsrc file will list all availablee<           newsgroups. This is to maintain compatibility with             CMD-56 m  f    A                                              Command Descriptions A                                                        SET NEWSRCn        =           most other news readers. However, the full list cant@           take up a substantial amount of disk space. Specifying=           /SUBSCRIBED_ONLY causes NEWSRDR to save informationn?           only about the newsgroups you are subscribed to. Thisn?           may reduce compatibility with other news readers, but @           saves on disk space and still provides the opportunity<           to modify the newsgroup visiting order for NEWSRDR           sessions.b                                                                A                                                            CMD-57  e  e               Command Descriptions           SET PERSONAL_NAME         A           _______________________________________________________e             SET PERSONAL_NAME   @           Establishes a "personal name" to accompany your return           address.  A           _______________________________________________________y             FORMAT  )           SET [NO]PERSONAL_NAME  ["name"]   A           _______________________________________________________G)           Command Qualifiers     Defaultst             /MAILl  A           _______________________________________________________              PARAMETERS           name;           Any readable text string, not including quotationo;           marks or backslashes, to be used as your personal            name.-  A           _______________________________________________________D             DESCRIPTION @           This command is used to set up or remove your personal<           name. The name is added to your return address for7           articles you post and mail messages you send.   A           _______________________________________________________              QUALIFIERS           /MAIL ;           Causes NEWSRDR to use your VMS MAIL personal namea           setting.             CMD-58    T    A                                              Command Descriptions!A                                                         SET QUEUE         A           _______________________________________________________t             SET QUEUE   ?           Specifies the queue to use by default for print jobs._  A           _______________________________________________________              FORMAT             SET QUEUE  queue-name   A           ________________________________________________________             PARAMETERS           queue-name'           The name of the queue to use.   A           _______________________________________________________n             DESCRIPTION ;           This command sets the default queue to be used by_@           default for print jobs created with the PRINT command.#           The default is SYS$PRINT.R                                A                                                            CMD-59_ _  _               Command Descriptions           SET REPLY         A           ________________________________________________________             SET REPLY_  @           Sets the default sending mechanism for REPLY commands.  A           _______________________________________________________e             FORMAT  #           SET REPLY  reply-type ...k  A           _______________________________________________________              PARAMETERS           reply-type<           Either POST or MAIL, depending on whether you want>           your replies to be posted to the newsgroup or mailed>           to the article poster. You can specify more than one4           reply type by separating them with commas.  A           _______________________________________________________t             DESCRIPTION ;           This setting is used to determine whether replies >           are posted, mailed, or both, when you do not specify7           either the /POST or /MAIL on a REPLY command.F                                     CMD-60 _  _    A                                              Command DescriptionseA                                                          SET SEEN_        A           _______________________________________________________              SET SEEN  :           Marks an article or group of articles as "seen".  A           _______________________________________________________              FORMAT  *           SET [NO]SEEN  [article-range...]  A           _______________________________________________________ )           Command Qualifiers     Defaultsu             /ALL           /SUBJECT=(pattern...)t           /THREAD.  A           _______________________________________________________              PARAMETERS           article-range :           A single article number or a starting and ending<           article number separated by a hyphen. All articles3           in the specified range are marked "seen"._  A           _______________________________________________________              DESCRIPTIONr>           This command is used to mark articles as having been<           seen, even if you haven't read them. This prevents>           them from being displayed with the READ/NEW command.>           SET NOSEEN has the reverse effect; it may be used as'           an alternative to SET UNSEEN.u  A           _______________________________________________________T             QUALIFIERS           /ALL9           Causes all articles in the current newsgroup to <           marked. No other qualifiers may be used with /ALL.  A                                                            CMD-61q t  t               Command Descriptions           SET SEEN                   /SUBJECT=(pattern...)m?           Causes an article to be marked if its subject matchess?           one of the specified patterns. If no article range is_?           specified, it defaults to the current article onward._             /THREAD_@           Causes each article in the current newsgroup, from the=           current article onward, to be marked if the subject ;           of the article matches the subject of the currenth           article.                                                                       CMD-62 e  r    A                                              Command DescriptionswA                                                     SET SIGNATURE         A           _______________________________________________________              SET SIGNATURE   )           Establishes a "signature" file._  A           _______________________________________________________r             FORMAT  (           SET [NO]SIGNATURE  [file-spec]  A           _______________________________________________________ )           Command Qualifiers     Defaultsm  7           /[NO]AUTOMATIC=(send-ty/AUTOMATIC=(POST,MAIL)l  A           _______________________________________________________              PARAMETERS           file-specs8           Name of the file in which you have stored your           signature.  A           _______________________________________________________              DESCRIPTION =           This command can be used to establish a "signature"n;           file. The contents of the signature file (up to 8i=           lines of text) is appended to messages you send andw=           articles you post, and can contain information suchi=           as your name, company, E-mail address, etc. Use SETr5           NOSIGNATURE to clear the signature setting.   A           _______________________________________________________              QUALIFIERS#           /AUTOMATIC=(send-type...)            /NOAUTOMATIC5           Specifies when the signature file should bef>           automatically appended: on mail messages, on article>           postings, or both. Possible values for send-type are?           MAIL and POST. The default is for automatic signature >           inclusion on both mail and article postings. Specify  A                                                            CMD-63t o  n               Command Descriptions           SET SIGNATUREt        <           /NOAUTOMATIC to prevent automatic inclusion of the           signature file.   5           This setting can be overridden by using the >           /[NO]SIGNATURE qualifier on the FORWARD, MAIL, POST,           and REPLY commands.                                                                                CMD-64 t  s    A                                              Command Descriptions_A                                                        SET UNSEEN_        A           _______________________________________________________e             SET UNSEEN  <           Marks an article or group of articles as "unseen".  A           _______________________________________________________i             FORMAT  (           SET UNSEEN  [article-range...]  A           _______________________________________________________i)           Command Qualifiers     Defaults              /ALL           /SUBJECT=(pattern...)_           /THREAD   A           _______________________________________________________t             PARAMETERS           article-ranges:           A single article number or a starting and ending?           article number separated by a hyphen. All articles inl>           the specified range are marked "unseen". If omitted,/           the current article is marked unseen.   A           ________________________________________________________             DESCRIPTION >           This command is used to mark articles as having been;           unseen, so they can be recalled the next time you ?           use READ/NEW or READ/NEXT/NEW. This can be useful for ?           long articles you want to skip in the current NEWSRDR 7           session but would like to come back to later.r  A           _______________________________________________________I             QUALIFIERS           /ALL9           Causes all articles in the current newsgroup to ;           marked. No other qualifiers may be specified withr           /ALL.   A                                                            CMD-65_ _  _               Command Descriptions           SET UNSEEN                   /SUBJECT=(pattern...)_?           Causes an article to be marked if its subject matchesl?           one of the specified patterns. If no article range isr?           specified, it defaults to the current article onward.              /THREAD_@           Causes each article in the current newsgroup, from the=           current article onward, to be marked if the subjecto;           of the article matches the subject of the currents           article.                                                                       CMD-66 _  _    A                                              Command Descriptions_A                                                              SHOW         A           _______________________________________________________g             SHOW  ?           Displays profile settings and other information abouth"           the NEWSRDR environment.  A           _______________________________________________________o             FORMAT-                 { ARCHIVE_DIRECTORY         }c-                 { CURRENT_GROUP             } -                 { DIRECTORY_WIDTH           }W-                 { EDIT                      }o-                 {                           }w-                 { FORM                      } -                 { GROUP                     }.-                 { HEADERS                   } -           SHOW  {                           }o-                 { IGNORE [/GLOBAL] [/LOCAL] } -                 { NEWSRC                    }N-                 { PERSONAL_NAME             }e-                 {                           }s-                 { QUEUE                     }t-                 { SERVER                    }_-                 { SIGNATURE_FILE            }E-                 {                           }o-                 { ALL                       }r  A           _______________________________________________________t             PARAMETERS           ARCHIVE_DIRECTORYp9           Displays the current archive directory setting.              CURRENT_GROUPr@           Displays the name of the current newsgroup, along with?           the number of the first and last available article ine           the group.             DIRECTORY_WIDTHW8           Displays the current directory width settings.  A                                                            CMD-67w c  s               Command Descriptions           SHOW                   EDIT?           Displays the current SET EDIT setting and the name of $           your selected text editor.             FORM2           Displays the default print form, if any.             GROUP @           Displays the name of the current newsgroup, along with?           the number of the first and last available article inm2           the group. (Same as SHOW CURRENT_GROUP.)             HEADERSt3           Displays the current SET HEADERS setting..             IGNORE<           Displays the ignore criteria for the current group?           (/LOCAL) and/or the global ignore criteria (/GLOBAL).             The default is /LOCAL.             NEWSRC+           Displays the newsrc file setting.              PERSONAL_NAME_9           Displays the current SET PERSONAL_NAME setting.E             QUEUE 3           Displays the default print queue setting.v             SERVER:           Displays the Internet host name of the NNTP news           server machine.              SIGNATURE_FILE5           Displays the current SET SIGNATURE setting._  
           ALL_0           Displays all of the above information.               CMD-68         A                                              Command DescriptionssA                                                              SHOWr      A           ________________________________________________________             DESCRIPTION 9           This command can be used to look at any of yourE<           profile settings as well as some information about:           your NEWSRDR environment. See the description of<           the SET command for more information about profile           settings.e                                                                  A                                                            CMD-69  u  a               Command Descriptions           SPAWN         A           _______________________________________________________              SPAWNc  :           Creates a subprocess of the current process. The>           context of the subprocess is copied from the current9           process. You can use the SPAWN command to leave.@           NEWSRDR temporarily, perform other functions, and then           return to NEWSRDR.  A           ________________________________________________________             FORMAT             SPAWN  [command]  A           _______________________________________________________O)           Command Qualifiers     Defaults_  1           /INPUT=filespec        /INPUT=SYS$INPUT /           /[NO]LOGICAL_NAMES     /LOGICAL_NAMESa3           /OUTPUT=filespec       /OUTPUT=SYS$OUTPUT "           /PROCESS=subprocess-name)           /[NO]SYMBOLS           /SYMBOLS_&           /[NO]WAIT              /WAIT  A           _______________________________________________________              PARAMETERS           commandi?           Specifies the DCL command string that executes in thes=           context of the created subprocess. When the commandp=           completes, the subprocess terminates and control is.>           returned to the parent process. If this parameter is?           not specified, a subprocess is created that transferst'           control to DCL command level.a  A           _______________________________________________________u             QUALIFIERS           /INPUT=filespec 8           Specifies an input file containing one or more;           DCL command strings to be executed by the spawnedL             CMD-70 t  h    A                                              Command DescriptionsoA                                                             SPAWN         @           subprocess. If you specify a command string along with?           an input file, the command string is processed before <           the commands in the input file. Once processing is1           complete, the subprocess is terminated.e             /[NO]LOGICAL_NAMES@           Specifies that the logical names of the parent process=           are to be copied to the subprocess. When you do notu=           want the subprocess to use the logical names of the ?           parent process, enter the qualifier /NOLOGICAL_NAMES.d(           The default is /LOGICAL_NAMES.             /OUTPUT=filespec<           Identifies the output file to which the results of?           the SPAWN operation are written. Whenever you use the <           /NOWAIT qualifier, you should also use the /OUTPUT>           qualifier to specify a new output destination. Doing;           so prevents output from being displayed while you >           are specifying new commands. If you omit the /OUTPUT@           qualifier, output is written by default to the current           SYS$OUTPUT device.  "           /PROCESS=subprocess-name=           Specifies the name of the subprocess to be created._=           The default name of the subprocess is "USERNAME_n".u             /[NO]SYMBOLS9           Determines whether the system passes DCL global_=           and local symbols to the subprocess. The default is            /SYMBOLS.              /[NO]WAITo@           Controls whether the system waits until the subprocess:           is completed before allowing more commands to be8           specified. The /NOWAIT qualifier allows you to=           specify new commands while the specified subprocess =           is running. If you specify /NOWAIT, you should also ?           use the /OUTPUT qualifier to direct the output stream_@           to a file, rather than displaying it on your terminal.  A                                                            CMD-71V M                  Command Descriptions           SPAWN8        <           Doing so prevents your terminal from being used by/           more than one process simultaneously.                                                                                        CMD-72 _  _    A                                              Command DescriptionseA                                                             STORE_        A           _______________________________________________________n             STORE_  >           Forwards a copy of a news article to yourself by VMS           Mail.   A           _______________________________________________________              FORMAT  !           STORE  [article-number]n  A           _______________________________________________________u             PARAMETERS           article-number;           Number of the article to be sent. If omitted, theS"           current article is sent.  A           _______________________________________________________D             DESCRIPTION >           This command sends the specified article by VMS Mail?           to yourself. The message subject is automatically set 8           to the subject of the article being forwarded.  9           This command could be used to store articles of_?           interest into VMS Mail, where you could organize them            into mail folders.                    A                                                            CMD-73E                    Command Descriptions           SUBSCRIBEg        A           _______________________________________________________o             SUBSCRIBEt  @           Adds one or more newsgroups to your subscription list.  A           ________________________________________________________             FORMAT  !           SUBSCRIBE  newsgroup...O  A           _______________________________________________________ )           Command Qualifiers     Defaults              /CONFIRM           /GOTOO%           /[NO]LOG               /LOG   A           _______________________________________________________              PARAMETERS           newsgroupe7           Name of a newsgroup you wish to subscribe to, 9           or a wildcard pattern. All available newsgroups_?           matching the specified patterns will be added to yourk           subscription list.  A           ________________________________________________________             DESCRIPTION =           This command is used to begin following one or more >           newsgroups. The newsgroup name and information about@           articles you have seen in the group are stored in your           NEWSRDR profile.  A           ________________________________________________________             QUALIFIERS           /CONFIRM>           When specified, NEWSRDR asks for confirmation before6           adding a newsgroup to the subscription list.             CMD-74 l       A                                              Command Descriptions_A                                                         SUBSCRIBEC                   /GOTOc:           Causes the subscribed newsgroup to be set as the9           current group. On wildcard subscribes, the last /           subscribed newsgroup becomes current.n             /[NO]LOG7           By default, NEWSRDR issues a message for eachn9           successful addition. Use /NOLOG to suppress the_           messages._                                                              A                                                            CMD-75a d  o               Command Descriptions           UNSUBSCRIBE         A           _______________________________________________________o             UNSUBSCRIBE   ?           Removes one or more newsgroups from your subscriptiona           list.o  A           _______________________________________________________t             FORMAT  #           UNSUBSCRIBE  newsgroup...a  A           _______________________________________________________ )           Command Qualifiers     Defaultsp             /CONFIRM%           /[NO]LOG               /LOG   A           _______________________________________________________r             PARAMETERS           newsgroup =           Name of a newsgroup you no longer wish to subscriber@           to, or a wildcard pattern. All newsgroups matching the=           pattern will be removed from the subscription list.   A           ________________________________________________________             DESCRIPTION =           This command is used to end your participation in a_;           newsgroup. The group is removed from your NEWSRDR_=           profile, and you will no longer see any articles ini           that newsgroup._  A           _______________________________________________________              QUALIFIERS           /CONFIRM>           When specified, NEWSRDR asks for confirmation before6           adding a newsgroup to the subscription list.             CMD-76    i    A                                              Command Descriptions A                                                       UNSUBSCRIBE_                   /[NO]LOG7           By default, NEWSRDR issues a message for eachs9           successful addition. Use /NOLOG to suppress the            messages.                                                                         A                                                            CMD-77  s  u               Command Descriptions           UPDATE        A           ________________________________________________________             UPDATE  ?           Updates NEWSRDR's newsgroup information from the NNTPC           server.   A           _______________________________________________________u             FORMAT             UPDATE  A           _______________________________________________________ )           Command Qualifiers     Defaultsd             /PARTIAL  A           _______________________________________________________e             DESCRIPTION @           This command can be used to discover further available=           unread articles since the last update. This is doneR9           automatically for you at the start of a NEWSRDRl@           session, but if you have spent a long time in NEWSRDR,=           this command should be used. A message is displayedi@           for each newsgroup in which unseen articles are found.  >           Information about all active newsgroups is provided,4           unless you specify the /PARTIAL qualifier.  A           _______________________________________________________              QUALIFIERS           /PARTIAL8           Only information about newsgroups to which you;           are subscribed is obtained. This qualifier shouldn=           generally not be used, since the information from a_?           full update is needed for some other NEWSRDR commandsM           to work properly.a             CMD-78