TAA Tools
CLNSYS          CLEAN SYSTEM                           TAASYSI

The Clean System command  is designed for periodic use to  clean up the
system.   A typical command which would take  all the defaults would be
entered as:

        CLNSYS

The  command  submits  a  long running  function  to  batch  which will
perform cleanup  using other TAA  tools.   The following are  performed
with the TAA tool described for each function.

  **   The standard journal receivers - MTNJRN

  **   Old spooled files - DLTOLDSPLF

  **   Old messages - RMVOLDMSG

  **   Old QHST files - DLTQHST

  **   Old objects in QRPLOBJ - DLTOLDQRPL

  **   TAA temporary members - CLNTAATEMP

Each of  the functions  has an option  to allow you  to control  if and
how  old the individual objects/files/messages must  be before they are
deleted.   Be  sure you  understand  the  parameters before  using  the
command.

A QPRINT  spooled file is output  with the completion messages  of each
of  the functions included.   If the  spooled file option  is chosen, a
SPLFILES spooled output file is also created.

You must  have *ALLOBJ  authority  to use  the  command.   The  command
would  normally be  used  interactively  to submit  a  batch job.    If
CLNSYS is  run within a  batch job, the  program adopt function  may be
used to acquire the *ALLOBJ special authority.

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

   MTNJRN        A  list  for  whether the  MTNJRN  function  should be
                 used.    See  the   TAA  tool  MTNJRN  for   a  detail
                 understanding of the parameters.

                 Journals.   *ALLSTD  is  the default.    *NONE may  be
                 specified to prevent the MTNJRN function.

                 Generate  new receiver.    *YES is  the default.   *NO
                 may be specified.

                 Delete old receiver.   *YES is the  default.  *NO  may
                 be specified.   If  *YES is  entered and the  receiver
                 has   never  been   saved,  the  inquiry   message  is
                 ignored.

                 Retain days.   8  is the  default meaning  a  detached
                 receiver must have  been created 8 days ago  before it
                 will be deleted.

   DLTOLDSPLF    The number  of days old a spooled  file must be before
                 it  is  deleted.   The  default  is 14.    The special
                 value  *KEEPALL  will   avoid  any  deletion  of   old
                 spooled files.   This function  invokes the DLTOLDSPLF
                 TAA tool.

   RMVOLDMSG     The  number of  days old a  message must  be before it
                 is removed.   The default  is 14.   The special  value
                 *KEEPALL  will avoid  any  removing  of old  messages.
                 This function invokes the TAA tool RMVOLDMSG.

   DLTQHST       The number  of days old a QHST  file must be before it
                 is deleted.   The  default is  5.   The special  value
                 *KEEPALL will  avoid deleting  any QHST  files.   This
                 function invokes the TAA tool DLTQHST.

   DLTOLDQRPL    The number  of hours old an object  must be in QRPLOBJ
                 before  it  is  deleted.   The  default  is  10.   The
                 special  value  *KEEPALL will  avoid  any  cleanup  of
                 QRPLOBJ.     This  function   invokes  the   TAA  tool
                 DLTOLDQRPL.

   CLNTAATEMP    Cleanup  of TAA tool members.   The default is *YES to
                 cause the  CLNTAATEMP  command to  run.   *NO  may  be
                 specified.

   JOBD          The  job  description  to  run the  job  under.    The
                 default  is  *USRPRF which  uses  the  job description
                 assigned to your  user profile.   The  intent of  this
                 parameter is  to  allow you  to submit  the  job to  a
                 specific  job queue  or  to acquire  any  other unique
                 job attributes.

   JOBQ          The  job queue to be  used.  The default  is *JOBD.  A
                 job queue can  be named with  or without describing  a
                 specific  JOBD.  The  intent of  this parameter  is to
                 allow  you to use the default  for the JOBD and submit
                 the job to a specific job queue.

   DLYHRS        The number  of  hours  you wish  to  delay  execution.
                 The default  is 0.  When  the job becomes  active, the
                 DLYJOB command  is used if you  have specified a value
                 greater than 0.  Note  that this does not prevent  the
                 job  from   going  active,   but  merely  delays   the
                 majority of the work.

                 The intent  of this parameter is to  let an authorized
                 user  submit  the  job  during the  day  and  have the
                 majority of work performed in the off shift hours.

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

The function can  only be performed by  a user with *ALLOBJ  authority.

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

The following TAA Tools must be on your system.

     CLNTAATEMP   Clean TAA temporary files
     CVTSYSSTS    Convert system status
     DLTOLDQRPL   Delete old QRPLOBJ objects
     DLTOLDSPLF   Delete old spooled files
     DLTQHST      Delete QHST files
     MOVCHRDEC    Move character to decimal
     MTNJRN       Maintain journal
     RMVOLDMSG    Remove old messages
     SNDCOMPMSG   Send completion message
     SNDSTSMSG    Send status message

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

None, the tool is ready to use.

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

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

   CLNSYS        *CMD                       TAASYSI       QATTCMD
   TAASYSIC      *PGM           CLP         TAASYSIC      QATTCL
   TAASYSIC2     *PGM           CLP         TAASYSIC2     QATTCL
   TAASYSIR      *PGM           RPG         TAASYSIR      QATTRPG
					

Added to TAA Productivity tools April 1, 1995


Home Page Up to Top