                                              NEWSRDR User's Guide                   September, 1992     ;           This manual describes NEWSRDR, an NNTP-based news !           reader for VMS systems.           A           Revision/Update Information:  This is a revised manual.   9           Operating System and Version: VMS V5.0 or later   4           Software Version:             NEWSRDR V4.0                 Matthew Madison            TGV, Inc.             Santa Cruz, California                                             "           ________________________           15 September 1992   =           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.         |6        |  DISCLAIMER: The author and TGV, Inc. 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:  9           DEC                   ULTRIX                VAX #           VAXcluster            VMS         |9        |  MultiNet is a registered trademark of TGV, Inc.              __________8           Copyright 1992 Matthew D. Madison. 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-3   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-9   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-11   A                 _________________________________________________ A                 1.11  PROFILE SETTINGS                       1-11   A                 1.11.1    Personal Name  _________________   1-12   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-14   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-15   A                 _________________________________________________ A                 1.16  USING A NEWSRC FILE                    1-15              iv         A                                                          Contents       A                 1.16.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-11:                 DIRECTORY/GROUP                     CMD-14:                 EXIT                                CMD-16:                 EXTRACT                             CMD-17:                 FOLLOWUP                            CMD-19:                 FORWARD                             CMD-20:                 GROUP                               CMD-22:                 HELP                                CMD-23:                 MAIL                                CMD-24:                 NEXT                                CMD-26:                 POST                                CMD-27:                 PRINT                               CMD-30:                 READ                                CMD-34:                 REPLY                               CMD-37:                 SET ARCHIVE_DIRECTORY               CMD-41:                 SET DIRECTORY_WIDTH                 CMD-42:                 SET EDIT                            CMD-43:                 SET FORM                            CMD-46:                 SET HEADERS                         CMD-47:                 SET IGNORE                          CMD-50:                 SET NEWSRC                          CMD-52:                 SET PERSONAL_NAME                   CMD-54:                 SET QUEUE                           CMD-55:                 SET REPLY                           CMD-56:                 SET SEEN                            CMD-57:                 SET SIGNATURE                       CMD-59:                 SET UNSEEN                          CMD-61:                 SHOW                                CMD-62    A                                                                 v                     Contents      :                 SPAWN                               CMD-65:                 STORE                               CMD-68:                 SUBSCRIBE                           CMD-69:                 UNSUBSCRIBE                         CMD-71:                 UPDATE                              CMD-73    A           _______________________________________________________            FIGURES   0                 CMD-1     Spawned editor commandA                           procedure  _____________________ CMD-45   A           _______________________________________________________            TABLES  A                 CMD-1     Header names  __________________ CMD-47                                                            vi               A           _______________________________________________________              Preface     <           USENET news is now pervasive even among VMS users.@           There are several 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.        A                                                               vii                     Preface     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;           News Transfer Protocol, which describes NNTP news            service.                                                                         viii               A           _______________________________________________________   "           New and Changed Features    >           NEWSRDR V4.0 includes the following new features and           changes:  @           o  The entire program has been rewritten in C, and can@              be compiled for both VAX/VMS and Alpha/VMS systems.  =           o  The SET NEWSRC command has been added, for users ?              who use other news readers in addition to NEWSRDR. =              NEWSRDR will use the contents of the newsrc file =              to maintain subscription status and article-seen @              status for all newsgroups, and to control the order-              in which newsgroups are visited.   :           o  The SET QUEUE and SET FORM commands have been?              added, which allow the user to specify the default ;              print queue and form to use on PRINT commands.   <           o  The SET DIRECTORY_WIDTH command has been added,;              to allow the user to control the widths of the ?              From and Subject fields displayed by the DIRECTORY <              command. In addition, zero field widths are now              supported.   ;           o  The DIRECTORY command display now includes the ?              number of lines in the article (if available), and 1              no longer displays ignored articles.   ?           o  READ/NEXT/NEW now behaves correctly after manually 4              changing groups with the GROUP command.  ;           o  A message displaying the group name, available ?              articles, and unseen article count is now produced 7              when the group is changed with GROUP or by               READ/NEXT/NEW.   @           o  A user with SETPRV or SYSNAM privilege can override?              the system-wide NEWSRDR_SERVER setting for herself 9              by defining that logical name in the process                logical name table.  A                                                                ix          "           New and Changed Features      :           o  You can now use a dot to refer to the current9              article in those commands which take article               ranges.  @           o  The /GOTO qualifier has been added to the SUBSCRIBE:              command, which makes the subscribed newsgroup              current.   6           o  The /SORT qualifier has been added to the?              DIRECTORY/GROUP command to cause the group listing ?              to be displayed in alphabetical order (only needed 1              with user-specified group ordering).   0           o  Other minor improvements and fixes.  <           Note: Due to the rewrite, the character-conversion;           interface has changed. Please refer to the KANJI_ @           CONVERSION module included in the NEWSRDR distribution           kit as an example.                                                       x                  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:   8                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:  (                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.   %           ___________________________S  #    1.1.1  Cancelling a Subscriptioni  9           The UNSUBSCRIBE command (format the same as forf<           SUBSCRIBE, above) is used to cancel a subscription           to a newsgroup.   
           1-2u o  e    A                                                     Using NEWSRDR     L           __________________________________________________________________      1.2    Reading New News  6           Once you have subscribed to some newsgroups,;           information about which articles you have seen int=           those newsgroups is stored in your NEWSRDR profile.            The commandr                  News> READ/NEWe  =           is used to start reading news articles you have notw:           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,c=           also like VMS MAIL. At the bottom of each page, 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 (sometimes <           done for articles containing potentially sensitive?           or offensive material), you can read the encoded text_*           with the command CURRENT/ROTATE.  %           ___________________________-      1.2.2  Following a Thread  =           You can use the READ command to follow a discussion >           thread within a newsgroup. While reading an article,           enter                    News> READ/THREAD  A                                                               1-3                     Using NEWSRDR       6           to cause NEWSRDR to scan forward through the;           newsgroup, displaying those articles that containK;           the same subject as the article you are currently >           reading. Once started, just press RETURN to continue=           reading the thread. When there are no more articlesN=           with matching subject lines, the current article is =           set back to the first article in the thread, so youi2           can continue reading where you left off.  %           ____________________________      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*)   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/SUBJECT_  >           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     1    A                                                     Using NEWSRDR     L           __________________________________________________________________      1.3    Skipping Articlest  <           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  7                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". Multiple@           numbers or ranges can be given by separating them with           commas.   =           You can also use SET SEEN to skip over a collection ;           of articles related to one topic. When reading an_           article, the command  $                News> SET SEEN/THREAD  9           can be used to skip all further articles in the ?           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 theM8           articles "unseen" with the SET UNSEEN command:  9                News> SET UNSEEN [/ALL] [article-range...]M  ?           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 command4;           to permanently ignore articles with subject lines %           containing particular text:   <                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, use ,           the /FROM qualifier on SET IGNORE:  9                News> SET IGNORE [/GLOBAL] /FROM="pattern"   =           Any article with a From line matching the specified9"           pattern will be ignored.  <           You can also ignore articles that are cross-posted=           to newsgroups you aren't interested in by using the .           /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:  J                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.C  
           1-6  _  _    A                                                     Using NEWSRDR     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:  &                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:f  )                News> [READ] articlenumbers  ?           (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:   A                News> DIRECTORY [/SEEN] [/UNSEEN] [article-number]b  ;           If you specify an article number on the DIRECTORYo8           command, the directory listing begins with the=           specified article. Otherwise, the directory listings@           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 Articles   :           You can save the text of any article or range of<           articles into a VMS file with the EXTRACT command:  I                News> EXTRACT [/[NO]APPEND] [file-spec] [article-range...]n  A                                                               1-7                     Using NEWSRDR       >           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@           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 numbere<           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 Articlese  <           You can send any article or range of articles to a-           print queue with the PRINT command:   -                News> PRINT [article-range...]m  :           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 controllings=           the print job; see the complete command descriptionr"           for further information.        
           1-8     e    A                                                     Using NEWSRDRn    %           ___________________________   #    1.8.1  Specifying PRINT Defaultsi  ;        |  You can define a default print queue with the SETr        |  QUEUE command:        |)        |       News> SET QUEUE queue-name         |7        |  This will direct subsequent print jobs to thec4        |  specified queue, rather than to SYS$PRINT.        |=        |  You can also define the default form to be used forT#        |  print jobs with SET FORM:T        |'        |       News> SET FORM form-namet        |<        |  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.Y  L           __________________________________________________________________      1.9    Posting Articles  ?           The POST command is used to post an article to one or            more newsgroups:  I                News> POST [/EDIT] [/[NO]SUBJECT="subject"] [groupname...]   ?           If you omit the "groupname", the article is posted toD?           the current newsgroup. The /EDIT qualifier is used tot>           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.d  ?           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 bem  A                                                               1-9t N  R               Using NEWSRDRd      =           posted. If you answer "no", the article will not bei           posted.   >           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 articleT           text you entered.h  %           ___________________________i      1.9.1  Followup Articles   =           A followup article is a reply to a specific article ?           which can either be posted or mailed to the author of >           the original article. You must be reading an article>           to send a reply. REPLY (or FOLLOWUP) command is used&           to compose and send replies:  U                News> REPLY [/MAIL] [/POST] [/EDIT] [/NOEXTRACT] [/[NO]SUBJECT="text"]e  ?           By using the /POST and /MAIL qualifiers, you can post @           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 tos=           compose the reply, the text of the original article =           is automatically placed in the reply (prefixed with ?           greater-than signs) before the editor is invoked. The_?           /NOEXTRACT qualifier can be used to prevent this from            occurring.  %           ___________________________       1.9.2  Cancelling an Articled  >           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:p  $                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.r             1-10 D  R    A                                                     Using NEWSRDRl    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:   N                News> MAIL [/EDIT] [/TO=(address...)] [/SUBJECT="subj"] [fspec]  >           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%"N:           prefix to direct mail to Internet addresses from=           VMS MAIL, you would not use that prefix in NEWSRDR;g?           NEWSRDR will tack the prefix onto the address for you =           automatically when sending your message through VMSu;           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 changeh@           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 thet<           news server and the name of the current newsgroup.          A                                                              1-11a c                  Using NEWSRDRg    %           ___________________________t      1.11.1 Personal Nameh  ;           Just as VMS MAIL allows you to set up a "personali;           name" which is included with your address on youra9           outgoing mail, NEWSRDR allows you to do on newst           articles you post:  2                News> SET PERSONAL_NAME "your name"  >           You may use any name you like as your personal name.  %           ___________________________       1.11.2 Article Headersg  :           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 commandt  2                News> SET HEADERS [NO]headername...  =           is used to turn on or off the display of particulars9           header lines when you read subsequent articles.e;           The header names you can specify are: FROM, DATE, 7           NEWSGROUPS, SUBJECT, MESSAGE_ID, PATH, REPLY_w7           TO, SENDER, FOLLOWUP_TO, EXPIRES, REFERENCES, @           DISTRIBUTION, ORGANIZATION, KEYWORDS, APPROVED, LINES,;           and XREF. Specifying NO in front of a header nameR7           turns off its display in subsequent messages.   %           ___________________________   (    1.11.3 Automatic Editing, Editor Name  ?           If you would like to use a text editor every time youn=           compose an article or mail message, you can use theh7           SET EDIT command to enable automatic editing:r  =                News> SET [NO]EDIT [/EDITOR=(editorname,CALL)]   3           If you use SET EDIT, the text editor willn=           automatically be invoked for every POST, REPLY, and =           MAIL command, unless you use the /NOEDIT qualifier.e             1-12 f  f    A                                                     Using NEWSRDRb      @           You can turn off automatic editing with the SET NOEDIT           command.  ;           In either case, you can specify which text editorc;           you would like to use with the /EDITOR qualifier. ?           Any callable editor may used; TPU (a.k.a. EVE) is the <           default. VMS comes with one other callable editor::           EDT. The VAX Language-Sensitive Editor (LSE), if?           installed on your system, can also be used. There maye@           also be other callable editors available at your site.  @           If the editor you wish to use is not callable, you can?           instead set up a command procedure to be spawned as aw2           subprocess which will invoke the editor:  H                News> SET [NO]EDIT [/EDITOR=("@command-procedure",SPAWN)]  <           The command procedure must be of the form shown in           Figure CMD-1.e  %           ___________________________n      1.11.4 Signatureo  <           Some people like to have a standard "signature" be=           included at the end of each article they post. This >           signature usually contains the person's name, E-mail?           address, company name, and a disclaimer of some kind. =           The SET SIGNATURE command allows you to specify thei?           name of a file to be used as a signature for articless.           you post and mail messages you send:  0                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 willo=           automatically be appended to every article you posta>           and every mail message you send through NEWSRDR. Use>           the SET NOSIGNATURE command to disable the inclusion           of a signature file.  A                                                              1-13b i  g               Using NEWSRDR     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.n  L           __________________________________________________________________      1.13   Keypad Keysu  <           NEWSRDR provides a DEFINE/KEY command for defining;           keys to perform NEWSRDR commands. This command isa;           also patterned after its counterpart in VMS MAIL._9           In addition, you can create a file containing a4=           collection of DEFINE/KEY commands to be loaded eachv@           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 keyS<           definitions in another file and assign the name of8           that file to the logical name NEWSRDR_KEYDEFS.  L           __________________________________________________________________  '    1.14   Setting Your Reply-To Addressn  9           Typically, when you post an article, the "From"_;           address that is entered in the article is used toi=           address E-mail for replies that are mailed directlyr9           to you. If you prefer to have replies sent to ac<           different E-mail address, you can define a logical8           name containing your preferred E-mail address:  <                $ 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.c               1-14 k       A                                                     Using NEWSRDR     L           __________________________________________________________________      1.15   Header Caching  =           Some NEWSRDR commands, such as READ/THREAD, require ?           access to article headers for their operation. To cutw=           down on network and news server load, and generallyl9           improve performance over multiple uses of theser?           header-intensive commands, article headers are cached ?           in memory by NEWSRDR when they are retrieved from then>           server. By default, up to 128 sets of headers may be=           cached at once. However, you can control the headerI:           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:  5                $ DEFINE NEWSRDR_HEADER_CACHE_SIZE 256N  ;           This will cause NEWSRDR to hold up to 256 sets ofR           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 few_           articles at a time._  L           __________________________________________________________________      1.16   Using a NEWSRC File   :        |  By default, all information about newsgroups you8        |  subscribe to and the articles you have seen in;        |  those groups is kept in your NEWSRDR profile. Yout<        |  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<        |     subscription/article information for both. Most=        |     other news readers use a newsrc file by default.s        |>        |  2  You want to be able to control the order in which>        |     you visit newsgroups during your NEWSRDR session.        |A                                                              1-15s g  g               Using NEWSRDRf      ;        |  You specify the use of a newsrc file with the SETt        |  NEWSRC command:n        |>        |       News> SET NEWSRC [file-spec] [/SUBSCRIBED_ONLY]        |3        |  If you omit the file-spec, it defaults ton:        |  SYS$LOGIN:XX.NEWSRC. Specifying the /SUBSCRIBED_;        |  ONLY qualifier causes NEWSRDR to include only the_<        |  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.s        |>        |  NEWSRDR reads in your newsrc file after reading your;        |  NEWSRDR profile, and updates the subscription and >        |  article information. On exiting, NEWSRDR updates the=        |  newsrc file after updating your NEWSRDR profile. Itr>        |  will not overwrite an existing newsrc file, but will'        |  instead create a new version.   %           ___________________________a  $    1.16.1 Specifying Newsgroup Order  ;        |  The newsrc file is a plain text file which can bei<        |  modified with any VMS text editor. You can specify9        |  the order in which NEWSRDR visits newsgroups byy>        |  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 make         |  such changes._                               1-16 _             A           _______________________________________________________f    '           Part II  Command Descriptionse I  c    A                                              Command Descriptions A                                                            ATTACHr    A           _______________________________________________________r             ATTACH  =           Switches control of your terminal from your currentf5           process to another process in the same job.i  A           _______________________________________________________              FORMAT              ATTACH  [process-name]  A           _______________________________________________________r)           Command Qualifiers     Defaultst             /PARENTh  A           _______________________________________________________t             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           _______________________________________________________              DESCRIPTIONs?           This command is a parallel to the DCL ATTACH command.8<           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           _______________________________________________________|             QUALIFIERS           /PARENT.<           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.m  A                                                             CMD-3b v  i               Command Descriptions           BACK    A           _______________________________________________________R             BACK  $           Synonym for READ/PREVIOUS.  A           _______________________________________________________              FORMAT             BACK  A           _______________________________________________________N             DESCRIPTIONU?           Please see the description of the READ command (READ)o"           for further information.                                                           CMD-4          A                                              Command DescriptionsiA                                                            CANCEL     A           _______________________________________________________e             CANCEL  @           Cancels an article by sending a cancel control message           to the server.  A           _______________________________________________________,             FORMAT             CANCEL  [artnum]  A           _______________________________________________________e             PARAMETERS           artnum;           Article number of the article to be cancelled. Ifl>           not specified, the current article is cancelled. You=           should only cancel those articles for which you are            the author.a  A           _______________________________________________________              DESCRIPTION <           This command constructs and posts a Usenet control5           message that cancels the specified article.k                            A                                                             CMD-5_ _  _               Command Descriptions           CURRENTl    A           _______________________________________________________h             CURRENTd  <           Redisplays the current article from the beginning.  A           _______________________________________________________m             FORMAT             CURRENTn  A           _______________________________________________________E)           Command Qualifiers     Defaults              /ROTATEd  A           _______________________________________________________u             DESCRIPTIONt@           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           /ROTATEa=           Applies the ROT13 cipher to the article text beforeN:           display. Some articles are enciphered with ROT139           because they may contain sensitive or offensive <           material, leaving it up to the reader to determine?           whether the article warrants deciphering and reading.c                         CMD-6          A                                              Command Descriptions]A                                                        DEFINE/KEY     A           _______________________________________________________u             DEFINE/KEY  5           Defines a key to execute a NEWSRDR command.   A           ________________________________________________________             FORMAT  %           DEFINE/KEY  key-name string   A           _______________________________________________________c)           Command Qualifiers     Defaults   &           /[NO]ECHO              /ECHO           /IF_STATE=state-list.           /[NO]LOCK_STATE        /NOLOCK_STATE-           /[NO]SET_STATE=state   /NOSET_STATE -           /[NO]TERMINATE         /NOTERMINATEd  A           _______________________________________________________f             PARAMETERS           key-name=           Specifies the name of the key you are defining. Use 5           the following key names when defining keys:t  A           _______________________________________________________ A           Key_name______________VT100_key________LK201_key_______d  4           PF1                   PF1              PF1  4           PF2                   PF2              PF2  4           PF3                   PF3              PF3  4           PF4                   PF4              PF4  ;           KP0, KP1-KP9          keypad 0-9       keypad 0-9l  >           PERIOD                keypad period    keypad period  A                                                             CMD-7  c                  Command Descriptions           DEFINE/KEY  A           ________________________________________________________A           Key_name______________VT100_key________LK201_key_______   =           COMMA                 keypad comma     keypad commam  =           MINUS                 keypad minus     keypad minus,  :           ENTER                 ENTER key        Enter key  5           E1, FIND              n/a              Findn  <           E2, INSERT_HERE       n/a              Insert Here  7           E3, REMOVE            n/a              Remove   7           E4, SELECT            n/a              Select1  <           E5, PREV_SCREEN       n/a              Prev Screen  <           E6, NEXT_SCREEN       n/a              Next Screen  5           HELP                  n/a              Help   3           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           _______________________________________________________              DESCRIPTIONg;           This command is implemented by passing the entiree=           command to the VMS Screen Management (SMG) routines ;           for processing by SMG$DEFINE_KEY. NEWSRDR does no $           processing on the command.                 CMD-8S H  E    A                                              Command Descriptions A                                                        DEFINE/KEYi    <           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 in 9           SYS$LOGIN. Alternatively, you can call the file =           something else and define the logical name NEWSRDR_ (           KEYDEFS to point to that file.  A           _______________________________________________________e             QUALIFIERS           /[NO]ECHOp?           Specifies whether the command line is echoed when youD@           press the defined key. You cannot specify both /NOECHO1           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_STATEp@           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 usingt?           another key that sets a state. If omitted or negated,d>           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.   A                                                             CMD-9r s  a               Command Descriptions           DEFINE/KEY               /[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 command 6           to be executed. The default is /NOTERMINATE.                                                                                   CMD-10 E  l    A                                              Command Descriptions A                                                         DIRECTORY     A           _______________________________________________________a             DIRECTORYy  9           Lists information about articles in the current            newsgroup.  A           _______________________________________________________              FORMAT  %           DIRECTORY  [article-number]   A           _______________________________________________________ )           Command Qualifiers     Defaults_             /GROUP,           /EXCLUDE=(keyword=(pattern...)...)           /FROM=(pattern...)           /KEYWORD=(keyword...)            /SUBJECT=(pattern...)u           /SEEN            /UNSEEN            /WIDTH=(keyword...)e  A           ________________________________________________________             PARAMETERS           article-number<           Number of the article which should be first in the>           directory listing. If omitted, the directory listing=           begins with the current article, or, if there is noA>           current article, the first article in the newsgroup.  A           _______________________________________________________              DESCRIPTIONc9           The DIRECTORY command lists the article number,N<           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.h  A                                                            CMD-11_ _  _               Command Descriptions           DIRECTORY     9           Specifying any of /EXCLUDE, /FROM, /KEYWORD, oro;           /SUBJECT can narrow down the directory listing toe9           include or omit articles matching the specifiedr=           criteria. When specified in combination, only thosee=           articles matching all of the specified criteria aree           listed.a  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 valuess+           for keyword are FROM and SUBJECT.              /FROM=(pattern...)>           Specifies one or more patterns to be matched against9           each article's From header. Only those articles1<           matching one of the specified patterns are listed.             /KEYWORD=(keyword...)c=           Specifies one or more keywords. Only those articles 8           with Keywords headers containing the specified            keyword(s) are listed.             /SUBJECT=(pattern...)d>           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.             /SEEN @           Specifies that seen articles should be included in the=           listing. If neither /SEEN nor /UNSEEN is specified,b"           all articles are listed.                   CMD-12 v  a    A                                              Command Descriptions A                                                         DIRECTORYR               /UNSEENd;           Specifies that unseen articles should be includeda9           in the listing. If neither /SEEN nor /UNSEEN isb-           specified, all articles are listed.              /WIDTH=(keyword...) >           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 columnst>           for other fields and spacing and divides the rest of?           the terminal width evenly between the From column andi@           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.                                             A                                                            CMD-13o o                  Command Descriptions           DIRECTORY/GROUPu    A           _______________________________________________________n             DIRECTORY/GROUPt  ?           Lists information about newsgroups available from the            server.   A           _______________________________________________________              FORMAT  &           DIRECTORY/GROUP  [group-pat]  A           _______________________________________________________N)           Command Qualifiers     Defaults              /ALL(        |  /[NO]SORT              /NOSORT  A           _______________________________________________________N             PARAMETERS           group-path=           A group name or a pattern containing wildcards. Ally<           groups matching the specified pattern are included>           in the directory listing. If omitted, all groups are           listed.l  A           _______________________________________________________u             DESCRIPTIONn>           DIRECTORY/GROUP lists the names of the newsgroups to;           which are subscribed along with the number of thet:           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/ALLt?           lists information about all groups available from theo           server.              CMD-14 w  h    A                                              Command DescriptionsnA                                                   DIRECTORY/GROUP     9           Note: DIR/GROUP/ALL will not display any usefulm>           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 doned           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]SORTu;        |  Causes the groups to be listed alphabetically. Byi;        |  default, the listing is displayed in the order in_=        |  which they appear in your NEWSRDR profile (which is]@        |  alphabetical also) or in your newsrc file (if you have/        |  set one with the SET NEWSRC command).                                           A                                                            CMD-15E S                  Command Descriptions           EXIT    A           _______________________________________________________i             EXIT  "           Ends an NEWSRDR session.  A           _______________________________________________________              FORMAT             EXIT  A           _______________________________________________________              DESCRIPTIONi@           Ends the current NEWSRDR session, updates your NEWSRDR.           profile, and returns control to DCL.                                                           CMD-16 _  _    A                                              Command Descriptions A                                                           EXTRACTr    A           _______________________________________________________              EXTRACTh  +           Copies news articles into a file.   A           _______________________________________________________              FORMAT  2           EXTRACT  [file-spec] [article-range ...]  A           ________________________________________________________)           Command Qualifiers     Defaultso  *           /[NO]APPEND            See text.)           /[NO]HEADERS           /HEADERS            /ROTATE   A           ________________________________________________________             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.c  A                                                            CMD-17_ _  _               Command Descriptions           EXTRACT   A           _______________________________________________________              DESCRIPTIONs:           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]APPENDo:           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?           Causes the article header lines to be included in thet?           extraction (the default). Use /NOHEADERS to cause thea%           header lines to be omitted._             /ROTATE_=           Causes the article body to be deciphered, using the 1           ROT13 cipher, when written to the file.f                                       CMD-18 e       A                                              Command Descriptions A                                                          FOLLOWUP     A           _______________________________________________________              FOLLOWUP  =           This is a synonym for REPLY. See the description ofs4           the REPLY command for further information.  A           ________________________________________________________             FORMAT  $           FOLLOWUP  [group-name,...]  A           ________________________________________________________)           Command Qualifiers     Defaults_  "           /DISTRIBUTION=(dist ...)           /[NO]EDITs           /[NO]EXTRACT"           /FOLLOWUP_TO=(group ...)           /MAIL            /POST            /[NO]SIGNATURE%           /[NO]SUBJECT="subject-text"O           /TO=(user-spec ...)t                                A                                                            CMD-19                     Command Descriptions           FORWARD_    A           _______________________________________________________E             FORWARDe  8           Forwards a copy of a news article to a user by           electronic mail.  A           ________________________________________________________             FORMAT  #           FORWARD  [article-number]_  A           _______________________________________________________ )           Command Qualifiers     Defaults              /[NO]EDIT            /[NO]SELF '           /[NO]SUBJECT[="subject-text"]            /[NO]SIGNATURE           /TO=(user-spec...)  A           _______________________________________________________l             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           _______________________________________________________n             QUALIFIERS           /[NO]EDIT =           Specifying /EDIT causes a text editor to be invoked >           so the message text can be edited before being sent.             CMD-20    5    A                                              Command DescriptionsSA                                                           FORWARD     =           The default action for this qualifier is determined/>           by the current SET EDIT setting (see the SET command,           description for more information).             /[NO]SELFh=           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 theS:           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.N             /[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 whenO>           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-specp=           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 listi>           in parentheses. If omitted, you are prompted for the#           destination address list.s              A                                                            CMD-21  a  e               Command Descriptions           GROUPt    A           _______________________________________________________              GROUPa  =           Selects a newsgroup to be your "current" newsgroup.n  A           _______________________________________________________              FORMAT             GROUP  groupname  A           _______________________________________________________f             PARAMETERS           groupname /           Name of the group to be made current.s  A           _______________________________________________________              DESCRIPTIONt;           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.                                         CMD-22         A                                              Command DescriptionsaA                                                              HELP     A           _______________________________________________________d             HELP  $           Displays help information.  A           _______________________________________________________m             FORMAT             HELP  [topic...]  A           _______________________________________________________              PARAMETERS           topic @           The name of a topic in the help library. If omitted, a&           list of topics is displayed.  A           ________________________________________________________             DESCRIPTION_>           This command should be relatively straightforward to           use.                                  A                                                            CMD-23_                    Command Descriptions           MAIL    A           ________________________________________________________             MAIL  +           Sends an electronic mail message.P  A           _______________________________________________________e             FORMAT             MAIL  [file-spec]   A           _______________________________________________________ )           Command Qualifiers     Defaults_             /[NO]EDIT_           /[NO]SELF_'           /[NO]SUBJECT[="subject-text"]i           /[NO]SIGNATURE           /TO=(user-spec...)  A           _______________________________________________________o             PARAMETERS           file-spec @           Name of the file to be sent by E-mail. If omitted, you3           are prompted for the text of the message._  A           _______________________________________________________              DESCRIPTIONo@           This command is similar to the SEND command in the VMS5           MAIL utility, with three small differences:a  9           1  You can specify the destination users on the 1              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.   8           3  After composing or editing the text of your?              message, you are asked for confirmation before the               message is sent.              CMD-24 e       A                                              Command Descriptions A                                                              MAIL_  A           _______________________________________________________h             QUALIFIERS           /[NO]EDIT.=           Specifying /EDIT causes a text editor to be invokeds>           so the message text can be edited before being sent.=           The default action for this qualifier is determinede>           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 bea;           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 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.              /[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 sente>           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 listI>           in parentheses. If omitted, you are prompted for the#           destination address list.f    A                                                            CMD-25     h               Command Descriptions           NEXT    A           _______________________________________________________              NEXT  &           A synonym for READ/NEXT/NEW.  A           _______________________________________________________              FORMAT             NEXT  A           _______________________________________________________u)           Command Qualifiers     Defaults_             /GROUP  A           _______________________________________________________              DESCRIPTIONe?           This command, a synonym for READ/NEXT/NEW, causes the_.           next unseen article to be displayed.  A           ________________________________________________________             QUALIFIERS           /GROUP=           Instructs NEWSRDR to move on to the next subscribed ?           newsgroup before searching for new articles, skipping_=           any unread articles in the current newsgroup. If no ;           new article are found in any other newsgroup, the ?           NEWS-W-NONEW message will be displayed, even if there 4           are new articles in the current newsgroup.                           CMD-26 a       A                                              Command Descriptions_A                                                              POSTU    A           _______________________________________________________a             POST             Posts a news article.t  A           _______________________________________________________              FORMAT  ,           POST  [group-name,...] [file-spec]  A           _______________________________________________________ )           Command Qualifiers     Defaultse  '           /DISTRIBUTION=(dist-name ...)o           /[NO]EDITu           /FILE=file-spec "           /FOLLOWUP_TO=(group ...)           /[NO]SIGNATURE"           /[NO]SUBJECT[="subject"]  A           _______________________________________________________I             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-specn:           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 /FILE >           qualifier is specified, you will be prompted for the           article text.           A                                                            CMD-27[ S  u               Command Descriptions           POST  A           _______________________________________________________i             DESCRIPTIONa7           This command is used to compose and post newsb@           articles. If you do not specify a file either with the=           file-spec parameter or the /FILE qualifier, and you =           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,D=           the article is transmitted to the NNTP server to be_'           entered into the news system.   A           ________________________________________________________             QUALIFIERS           /[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).             /FILE=file-spec =           Specifies a file whose contents should be posted as =           the text of the article. This qualifier can be usede;           instead of the file-spec parameter to specify the_<           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.   '           /[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.i                   CMD-28         A                                              Command Descriptions A                                                              POST                /[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 whent@           it is posted. The default action for this qualifier is:           determined by the current SET SIGNATURE setting.  '           /DISTRIBUTION=(dist-name ...) 4           This qualifier can be used to restrict the;           distribution of the article to a particular area.i=           If not specified, no restrictions are placed on thec@           article's distribution. Typical distribution names are!           "usa", "na", "ny", etc.   "           /FOLLOWUP_TO=(group ...)>           This qualifier can be used to redirect any followups7           to this article to be posted to the specified_?           newsgroup(s). By default, followups are posted to theb2           same newsgroup(s) as the posted article.                                            A                                                            CMD-29     t               Command Descriptions           PRINT     A           _______________________________________________________l             PRINTw  =           Adds one or more articles to the current print job. @           The print job is not released to the print queue until8           you exit NEWSRDR or use the PRINT/NOW command.  A           _______________________________________________________a             FORMAT  $           PRINT  [article-range] ...  A           _______________________________________________________N)           Command Qualifiers     Defaultss  )           /AFTER=time            no delay 3           /[NO]BURST[=keyword]   default from queueE           /CANCEL '           /COPIES=n              1 copy 3           /[NO]FEED              default from queueo3           /[NO]FLAG[=keyword]    default from queueh3           /FORM=form-name        default from queue )           /[NO]HEADERS           /HEADERS (           /[NO]HOLD              no hold+           /NAME=job-name         /NAME=NEWS            /NOTIFY            /NOW$           /PARAMETERS=(parameter...)           /PRINT1           /QUEUE=queue-name      /QUEUE=SYS$PRINTs*           /[NO]ROTATE            /NOROTATE           /[NO]SPACE3           /[NO]TRAILER[=keyword]default  from queue_  A           _______________________________________________________M             PARAMETERS           article-range :           A single article number or a starting and ending<           article number separated by a hyphen. All articles             CMD-30         A                                              Command Descriptions A                                                             PRINT     ?           in the specified range are copied into the print job.t9           If omitted, only the current article is copied.   A           _______________________________________________________n             DESCRIPTION 7           This command adds the specified article(s) to_;           the current pending print job. If no print job isw?           pending, a new job is created. Using /NOW (or /PRINT)m;           causes the current pending print job to be closed_9           and submitted to the print queue; using /CANCELi<           discards the print job without printing it. If you:           specify attributes on the PRINT command that are?           incompatible with the current pending print job (suchO=           as a different value for /QUEUE), the current print ;           job is closed and printed and a new job is opened_)           before the articles are copied.A  A           _______________________________________________________b             QUALIFIERS           /AFTER=timei8           Requests that the job not be printed until the           specified date/time.             /[NO]BURST[=keyword]?           Controls whether a burst page is printed at the starts<           of the print job. Valid keyword values are ALL and;           ONE; if omitted, ALL is assumed. Note that eithere?           value has the same effect, since NEWSRDR combines alli>           printed articles into a single file before printing.             /CANCEL 0           Cancels the current pending print job.             /COPIES=ne9           Indicates the number of copies of the job to be            printed.             /[NO]FEEDM@           Controls whether form feeds are automatically inserted           at the end of a page.   A                                                            CMD-31h e  l               Command Descriptions           PRINT                /[NO]FLAG[=keyword]e>           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 eithera?           value has the same effect, since NEWSRDR combines allF>           printed articles into a single file before printing.             /FORM=form-name >           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]HOLDm@           Controls whether the job is held in the queue prior to           printing.d             /NAME=job-name6           Specifies a name string to identify the job.             /NOTIFYs>           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 for <           printing. You may specify the /NOTIFY qualifier on           this command.s  %           /PARAMETERS=(parameter ...)o@           Specifies up to eight optional parameters to be passed*           to the print queue with the job.             /PRINT           Synonym for /NOW.e                 CMD-32 r  S    A                                              Command DescriptionsoA                                                             PRINT                /QUEUE=queue-name @           Specifies the name of the print queue to which the job           should be submitted.             /ROTATE 8           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 eitherA?           value has the same effect, since NEWSRDR combines all >           printed articles into a single file before printing.                                                A                                                            CMD-33     r               Command Descriptions           READ    A           _______________________________________________________              READ  "           Displays a news article.  A           _______________________________________________________              FORMAT  "           [READ]  [article-number]  A           _______________________________________________________ )           Command Qualifiers     Defaults_             /NEXT_           /PREVIOUS_           /NEW           /FIRST           /LASTn           /GROUP[=group-name]_"           /SUBJECT[=(pattern ...)]           /THREAD   A           ________________________________________________________             PARAMETERS           article-number9           The number of the article to be read. Should be 9           omitted when using any of the qualifiers except            /GROUP..  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.   @           The READ command name may be omitted only if reading a6           specific article that you specify by number.             CMD-34 _       A                                              Command Descriptions A                                                              READ   A           ________________________________________________________             QUALIFIERS           /NEXT_;           When used without /NEW, causes the next available[?           article in the newsgroup to be displayed, even if yout<           have seen it. When used with /NEW, causes the next8           article you have not yet seen to be displayed.             /PREVIOUS 8           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.s             /LASTa?           Causes the last available article in the newsgroup toa           be displayed.              /GROUP=group-namem9           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 subscribed_?           newsgroup before searching for new articles, skipping =           any unread articles in the current newsgroup. If noe;           new article are found in any other newsgroup, thei?           NEWS-W-NONEW message will be displayed, even if therel4           are new articles in the current newsgroup.  A                                                            CMD-35a n                  Command Descriptions           READ                /SUBJECT=(pattern ...)           /SUBJECT>           Causes NEWSRDR to scan forward through the newsgroup7           until it finds an article matching one of theb9           specified wildcard patterns. If no patterns are ?           specified, the search is continued using the patterns=7           last specified. If there are no more matching =           articles, NEWSRDR displays a message and clears thec=           patterns, resetting the current article back to theh!           first matching article.f             /THREADr>           Causes NEWSRDR to scan forward through the newsgroup?           until it finds another article with the same subject.e>           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.y                                                     CMD-36 s       A                                              Command Descriptions A                                                             REPLY     A           _______________________________________________________p             REPLYo  @           Posts a follow-up article and/or sends a reply message/           to the author of the current article.d  A           _______________________________________________________              FORMAT  !           REPLY  [group-name,...]s  A           ________________________________________________________)           Command Qualifiers     Defaults   "           /DISTRIBUTION=(dist ...)           /[NO]EDIT_           /[NO]EXTRACT"           /FOLLOWUP_TO=(group ...)           /MAIL            /POST            /[NO]SELF_           /[NO]SIGNATURE%           /[NO]SUBJECT="subject-text"            /TO=(user-spec ...)P  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 arev           replying.c  =           If you are not posting your follow-up article, thisi           parameter is ignored.c    A                                                            CMD-37n y  h               Command Descriptions           REPLYl  A           _______________________________________________________r             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 a_@           text editor to compose the message, or be prompted for?           the message text. Once you have finished entering the_>           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 newsgroupn@           and/or sent through the Internet mailer to the author.  ?           For posted replies, if you do not specify one or moreF:           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)t?           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 mailed            reply.  ;           For mailed replies, the "Reply-to:" header in thes<           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'           /DISTRIBUTION=(dist-name ...)a4           This qualifier can be used to restrict the;           distribution of the article to a particular area.i=           If not specified, no restrictions are placed on ther@           article's distribution. Typical distribution names are!           "usa", "na", "ny", etc.n             /[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              CMD-38 y  m    A                                              Command Descriptions_A                                                             REPLYg    >           by the current SET EDIT setting (see the SET command,           description for more information).             /[NO]EXTRACT;           If a text editor is used to compose the follow-upE<           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.e>           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 specifiedS?           newsgroup(s). By default, followups are posted to theo2           same newsgroup(s) as the posted article.             /MAILs@           Specifies that the reply is to be mailed to the author=           of the original message. If neither /MAIL nor /POST =           is specified, /POST is assumed. A reply may be both            mailed and posted.             /POST ?           Specifies that the reply is to be posted as a follow-S>           up article. If neither /MAIL nor /POST is specified,:           /POST is assumed. A reply may be both mailed and           posted.n             /[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.i      A                                                            CMD-39  i                  Command Descriptions           REPLYe               /[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 wheno>           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 the :           subject for the message on the command line. Use7           /NOSUBJECT to omit a subject from the messages:           altogether. If not specified, the subject of the+           message is determined as follows:e  8           o  If there is no subject line in the original?              message, or the subject line is the text "(none)",_0              no subject is added to the message.  ?           o  If the subject line in the original message begins_;              with "Re:" (upper or lower case), it is copiedu8              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.             /TO=("user-spec"...)6           The /TO qualifier can be used to specify the;           destination users for the message, when the reply ?           is to be mailed. 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, the destination address is obtained from the @           Reply-To header in the article (or the From header, if'           there is no Reply-To header).i                     CMD-40 a  c    A                                              Command DescriptionsbA                                             SET ARCHIVE_DIRECTORY     A           _______________________________________________________              SET ARCHIVE_DIRECTORY   @           Establishes a place where extracted articles should be           stored.   A           _______________________________________________________              FORMAT  -           SET [NO]ARCHIVE_DIRECTORY  [devdir]   A           _______________________________________________________t             PARAMETERS           devdir=           A device and/or directory specification. This value.:           will be used as the default device/directory for&           subsequent EXTRACT commands.  A           _______________________________________________________e             DESCRIPTIONn9           This command is used to specify where extractedm=           articles should be stored if no device/directory isr@           specified on EXTRACT commands. If no archive directory=           is set, or you remove the archive directory setting ;           with SET NOARCHIVE_DIRECTORY, EXTRACT defaults to 1           placing files in the current directory._                      A                                                            CMD-41o o  e               Command Descriptions           SET DIRECTORY_WIDTHO    A           _______________________________________________________              SET DIRECTORY_WIDTHt        |=        |  Specifies the default width for fields in DIRECTORY         |  listings.t        |A        |  _______________________________________________________         |        |  FORMAT        |        |  SET DIRECTORY_WIDTH         |A        |  _______________________________________________________E)        |  Command Qualifiers     Defaultsi        |        |  /FROM=columnsn        |  /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 (includinga=        |  zero) for one or both fields. If you set a specifici=        |  width for one field, the remaining available screenc&        |  width is used for the other.        |@        |  Specifying no qualifiers resets the widths back to the        |  even-split default.h        |A        |  _______________________________________________________[        |        |  QUALIFIERS        |  /FROM=columnss=        |  Specifies the number of columns for the From field.         |        |  /SUBJECT=columns@        |  Specifies the number of columns for the Subject field.             CMD-42 -  e    A                                              Command DescriptionsNA                                                          SET EDITa    A           _______________________________________________________              SET EDIT  8           Changes the auto-edit setting and text editor.  A           _______________________________________________________a             FORMAT             SET [NO]EDIT  A           _______________________________________________________p)           Command Qualifiers     Defaultsb  "           /EDITOR=(editor [,type])  A           _______________________________________________________              DESCRIPTIONS>           This command is used to turn on or off the automatic;           use of a text editor for message composition. The @           setting can be overridden on the POST, MAIL, and REPLY0           commands with the /[NO]EDIT qualifier.  A           _______________________________________________________e             QUALIFIERS"           /EDITOR=(editor [,type])=           This qualifier can be used to specify the editor top=           be used, which can be either callable or spawned as[=           a subprocess. If type is CALLABLE, then editor must ?           be the name of a callable editor. NEWSRDR can use any @           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 ;              in SYS$SHARE or must have an exec-mode logicalc/              pointing to the library elsewhere._  A                                                            CMD-43                     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 charactere;              strings passed by descriptor, as the first two <              arguments. If there are optional arguments, the?              xxx$EDIT routine must not rely on having more than #              two arguments present._  >           The Digital-supplied editors TPU, EDT, and TECO, and=           the (layered product) VAX Language-Sensitive Editoro1           (LSE) all follow this calling standard.a  >           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.o                                                         CMD-44 l  f    A                                              Command Descriptions A                                                          SET EDIT     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 use            $! the command:            $!G           $!  News> SET EDIT/EDITOR=("@device:[dir]filename.COM",SPAWN)t           $!           $! Inputs:           $!"           $!   P1: input file name#           $!   P2: output file namee           $!%           $! 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'lA           $_EXIT_________________________________________________                                     A                                                            CMD-45y s                  Command Descriptions           SET FORM    A           _______________________________________________________P             SET FORM        |>        |  Specifies the form to use by default for print jobs.        |A        |  _______________________________________________________u        |        |  FORMAT        |!        |  SET [NO]FORM  form-nameo        |A        |  _______________________________________________________         |        |  PARAMETERS        |  form-name_&        |  The name of the form to use.        |A        |  _______________________________________________________g        |        |  DESCRIPTIONl:        |  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.                                           CMD-46 o       A                                              Command DescriptionsTA                                                       SET HEADERS     A           _______________________________________________________f             SET HEADERS   7           Selects the header lines to appear in articleu           displays.=  A           _______________________________________________________              FORMAT  )           SET HEADERS  [NO]header-name...a  A           _______________________________________________________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 name ?           by separating them with commas. Table CMD-1 lists the 0           valid header names and their meanings.  A           Table_CMD-1__Header_names______________________________              HeaderA           name________Meaning____________________________________   @           FROM        the "From:" line, which indicates who sent!                       the message   <           DATE        the "Date:" line, which indicates when>                       the message was originally posted to the                       network_  >           NEWSGROUPS  the "Newsgroups:" line, which identifies9                       the newsgroups to which the messageo                       belongs       A                                                            CMD-47     M               Command Descriptions           SET HEADERS_    A           Table_CMD-1_(Cont.)__Header_names______________________u             HeaderA           name________Meaning____________________________________   :           SUBJECT     the "Subject:" line, usually a brief>                       description of what the message is about  6           MESSAGE_ID  the "Message-ID:" line, a unique0                       identifier for the message  @           PATH        the "Path:" line, which shows the path the>                       message took to reach the current system  ;           REPLY_TO    the "Reply-to:" line, which indicatesr9                       where mailed replies should be senth  >           SENDER      the "Sender:" line, which identifies the;                       entity responsible for submitting thet,                       message to the network  >           FOLLOWUP_   the "Followup-to:" line, which indicates?           TO          the newsgroup(s) where follow-up articlese&                       should be posted  <           EXPIRES     the "Expires:" line, which indicates a@                       suggested expiration date and time for the                       article   >           REFERENCES  the "References:" line, which identifies6                       the message(s) that prompted the0                       submission of the messages  ?           DISTRIBUTIONthe "Distribution:" line, which indicatese;                       the distribution scope of the message                        CMD-48 O       A                                              Command DescriptionstA                                                       SET HEADERS     A           Table_CMD-1_(Cont.)__Header_names______________________d             HeaderA           name________Meaning____________________________________   @           ORGANIZATIONthe "Organization:" line, which identifies:                       the organization to which the sender                       belongsh  =           KEYWORDS    the "Keywords:" line, which may includei=                       some keywords related to the content ofI!                       the message   =           SUMMARY     the "Summary:" line, a brief summary of !                       the messagea  :           APPROVED    the "Approved:" line, indicating the9                       moderator that approved the messagei  <           LINES       the "Lines:" line, which indicates the)                       size of the message   ?           XREF        the "Xref:" line, which identifies cross- A           ____________postings___________________________________     A           _______________________________________________________q             DESCRIPTIONe?           This command can be used to omit uninteresting header ?           lines from article displays, to provide more room for =           article text. The setting has no effect on articlesm>           saved into files with the EXTRACT command. Note that<           not all articles have all the header lines you can<           specify on this command; the header line types are$           provided for completeness.          A                                                            CMD-49                     Command Descriptions           SET IGNORE    A           _______________________________________________________              SET IGNORE  <           Establishes or removes a criterion for permanently           ignoring articles.  A           _______________________________________________________              FORMAT  $           SET [NO]IGNORE  group-name  A           _______________________________________________________ )           Command Qualifiers     Defaults              /GLOBAL            /FROM=patternT           /NEWSGROUPS=pattern            /SUBJECT=pattern  A           _______________________________________________________e             PARAMETERS           group-name7           The name of the newsgroup to which the ignore ?           criterion should be added. Not specified when /GLOBALo9           is used. If omitted, the current group is used.s  A           _______________________________________________________w             DESCRIPTIONr9           This command is used to add or remove an ignorep:           criterion (sometimes called a "kill file") for a?           single newsgroup or for all newsgroups. The criterionS@           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 articlesn@           matching the criterion will automatically be marked as?           seen and will not be displayed when READ/NEW is used.   8           Use SET NOIGNORE to remove an erroneous ignore=           criterion or when the subject or author you wish to 8           ignore is at a more reasonable activity level.             CMD-50    r    A                                              Command DescriptionsoA                                                        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.l             /FROM=patternn=           Bases the criterion on the author (From line) of anE=           article. The pattern may contain VMS wildcards. Anys@           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=pattern <           Bases the criterion on the Newsgroups header of an=           article. The pattern may contain VMS wildcards. Any ;           Newsgroups 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.             /SUBJECT=pattern;           Bases the criterion on the subject of an article.t<           The pattern may contain VMS wildcards. Any subject;           line matching the wildcard pattern, or containingi>           the specified text if no wildcards are used, will be@           ignored. You may specify only one ignore criterion per           command.          A                                                            CMD-51s i  i               Command Descriptions           SET NEWSRC    A           _______________________________________________________h             SET NEWSRC        |4        |  Enables/disables the use of a newsrc file.        |A        |  _______________________________________________________         |        |  FORMAT        |%        |  SET [NO]NEWSRC  [file-spec]         |A        |  _______________________________________________________ )        |  Command Qualifiers     Defaults_        |3        |  /[NO]SUBSCRIBED_ONLY   /NOSUBSCRIBED_ONLY_        |A        |  _______________________________________________________e        |        |  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.16. 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 other =        |  news readers and allows you to control the order in >        |  which newsgroups are visited during NEWSRDR sessions>        |  by ordering the newsgroups in the newsrc file as you        |  desire.I        |A        |  _______________________________________________________r        |        |  QUALIFIERS        |  /[NO]SUBCRIBED_ONLY =        |  By default, the newsrc file will list all availablen<        |  newsgroups. This is to maintain compatibility with             CMD-52 _  _    A                                              Command Descriptions|A                                                        SET NEWSRC     =        |  most other news readers. However, the full list can_@        |  take up a substantial amount of disk space. Specifying=        |  /SUBSCRIBED_ONLY causes NEWSRDR to save information_?        |  only about the newsgroups you are subscribed to. This ?        |  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.s                                                                  A                                                            CMD-53t f  d               Command Descriptions           SET PERSONAL_NAME     A           _______________________________________________________f             SET PERSONAL_NAME   @           Establishes a "personal name" to accompany your return           address.  A           _______________________________________________________b             FORMAT  )           SET [NO]PERSONAL_NAME  ["name"]_  A           _______________________________________________________ )           Command Qualifiers     Defaults              /EDITOR=editor-name   A           _______________________________________________________              PARAMETERS           name;           Any readable text string, not including quotation ;           marks or backslashes, to be used as your personal            name.   A           ________________________________________________________             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.                              CMD-54         A                                              Command Descriptions A                                                         SET QUEUEy    A           ________________________________________________________             SET QUEUET        |?        |  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.i        |A        |  _______________________________________________________h        |        |  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.p                                  A                                                            CMD-55s e  e               Command Descriptions           SET REPLYx    A           _______________________________________________________r             SET REPLY   @           Sets the default sending mechanism for REPLY commands.  A           _______________________________________________________              FORMAT  #           SET REPLY  reply-type ...   A           _______________________________________________________b             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           _______________________________________________________              DESCRIPTIONe;           This setting is used to determine whether repliesd>           are posted, mailed, or both, when you do not specify7           either the /POST or /MAIL on a REPLY command.a                                       CMD-56 B  t    A                                              Command Descriptions A                                                          SET SEENn    A           _______________________________________________________e             SET SEEN  :           Marks an article or group of articles as "seen".  A           _______________________________________________________              FORMAT  &           SET SEEN  [article-range...]  A           _______________________________________________________d)           Command Qualifiers     Defaults_             /ALL           /THREAD_  A           _______________________________________________________W             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           _______________________________________________________              DESCRIPTIONe>           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.  A           _______________________________________________________              QUALIFIERS           /ALL9           Causes all articles in the current newsgroup to_           marked.              /THREAD <           Causes each article in the current newsgroup, from=           the current article onward, to be marked as seen ifE  A                                                            CMD-57_ _  P               Command Descriptions           SET SEEN    ?           the subject of the article matches the subject of the_           current article.                                                                                         CMD-58    |    A                                              Command Descriptions A                                                     SET SIGNATUREa    A           ________________________________________________________             SET SIGNATUREg  )           Establishes a "signature" file.   A           _______________________________________________________o             FORMAT  (           SET [NO]SIGNATURE  [file-spec]  A           _______________________________________________________u)           Command Qualifiers     Defaults   7           /[NO]AUTOMATIC=(send-ty/AUTOMATIC=(POST,MAIL)   A           _______________________________________________________              PARAMETERS           file-spec_8           Name of the file in which you have stored your           signature.  A           _______________________________________________________              DESCRIPTION_=           This command can be used to establish a "signature" ;           file. The contents of the signature file (up to 8 =           lines of text) is appended to messages you send anda=           articles you post, and can contain information such =           as your name, company, E-mail address, etc. Use SETd5           NOSIGNATURE to clear the signature setting.i  A           _______________________________________________________r             QUALIFIERS#           /AUTOMATIC=(send-type...)i           /NOAUTOMATIC5           Specifies when the signature file should be_>           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-59l p  e               Command Descriptions           SET SIGNATUREU    <           /NOAUTOMATIC to prevent automatic inclusion of the           signature file.h  5           This setting can be overridden by using the >           /[NO]SIGNATURE qualifier on the FORWARD, MAIL, POST,           and REPLY commands.i                                                                                 CMD-60 _  _    A                                              Command Descriptions_A                                                        SET UNSEEN,    A           _______________________________________________________              SET UNSEEN  <           Marks an article or group of articles as "unseen".  A           _______________________________________________________e             FORMAT  (           SET UNSEEN  [article-range...]  A           _______________________________________________________i)           Command Qualifiers     Defaults              /ALL  A           _______________________________________________________              PARAMETERS           article-rangeo:           A single article number or a starting and ending?           article number separated by a hyphen. All articles ini>           the specified range are marked "unseen". If omitted,/           the current article is marked unseen.o  A           _______________________________________________________              DESCRIPTIONg>           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 fore?           long articles you want to skip in the current NEWSRDRI7           session but would like to come back to later.   A           _______________________________________________________              QUALIFIERS           /ALL9           Causes all articles in the current newsgroup to            marked.   A                                                            CMD-61- C  .               Command Descriptions           SHOW    A           ________________________________________________________             SHOW  ?           Displays profile settings and other information about "           the NEWSRDR environment.  A           _______________________________________________________              FORMAT-                 { ARCHIVE_DIRECTORY         }y-        |        { CURRENT_GROUP             } -        |        { DIRECTORY_WIDTH           }h-        |        { EDIT                      } -        |        {                           }D-        |        { FORM                      } -                 { GROUP                     }s-                 { HEADERS                   },-           SHOW  {                           }e-        |        { IGNORE [/GLOBAL] [/LOCAL] }X-        |        { NEWSRC                    } -        |        { PERSONAL_NAME             }_-        |        {                           }_-        |        { QUEUE                     }E-                 { SERVER                    }t-                 { SIGNATURE_FILE            }r-                 {                           } -                 { ALL                       }c  A           _______________________________________________________N             PARAMETERS           ARCHIVE_DIRECTORYd9           Displays the current archive directory setting.a             CURRENT_GROUP @           Displays the name of the current newsgroup, along with?           the number of the first and last available article ino           the group.             DIRECTORY_WIDTH 8        |  Displays the current directory width settings.             CMD-62 O       A                                              Command Descriptions A                                                              SHOW_               EDIT?           Displays the current SET EDIT setting and the name of $           your selected text editor.             FORM2        |  Displays the default print form, if any.             GROUPO@           Displays the name of the current newsgroup, along with?           the number of the first and last available article in_2           the group. (Same as SHOW CURRENT_GROUP.)             HEADERSe3           Displays the current SET HEADERS setting.n             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.a             PERSONAL_NAME 9           Displays the current SET PERSONAL_NAME setting.i             QUEUE 3        |  Displays the default print queue setting.o             SERVER:           Displays the Internet host name of the NNTP news           server machine.B             SIGNATURE_FILE5           Displays the current SET SIGNATURE setting.e  
           ALLc0           Displays all of the above information.      A                                                            CMD-63     s               Command Descriptions           SHOW  A           _______________________________________________________g             DESCRIPTIONb9           This command can be used to look at any of your <           profile settings as well as some information about:           your NEWSRDR environment. See the description of<           the SET command for more information about profile           settings.                                                                                CMD-64 l  n    A                                              Command Descriptions_A                                                             SPAWN     A           _______________________________________________________s             SPAWN   :           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 leaver@           NEWSRDR temporarily, perform other functions, and then           return to NEWSRDR.  A           _______________________________________________________              FORMAT             SPAWN  [command]  A           _______________________________________________________i)           Command Qualifiers     Defaults   1           /INPUT=filespec        /INPUT=SYS$INPUT /           /[NO]LOGICAL_NAMES     /LOGICAL_NAMESt3           /OUTPUT=filespec       /OUTPUT=SYS$OUTPUTo"           /PROCESS=subprocess-name)           /[NO]SYMBOLS           /SYMBOLS &           /[NO]WAIT              /WAIT  A           _______________________________________________________              PARAMETERS           command ?           Specifies the DCL command string that executes in theh=           context of the created subprocess. When the commandg=           completes, the subprocess terminates and control is >           returned to the parent process. If this parameter is?           not specified, a subprocess is created that transferss'           control to DCL command level._  A           _______________________________________________________              QUALIFIERS           /INPUT=filespece8           Specifies an input file containing one or more;           DCL command strings to be executed by the spawnedO  A                                                            CMD-65  |  _               Command Descriptions           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.              /[NO]LOGICAL_NAMES@           Specifies that the logical names of the parent process=           are to be copied to the subprocess. When you do not_=           want the subprocess to use the logical names of thee?           parent process, enter the qualifier /NOLOGICAL_NAMES.l(           The default is /LOGICAL_NAMES.             /OUTPUT=filespec<           Identifies the output file to which the results of?           the SPAWN operation are written. Whenever you use theo<           /NOWAIT qualifier, you should also use the /OUTPUT>           qualifier to specify a new output destination. Doing;           so prevents output from being displayed while youv>           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".              /[NO]SYMBOLS9           Determines whether the system passes DCL global =           and local symbols to the subprocess. The default isp           /SYMBOLS.              /[NO]WAIT @           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 subprocesst=           is running. If you specify /NOWAIT, you should alsou?           use the /OUTPUT qualifier to direct the output streamn@           to a file, rather than displaying it on your terminal.               CMD-66 o  r    A                                              Command Descriptions A                                                             SPAWN     <           Doing so prevents your terminal from being used by/           more than one process simultaneously.                                                                               A                                                            CMD-67y u  e               Command Descriptions           STORE_    A           _______________________________________________________              STOREN  >           Forwards a copy of a news article to yourself by VMS           Mail.   A           _______________________________________________________t             FORMAT  !           STORE  [article-number]_  A           _______________________________________________________              PARAMETERS           article-number;           Number of the article to be sent. If omitted, thea"           current article is sent.  A           _______________________________________________________E             DESCRIPTIONs>           This command sends the specified article by VMS Mail?           to yourself. The message subject is automatically setl8           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.                                 CMD-68 _  _    A                                              Command Descriptions A                                                         SUBSCRIBE     A           _______________________________________________________              SUBSCRIBEM  @           Adds one or more newsgroups to your subscription list.  A           _______________________________________________________              FORMAT  !           SUBSCRIBE  newsgroup...a  A           ________________________________________________________)           Command Qualifiers     Defaults              /CONFIRM        |  /GOTOc%        |  /[NO]LOG               /LOGd  A           _______________________________________________________.             PARAMETERS           newsgroup 7           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 your_           subscription list.  A           _______________________________________________________u             DESCRIPTIONR=           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.  A                                                            CMD-69_ _  _               Command Descriptions           SUBSCRIBEC               /GOTOh:        |  Causes the subscribed newsgroup to be set as the9        |  current group. On wildcard subscribes, the last /        |  subscribed newsgroup becomes current.a        |        |  /[NO]LOG7        |  By default, NEWSRDR issues a message for each 9        |  successful addition. Use /NOLOG to suppress the         |  messages.                                                                            CMD-70 _  _    A                                              Command DescriptionsaA                                                       UNSUBSCRIBE_    A           _______________________________________________________e             UNSUBSCRIBE_  ?           Removes one or more newsgroups from your subscriptiono           list.   A           ________________________________________________________             FORMAT  #           UNSUBSCRIBE  newsgroup...   A           _______________________________________________________n)           Command Qualifiers     Defaultsr             /CONFIRM%        |  /[NO]LOG               /LOGn  A           ________________________________________________________             PARAMETERS           newsgroup =           Name of a newsgroup you no longer wish to subscribet@           to, or a wildcard pattern. All newsgroups matching the=           pattern will be removed from the subscription list.R  A           ________________________________________________________             DESCRIPTION =           This command is used to end your participation in an;           newsgroup. The group is removed from your NEWSRDRT=           profile, and you will no longer see any articles in            that newsgroup.   A           _______________________________________________________              QUALIFIERS           /CONFIRM>           When specified, NEWSRDR asks for confirmation before6           adding a newsgroup to the subscription list.  A                                                            CMD-71                     Command Descriptions           UNSUBSCRIBE                /[NO]LOG7        |  By default, NEWSRDR issues a message for each 9        |  successful addition. Use /NOLOG to suppress theR        |  messages._                                                                                     CMD-72 s  l    A                                              Command Descriptions_A                                                            UPDATEI    A           ________________________________________________________             UPDATE  ?           Updates NEWSRDR's newsgroup information from the NNTPT           server.I  A           ________________________________________________________             FORMAT             UPDATE  A           _______________________________________________________o)           Command Qualifiers     Defaults              /PARTIAL  A           _______________________________________________________              DESCRIPTIONd@           This command can be used to discover further available=           unread articles since the last update. This is donet9           automatically for you at the start of a NEWSRDRc@           session, but if you have spent a long time in NEWSRDR,=           this command should be used. A message is displayeds@           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 shouldt=           generally not be used, since the information from ae?           full update is needed for some other NEWSRDR commands            to work properly.   A                                                            CMD-73T