The  Set   IPL  Date/Time  command   simplifies  the  setting   of  the
QIPLDATTIM system value.

Typical commands would be entered as:

                SETIPLDAT

The  default is  for the next  day at  the default  time.   The default
time is shipped as 060000 and can be changed on the command.

                SETIPLDAT   DATE(*DAY2) TIME(050000)

The IPL is set for two days from today at 5:00:00 AM.

A  completion message  occurs which  describes the  actual setting.   A
sample completion message is:

   Auto IPL is set for Tuesday May 10, 2009 at 5:00 AM.
      QIPLDATTIM system value is '05/10/09 060000'

The DATE parameter defaults to  *DAY1 which allows a simple  setting to
the next day.   Other special values exist or you  may enter a specific
date.

The  TIME parameter defaults  to *DTAARA which refers  to the SETIPLDAT
data area.   Follow the implementation instructions  for how to  create
the data area.

If you  prompt for  SETIPLDAT, a prompt  override program  extracts the
value  from the data area  and places it  in the TIME prompt.   You can
change the  setting of  the data  area with  the parameter  PERMCHG  on
SETIPLDAT or by the EDTDTAARA command.

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

   DATE          The date  of the IPL.   The  default is *DAY1  meaning
                 tomorrow.   The special values *TODAY,  *NONE, *DAY2 -
                 *DAY7  may be entered.  The  value *NONE means that an
                 automatic IPL does not occur.

   TIME          The time  of day  in military  time.   The default  is
                 *DTAARA which  uses the value stored  in the SETIPLDAT
                 data  area.   If  you prompt  for SETIPLDAT,  a prompt
                 override program extracts the  value and places it  in
                 the TIME prompt.

   PERMCHG       A *YES/*NO  value that  defaults to  *NO.  *NO  causes
                 no  change to  the SETIPLDAT  data area.   If  *YES is
                 entered, the SETIPLDAT  data area is  set to the  TIME
                 value specified.

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

You must be authorized to change the corresponding system values.

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

The following TAA Tools must be on your system:

     CVTDAYN      Convert day N (*DAY1, *DAY2 ...)
     EDTVAR       Edit variable
     RTVDAT       Retrieve date
     SNDCOMPMSG   Send completion message
     SNDESCMSG    Send escape message

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

The  tool  is  ready  to  use,  but  you  must  create  the  data  area
SETIPLDAT.

The data  area must be in a  library that will be found  on the library
list  of  the user  using the  SETIPLDAT command.   The  library should
also be  backed up as  it contains  your data.   QGPL would  be a  good
choice.

You  should decide on  a default  value for  the time of  day.   IN the
following code 6:00 AM is used.

             CRTDTAARA    DTAARA(xxx/SETIPLDAT) TYPE(*DEC)
                            LEN(6 0) VALUE(060000)
                            TEXT('Used by the TAA Tool SETIPLDAT')
                            AUT(*USE)

If  a  user should  be able  to change  the  default value,  you should
grant *CHANGE authority to the user.

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

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

   SETIPLDAT     *CMD                   TAASYSL       QATTCMD
   TAASYSLC      *PGM       CLP         TAASYSLC      QATTCL
   TAASYSLC2     *PGM       CLP         TAASYSLC2     QATTCL
*  SETIPLDAT     *DTAARA                     No source

* The SETIPLDAT data area is the library you create it in.