The Display IPL History  command displays or lists the  dates and times
that an  IPL has occurred  within a range  of dates.   Inclusion of the
normal  power down entries is optional as  well as IPL completion.  You
must be  using the  CVTQHST2 tool  command  to first  convert the  QHST
information.

A typical command would be:

             DSPIPLHST

A  listing would  be  displayed of  the  IPL dates  and  times for  all
records in  the QHST2 file found on the  library list.  The message IDs
that are searched for are:

         CPF0903    Unattended IPL in progress
         CPF0905    Attended IPL in progress
         CPF0997    Attended IPL after abnormal system ending
         CPF0998    Unattended IPL after abnormal system ending

Creating the QHST2 file structure
---------------------------------

The QHST2 file  structure must be created.   If you  are not using  the
DSPQHST2  tool,  use CVTQHST2  with  CREATE(*YES)  to create  the  file
structure in a named library.

Security
--------

When  CVTQHST2 is used  to create the  QHST2 file structure,  the QHST2
file is  set to  *PUBLIC *EXCLUDE.   You  may authorize  anyone to  the
file.  *CHANGE authority  is required to use CVTQHST2.   *USE authority
is required to use SCNQHST.

DSPIPLHST escape messages you can monitor for
---------------------------------------------

      TAA9891    The QHST2 file does not exist.
      TAA9892    No records exist in the QHST2 file.

Escape messages from based on functions will be re-sent.

DSPIPLHST Command parameters                          *CMD
----------------------------

   PERIOD        A  4 part  parameter  to determine  the  beginning and
                 ending date/time values.

                 The  first part  is the  beginning time.   The default
                 is  *AVAIL  which means  the  earliest  time  for  the
                 beginning  date specified.    A specific  time may  be
                 entered   as  100000   or  with  separators   such  as
                 10:00:00.

                 The second part  is the beginning  date.  The  default
                 is  *BEGIN which  means the  first date  found in  the
                 file.    If a  date  is  entered, it  must  be  in JOB
                 format.   The date  cannot be  less than  the date  of
                 the first record in the QHST2 file.

                 The third  part is the  ending time.   The default  is
                 *AVAIL  which means  the  latest time  for  the ending
                 date  specified.   A specific  time may  be entered as
                 100000 or with separators such as 10:00:00.

                 The fourth part  is the ending  date.  The default  is
                 *END  which means  the last  date found  in  the file.
                 If  a date is entered, it must  be in JOB format.  The
                 date cannot  be  greater than  the  date of  the  last
                 record in the QHST2 file.

   QHST2LIB      The  library where  the QHST2  file structure  exists.
                 *LIBL  is  the  default.   The  files  must have  been
                 created   by   the   CVTQHST2   command   using    the
                 CREATE(*YES) option.

   INCPWRDWN     A  *YES/*NO  parameter  for  whether  to  include  the
                 normal power down entries.

                 *NO is  the default to  exclude the normal  power down
                 entries.

                 *YES  may  be specified  to  include the  normal power
                 down  entries.     A  normal   power  down  entry   is
                 considered to  be the CPF1164  completion message from
                 the  QSYSARB3   system  program.    The  text  of  the
                 message is changed  to indicate  a normal power  down.

   INCIPLCOMP    A *YES/*NO  parameter for whether  to include  the IPL
                 completion entries.

                 *NO  is  the default  to  exclude  the IPL  completion
                 entries.

                 *YES may be  specified to include  the IPL  completion
                 entries.   The IPL completion  entry is  considered to
                 be the CPF0934 completion message.

   OUTPUT        How  to  output the  results.   *  is  the default  to
                 display  the spooled  file if  the command  is entered
                 interactively.  If  the display  is ended with  F3/F12
                 or the  Enter key, the  spooled file is  deleted after
                 it  is displayed.    To retain  the spooled  file, you
                 may use the the  System Request 'Cancel' function  and
                 the spooled file will exist in a HLD status.

                 If  the  command is  entered  in  batch or  *PRINT  is
                 specified,  the spooled  file is output  and retained.


Restrictions
------------

None.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CVTDAT          Convert date
     CVTTIM          Convert time
     DSPQHST2        Display QHST2
     RSNLSTMSG       Resend last message
     RTVDAT          Retrieve date
     RTVSYSVAL3      Retrieve system value 3
     SCNQHST         Scan QHST
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   DSPIPLHST     *CMD                   TAASYUB       QATTCMD
   TAASYUBC      *PGM       CLP         TAASYUBC      QATTCL
   TAASYUBR      *PGM       RPG         TAASYUBR      QATTRPG