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