The  Retrieve  IPL  Time  command  retrieves   the  date/time  the  IPL
started/ended,  the number  of seconds  required to  IPL, and  the same
information  for the last  powerdown.  The  end time of  the IPL is not
the  time the  system  is  fully  operational as  other  jobs  must  be
started such  as TCP.   RTVIPLTIM provides basic information  about the
time required.

The  command  adopts  the  authority of  QSECOFR  to  avoid  an *ALLOBJ
requirement and  uses  the system  program  QWCCRTEC which  produces  a
QPSRVDMP spooled file.   The spooled file  is then read to  extract the
information.    Because  of  this  technique,  the command  is  English
language dependent.

A typical set of commands would be:

             DCL           &IPLSEC *DEC LEN(5 0)
              .
             RTVIPLTIM     IPLSEC(&IPLSEC)

The values are all returned without separators.  To add separators:

  **   For dates,  use either  the  system CVTDAT  command or  the  TAA
       Tool CVTDAT programs.

  **   For time, use the TAA CVTTIM command.

RTVIPLTIM escape messages you can monitor for
---------------------------------------------

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

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

   STRIPLDAT     The date  the IPL started  in the  format CYMD.   This
                 is an  optional return variable  that if used  must be
                 specified as *CHAR LEN(7).

   STRIPLTIM     The  time the IPL started in  the format HHMMSS.  This
                 is an optional  return variable that  if used must  be
                 specified as *CHAR LEN(6).

   ENDIPLDAT     The date  the IPL ended in  the format CYMD.   This is
                 an  optional  return  variable that  if  used  must be
                 specified as *CHAR LEN(7).

   ENDIPLTIM     The time the  IPL ended  in the format  HHMMSS.   This
                 is an  optional return variable  that if used  must be
                 specified as *CHAR LEN(6).

   IPLSEC        The  number of seconds required  for the IPL.   If the
                 IPL information is  invalid, a  -1 is  returned.   The
                 time  does  not  reflect  when  the  system  is  fully
                 operational  as other  jobs  must be  started  such as
                 TCP.    This is  an optional  return variable  that if
                 used must be specified as *DEC LEN(5 0).

   STRPWRDWND    The date the power  started in the format CYMD.   This
                 is an  optional return variable  that if used  must be
                 specified as *CHAR LEN(7).

   STRPWRDWNT    The  time   the  power  down  started  in  the  format
                 HHMMSS.  This is an  optional return variable that  if
                 used must be specified as *CHAR LEN(6).

   ENDPWRDWND    The  date the  power down  ended in  the format  CYMD.
                 This  is  an  optional return  variable  that  if used
                 must be specified as *CHAR LEN(7).

   ENDPWRDWNT    The time the  power down ended  in the format  HHMMSS.
                 This  is an  optional  return  variable that  if  used
                 must be specified as *CHAR LEN(6).

   PWRDWNSEC     The  number of  seconds required  for the  power down.
                 If  the  power down  information is  invalid, a  -1 is
                 returned.   This is an  optional return variable  that
                 if used must be specified as *DEC LEN(5 0).

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

You must have *ALLOBJ special authority to use RTVIPLTIM.

Because the  command returns  variables, it  may only be  used in  a CL
program.

Because  a spooled file must  be read, the command  is English language
dependent.

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

The following TAA Tools must be on your system:

     CLCTIMDIF       Calculate time difference
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   RTVIPLTIM     *CMD                   TAASYTK       QATTCMD
   TAASYTKC      *PGM       CLP         TAASYTKC      QATTCL