AIPS HELP file for PRTHI in 31DEC25

As of Tue Feb 11 8:20:09 2025

INPUTS

INNAME                             Image name(name).
INCLASS                            Image name(class).
INSEQ           0.0      9999.0    Image name(seq. #). 0=>high
INDISK          0.0         9.0    Disk drive #. 0=>any
DOCRT          -3.0       132.0    <= 0 -> List on line printer
                                   > 0  -> List on terminal
OUTPRINT
                                   Printer disk file to save
HISTART         0.0                start print w record HISTART
HIEND           0.0                end print w record HIEND
PRTASK                             print only history of task
KEYSTRNG                           print only lines with this
                                   string; ' ' do not test

HELP SECTION

PRTHI
Type: Verb
Use:  PRTHI writes the history file on the line printer or terminal.
      31DEC24 adds a backwards mode, invoked by setting HISTART >
      HIEND.  In this mode, if PRTASK is blank, the history lines
      are simply printed in backwards order.  However, if PRTASK
      is set then that task is sought in backwards order, but
      consecutive sets of history lines are printed in forward order.
      If there is more than one consecutive set, the most recent is
      printed first, then the previous, and so forth


      Interactive jobs which might print more than 500 lines on the
      line printer will require confirmation that you mean to do this.
      Note that the test is based on the HISTART and HIEND (including
      their default values) without regard for PRTASK which may reduce
      the number of lines substantially.
Adverbs:
  INNAME......Image name(name).   Standard defaults.
  INCLASS.....Image name(class).  Standard defaults.
  INSEQ.......Image name(seq. #).  0 => highest.
  INDISK......Disk drive # of image.  0 => any.
  DOCRT.......False (<= 0) use the line printer if OUTPRINT = ' '
                   else write named OUTPRINT file only.
                   With the file, DOCRT=-2 suppresses the page-feed
                   character in the header lines.  DOCRT=-3 suppresses
                   the header lines except at the start.
              True  (> 0) use the terminal interactively.  The task will
                   use the actual terminal width as a display limit
                   unless 72 < DOCRT < width.  In that case, the display
                   limit will be DOCRT characters.
  OUTPRINT....Disk file name in which to save the line printer output.
              ' ' => use scratch and print immediately for interactive
              jobs - batch jobs use OUTPRINT = 'PRTFIL:BATCHjjj.nnn'
              (jjj= job #, nnn = user #).  When OUTPRINT is not blank,
              multiple outputs are concatenated, and the file is not
              actually printed.
  HISTART.....Print history records beginning with record
              HISTART.  0 or too large => 1.
  HIEND.......Print history records ending with record HIEND.
              0 -> maximum history entry.
              Note that, when HISTART > HIEND, the inverse order
              printing described above is invoked.
  PRTASK......Print only those history records which begin with
              the same n non-blank characters as are given in
              PRTASK.  This is not particularly reliable, but
              should select the messages of particular tasks.
              Thus, PRTASK = 'UV   ' should print all messages
              from UVLOD, UVMAP, UVSRT, etc. but skip those from
              IMLOD, IMAGR, APCLN, etc.
   KEYSTRNG...Print only those history records containing KEYSTRNG
              somewhere in the line.  Note that this test is case
              sensitive and that trailing blanks are ignored.
              Both PRTASK and KEYSTRNG tests are applied but only
              if they are not blank.

EXPLAIN SECTION