1 JOBLOG
! JOBLOG.HLP
! Copyright (c) 1990, Leonard J. Peirce

JOBLOG will capture the output for a terminal session, place it in a file,
and, upon exit, give you the option of printing it, saving it, storing the
log file in a secure area and sending notification of it to another user,
or deleting it.

There are essentially two types of JOBLOG log files:  VERIFIED and UNVERI-
FIED.  VERIFIED log files are guaranteed to be untouched by the person who
created them.  Since the log files themselves are never accessible to the
user while running JOBLOG, the only opportunity for modification is if
logging is disabled while in JOBLOG.  While this is often a nice feature,
it immediately makes the log file UNVERIFIED.

The difference between VERIFIED and UNVERIFIED log files becomes important
for printed and mailed log files, especially for class assignments and such.

NOTE:  Logging full-screen applications is risky at best and are not guar-
anteed to be logged correctly.

To invoke JOBLOG, the syntax is:

   $ JOBLOG/qualifier(s)
2 Qualifiers
/CLASS

  /CLASS=class

  Used in conjunction with the /RETRIEVE qualifier, log files from the
  specified class are retrieved from the secure area and placed in the
  current directory.

/DELETE

  /DELETE=user

  Delete a JOBLOG that you've sent to USER from the staging area.  You must
  specify /USER.  A mail message stating that the log file has been deleted
  will be sent to USER.

/EXPERT

  /EXPERT

  Suppress the JOBLOG startup message.

/MAIL

  /MAIL=user

  Mail notification of log file to the specified user upon exit from JOBLOG.
  The log file will be placed in a secure staging area and can then be
  retrieved by the user by using the /RETRIEVE qualifier.  The specified
  user must possess one of the following identifiers:  STAFF, FACULTY,
  JOBLOG_RECIPIENT.

/PRINT

  /PRINT[=queue]

  Print the log file upon exit from JOBLOG to the specified queue.  If
  no queue is specified, you will be prompted for it upon exiting JOBLOG.

/RETRIEVE

  /RETRIEVE

  Retrieve a log file from the secure area.  You must know the username of
  user who sent you the notification of the pending log file.  You must also
  specify either /CLASS or /USER.

/SAVE

  /SAVE[=file-spec]

  Save the log file to the specified file upon exit from JOBLOG.  If the
  file-spec is not specified, you will be prompted for it upon exiting
  JOBLOG.

/SKIM

  /SKIM

  Skim the secure area, deleting old log files and warning both senders and
  recipients (via mail) of files that are soon to be deleted.  Both /WAIT
  and /WARN are required qualifiers.  SYSPRV is required to use this
  qualifier.

/TIME_STAMP

  /TIME_STAMP

  Display the current time in the log file for each DCL command entered.
  Time stamping can be toggle on/off by entering control-^.

/USER

  /USER[=username]

  Specify the username for the /RETRIEVE or /MAIL qualifiers.  If /USER is
  not specified, you will be prompted for it.

/WAIT

  /WAIT=n

  Specified in conjunction with the /WARN qualifier, /WAIT specifies how
  how long to wait before a pending log file is deleted from the secure
  area.  Any log files older than n days are deleted.  SYSPRV is required
  to use this qualifier.

/WARN

  /WARN=n

  Mail messages are sent to senders and recipients of files in the secure
  area that are older than n days but not older than the number of days
  specified with the /WAIT qualifier.  Both /SKIM and /WAIT must be speci-
  fied with this qualifier.  SYSPRV is also required to use this qualifier.

2 time_stamp
  To enable time stamping of all DCL commands in JOBLOG, enter control-^
  (hold the Control key down and press ^).  Each time this is entered the
  time stamp feature is toggled.  It is initially off when JOBLOG is
  started.  Specify the /TIME_STAMP qualifier on the command line to start
  JOBLOG with time-stamping enabled.

2 toggle_logging
  To toggle logging on/off, enter control-\ (hold the Control key down and
  press \).  Logging is initially enabled with JOBLOG starts.  If logging
  is ever turned off, the log file immediately becomes UNVERIFIED.  
