CLNSYS Clean System

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


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

Last modified on July 15, 2010