1 DIRECTORY

  Displays a list of the  current  news  items,  including  news  item
  number, sender's name, submittal and expiration dates, and subject.

   Format:

       DIRECTORY


  News  items  that  you have not yet read are indicated by a flashing
  directory entry. You may abreviate the directory command to a single
  letter D.

2 Examples

       NEWS> DIRECTORY

       ITEM   SUBMITTED     EXPIRES     SUBMITTOR     SUBJECT
       ----  -----------  -----------  ------------  ------------
          1  12-APR-1986  12-APR-1995  The Boss      Timecards
          2   1-JUL-1986   3-JUL-1986  The Big Boss  Fourth of July
[1;5m          2  24-DEC-1986  26-DEC-1986  Santa         Cookies and Milk[m


  This example shows a typical display resulting  from  the  DIRECTORY
  command. You have already read items 1 and 2 while item 3 is new.

1 EXIT

  Allows you to exit from NEWS.   You  can  also  exit  from  NEWS  by
  pressing <CTRL/Z>.

   Format:

       EXIT


  The EXIT command may be abreviated to the single letter E.

1 HELP

  Allows you to obtain information about the NEWS Utility.

  To obtain information about all of  the  NEWS  commands,  enter  the
  following command:

       NEWS> HELP *

  To obtain information about individual  commands  or  topics,  enter
  HELP followed by the command or topic name.

   Format:

       HELP [topic]

  The HELP command may be abreviated to the single letter H.

2 Parameters

 topic

  Indicates a topic about which you want information.  To display  the
  list of available topics, enter the HELP command at the NEWS prompt.

1 READ

  Displays  news items. It  can  be  issued  with   or   without
  parameters.

  Pressing  the  RETURN  key  is the same as entering the READ command
  without  parameters.   If  you  issue  the  READ   command   without
  parameters or press RETURN immediatedly after NEWS is invoked,  NEWS
  displays the first page of the first unread news item.  If there are
  no unread news items, NEWS displays the first page of the first news
  item.  Each  time you enter the READ command without parameters,  or
  press  RETURN,  NEWS displays the next page or the next news item if
  there are no more pages in the current news item.

   Format:

       READ [news-item-number]


  The read command may be abreviated to the single letter R.

2 Parameters

  news-item-number

  Indicates the number of the news item to  be  read.  The  news  item
  number  represents the position of a news item relative to submittal
  time. If you specify a number greater than the number of news items,
  NEWS will not display any news item.

2 Examples

  1.
       NEWS> READ

  This example shows how to read any new news items or  all  items  if
  there are no new news items.


  2.
       NEWS> READ 3

  This example shows how to use the  news-item-number  qualifier  with
  the  READ  command  to display all the news items from the third one
  on. If there are only two items, NEWS will not read anything.

1 SUBMIT

  Allows you to submit a news item.  This command may not be available
  for this installation.  Contact your system manager for availability
  information.

  NEWS prompts you first for the item retention interval in days.  You
  can  specify  any  interval  from  1  to  90 days.  You will then be
  prompted for the subject of the news item.

  You can include a file specification with the SUBMIT command. If you
  specify a file,  the text in that file is submitted.  If you do  not
  specify a file, NEWS creates one for you.

  You may also use your favorite VAX/VMS editor.  NEWS will invoke the
  editor to edit either the specified file or the temporary file.

  If you do not specify an edit option,  NEWS will prompt for the text
  input.  Enter the text that you want to submit; then press <CTRL/Z>.
  Note that once you have typed a line and pressed RETURN, there is no
  way to edit it.  Also,  you cannot use any cursor positioning  keys.
  If  you decide not to send a message you are typing,  press <CTRL/C>
  or  <CTRL/Y> to abort the submital.  You will then receive the NEWS>
  prompt.

  News  items  are submitted at once.  NEWS will create a file in your
  login root directory which will remain until midnight of the day you
  submitted the item,  at which time the system will move  it  to  the
  news  directory.  If  you  decide to cancel a news item before it is
  moved,  simply delete the file in your  SYS$LOGIN:  directory.  News
  files are identified as: NEWSnnnnnnnnnn.NWS. (nnnnnnnnnn is a unique
  numeric  identifier  for  news  files.) If you wish to cancel a news
  item after the file is moved to  the  news  directory,  contact  any
  member of the systems staff.

   Format:

       SUBMIT [/edit-command] [@file-spec]


  The SUBMIT command may be abreviated to the single letter S.

2 Parameters

 @file-spec

  Indicates the name of the file to be submitted. The @ must be present.

 /edit-command

  Indicates the edit command to use.  The / must be  present.  If  the
  edit command includes qualifiers, enter them as you usually would.

2 Examples

  1.
       NEWS> SUBMIT @BIGDISK:[MYFILES]NEWSFILE.DOC
       Retention period in days (1-90): 14
       Subj: Geometric Concepts
       NEWS>


  This example shows how to submit a copy of a specified file. It will
  be retained for two weeks, then deleted.

  2.
       NEWS> SUBMIT/EVE/SEC=MYKEYFILE
       Retention period in days (1-90): 90
       Subj: New Ada Compiler

  This  example  shows  how to invoke the EVE editor with a qualifier.
  NEWS will invoke the DCL command:  EVE/SEC=MYKEYFILE to edit  a  new
  file. The retention period will be 90 days.

  3.
       NEWS> SUBMIT
       Retention period in days (1-90): 28
       Subject: Handling Stress
       Enter your news item below.  Press CTRL/Z when complete, or CTRL/C to quit:


  This  example  shows  how  to submit a news item with no qualifiers.
  NEWS prompts for input in this case. This news item will be retained
  for four weeks.

1 TOPIC

  Allows you to select various topics within NEWS. NEWS will display a
  list of topics and ask you to enter one of them. NEWS will return to
  the main NEWS> prompt if you enter CTRL-Z or press RETURN.

2 Examples

  1.
        NEWS> TOPIC

        The following topics are available:

                DATES
                FIGS
                PRUNES

        Select one of the above topics: DATES
        DATES NEWS>

  This example shows how to select news items relating to dates.  NEWS
  will include the topic in its' prompt to remind you that you are  no
  longer in the default news items.
