Journal, Version 15                       10/02/83
                         -------------------

   The main differences between this version of Journal and version 14 concern
file handling.  The three pdfiles JSPLRSTAT, JVOLSTAT and JDIRECTSTAT have been
removed, and their members are now files in their own right.  The way in which
such files are updated by a Journal run, and extended when necessary, have also
been changed.  The intention in all cases was to reduce the pageturns required
by Journal, and possibly the cpu time.

   The changes are detailed below, followed by instructions for moving from
version 14 to version 15.

Changes
-------

1) Journal logfiles.  Instead of sending the logfile from monitor and auto
   runs to the line printer, Journal now keeps them as files, named JJLOGn
   where 0<=n<=7.  The command JOURNAL STATE prints out which of these
   files contains the latest log.
   File JJREPORT is no longer produced.

2) Background password.  It is now possible to set the JOURNL process background
   password without confusing the Journal system.  A new command,
   JOURNAL BACKPASS, is provided for this purpose.  You need to know the
   current foreground password.
   To change the foreground password, you should use the standard Subsystem
   command PASSWORD.  Do NOT use PASSWORD to change the background password.
   The command CREATE JOURNAL SYSTEM has been modified to call JOURNAL BACKPASS.

3) When a retrieved file is offered to JOURNL, no 'offer' command is now
   executed - it is merely left in JOURNL's file index.

4) The command SESSION MONITOR no longer requires a space after the comma
   separating the date and time values specified.

5) Various corrections have been made where dates were still held in the old
   format.  This particularly affected the generation of monthly reports.

6) The handling of files required by the various analyses has been considerably
   modified (perhaps even improved).  The Volums analysis work file can now be
   extended as necessary - there is no arbitrary upper limit.  The extension
   of the workfiles is now done without disconnecting and copying, if this is
   possible.

7) The following files have been renamed:

      JSPLRSTAT_IJOB         ->   JJ#SPIJOB
      JSPLRSTAT_CJOB         ->   JJ#SPCJOB
      JSPLRSTAT_JCONS        ->   JJ#SPCONS
      JVOLSTAT_JRESTAB       ->   JJ#VOLRTAB
      JVOLSTAT_JRESTWK       ->   JJ#VOLRWK
      JDIRECTSTAT_JCONTROL   ->   JJ#DIRCON
      JDIRECTSTAT_JSESS      ->   JJ#DIRSESS

   When these files are required, instead of making a copy, modifying the
   copy and then copying back if all is well, Journal now modifies the files
   direct if this merely consists of appending material.  On successful
   completion, pointers held in the file header are updated to include the
   new material.
   Where this cannot be done, temporary files are used, with names as above
   except that T# is substituted for JJ#.  On successful completion, these
   files are NEWGENed.

8) A new parameter to command JOURNAL is provided.  When the command

      Command:JOURNAL(CLOSETAPE)

   is given, the effect is to cause the current dump tape to be marked as full,
   so that when files are next dumped to tape, the next tape in the cycle will
   be used.  This is useful in cases where a tape is consistently failing
   during the writing of new material.

9) Minor changes have been made to the S series disc error report headings.

10)A change has been made in the holding of information on jobs in the Spoolr
   queues, to reduce the pageturns when such information is being processed.




Putting version 15 into service
-------------------------------

   All the files are held in pdfile PDJNL15.

1)    Command:INSERT(PDJNL15_TOVSN15)
      Command:TOVSN15

         (This renames files, as detailed above, and adds information to some
          standard files - JJMASTER, JJ#VOLRTAB, JJ#VOLRWK.)

2) The source files are named PDJNL15_JPK*S, A<=*<=E.  The corresponding
   object files are named PDJNL15_JPK*Y.  Note that these object files assume
   site ERCC, and were produce with PARM(OPT).

   If the sources are to be recompiled, the value of %constinteger journalsite
   in EACH source file must be changed, if necessary.  Once all the source files
   have been compiled, copy the resultant object files into PDJNL15:

      Command:COPY(JPK*Y,PDJNL15_JPK*Y)       A<=*<=E

3) Link them:

      Command:OBEY(PDJNL15_LINKOBEY)

4) This produces a linked object file called NJOURNALSYS, which can then be
   put into service:

      Command:NEWGEN(NJOURNALSYS,JOURNALSYS)
   or
      Command:RENAME(JOURNALSYS,OJOURNALSYS)
      Command:RENAME(NJOURNALSYS,JOURNALSYS)

   or whatever.
                                                          John Murison
                                                                  ERCC