1 BULLMAINT

  The command $ BULLMAINT  invokes  the  bulletin  maintenance  utility.
  This utility is used to create, update, and delete bulletins.

  Format:

          $ BULLMAINT [/qualifiers] [bulletin_library_spec[,...]]
2 Choosing_bulletin

                              Video Terminal

  If you use a video terminal, BULLMAINT displays  a  list  of  bulletin
  titles for you to choose from.  The arrow keys may be used to position
  the cursor to the desired bulletin title.  A bulletin  may  be  marked
  with  'X'  for  deletion  or editing.  The <DELETE> key may be used to
  cancel  the  marking.   A  Carriage-return  terminates  the   bulletin
  selection  process.   The  bulletins  that are marked with 'X' will be
  then be deleted or edited in turn, depending  on  whether  /DELETE  or
  /EDIT was specified.

  You can also press 'F' or 'P' to file or print a  bulletin.   To  know
  more  about  a  bulletin message such as who posts it, how long it is,
  etc., you just press 'M'.

                            Hardcopy Terminal

  If you use a hard copy terminal or the one whose type  is  unknown  to
  BULLETIN,  it  displays  a  list  of bulletin titles for you to choose
  from.  The bulletin is  then  selected  for  deletion  or  editing  by
  pressing  'X'.   Carriage-return  is used to skip to the next bulletin
  title.  When you get down to the end of the list,  or  type  'Q',  The
  bulletins  that  are marked with 'X' will be then be deleted or edited
  in turn, depending on whether /DELETE or /EDIT was specified.

  You can also press 'F' or 'P' to file or print a bulletin.
2 Clean_up

  The bulletin library should be compressd from time to  time  when  old
  bulletins  are  removed from the library.  This can be accomplished by
  using the the following DCL commands.

          $ library/com/text/out=bull.blb  bull.blb
          $ set file/trun bull.blb
          $ pur bull.blb

          Now, set protection this new file as that of the old one.

  [Warning:If an existing bulletin library is to be removed or replaced,
  the library and the associated index file (see Installation) should be
  deleted before a new one of the same name is  created.   The  bulletin
  users'  BULLETIN.DAT  file  in their login directories will then be in
  error with respect to the new  library,  but  users  must  not  delete
  BULLETIN.DAT if they are accessing any other bulletin libraries, since
  BULLETIN.DAT  contains  the  status  information  for   all   bulletin
  libraries  consulted  by  the user.  Instead, users should simply flag
  obsolete bulletin titles with 'N'.  To avoid this  problem,  it  is  a
  good  idea  to  change the name of the bulletin library and index each
  time you remove or replace them.  Users won't  notice  the  difference
  because the logical name DEF_BULLETIN is used.]
2 Installation

  See the USERGUIDE.MEM for details.

  Following is the restriction in naming a bulletin_library_spec.

        The maximum length of a bulletin_library_spec = 
        node::device:[directory]filename.type;version   = 127
                       
        The filename itself can have the maximum length of 11
        characters long.

2 Logical_name

  Define the logical name  BUL  pointing  to  the  directory  containing
  bulletin.exe and bullmaint.exe.

  Define the logical name USER_HELPLIB in the system logical name table.
  This  logical  name  points to the user help library.  Also define the
  logical name MAINT_HELPLIB in the system  logical  name  table.   This
  logical  name  points to the maintenance help library.  If there is no
  logical name for the help libraries, the constants  which  define  the
  help  libraries  in  the  file "INSTALL.H" are used.  You can edit the
  file "INSTALL.H" to customize it with your system.  In this case,  all
  files have to be re-compiled and linked again.

  Define the logical name DEF_BULLETIN pointing to the default  bulletin
  libraries.
2 Parameters

  bulletin_library_spec

   Specifies the name of the bulletin library you want  to  access.   No
   wild  card  characters are allowed in the bulletin_library_spec.  The
   default library file type is BLB.

   This parameter may be omitted if there is a list of default  bulletin
   libraries  (i. e.,  if the logical name DEF_BULLETIN is defined).  In
   this case, the translation  of  DEF_BULLETIN  will  be  used  as  the
   bulletin  libraries.   The  parameter  may also be used to override a
   default bulletin library.   If  this  parameter  is  missing  on  the
   command  line, and there is no logical name DEF_BULLETIN defined, you
   will be prompted for the bulletin libraries.
2 Qualifiers

  If no qualifier is specified, /ADD is the default.

/ADD
  Adds a new  bulletin  text  to  the  bulletin  library.   /TITLE=title
  (maximum  64 characters), /FILE=filename (maximum 127 characters) must
  be present if /BATCH is used.  Otherwise, you  will  be  prompted  for
  title  and  file.  /EXPIRY_DATE=expiry_date is optional.  If it is not
  specified, it means there is no expiration  date  for  that  bulletin.
  The  file  specified  should  contain  the  bulletin  text.  The added
  bulletin will have the status 'New' for all  users.   The  format  for
  specifying  the  expiry  date is dd-mmm-yyyy hh:mm:ss.mm.  A control-Z
  may be typed to any prompt to abort the operation.

/BATCH
  If this qualifier, together with /TITLE, and /FILE, are on the command
  line, you will not be prompted for "title" and "file".

/DELETE
  Deletes one or more bulletin messages from bulletin libraries.

/EDIT
  Replaces an existing  bulletin  with  new  text.   The  user  will  be
  prompted  for  a  new title, new expiration date and a file name.  The
  file should contain the new bulletin text.  If the expiration date  is
  not specified, it means there is no expiration for that bulletin.  The
  date of the edited bulletin will be  updated  automatically,  but  the
  bulletin  will  not  have the status "new" for users who have read the
  previous version.  A control-Z may be typed to any prompt to abort the
  operation.

/EXPIRE
  Deletes all expired bulletins from bulletin libraries.
/DEFAULT
        /DEFAULT=value

  Value can be DATE, which is the default, displays the  date  on  which
  the bulletin message was posted.  POSTER displays the person who posts
  the bulletin message.  SIZE displays the size (number of lines) of the
  bulletin message.
/TITLE
        /TITLE=title

  Title length max is 64.  It is valid  only  if  /BATCH  and  /FILE  is
  present.
/FILE
        /FILE=file

  File length max is 127.  It is valid only  if  /BATCH  and  /TITLE  is
  present.
/EXPIRY_DATE
        /EXPIRY_DATE=date

  Date has the form dd-mmm-yyyy:hh:mm:ss.mm.
