DLTOLDQRPL Delete Old QRPLOBJ Objects

DLTOLDQRPL DELETE OLD QRPLOBJ OBJECTS TAASYSH
The QRPLOBJ library contains old versions of replaced objects such as programs, commands, and files. It is automatically cleared at each IPL. You may also clear QRPLOBJ with the CLRLIB command. Clearing with the CLRLIB command should only be done when you know that no one is using an old version of a replaced object. If a user is currently using an object which is deleted by CLRLIB, the user will receive an escape message and his job will probably be aborted. The most typical case where a problem may occur is with program objects. Program objects can be replaced while they are in use. Anyone using the old version will continue to do so even though the old version is placed in QRPLOBJ. Deleting one of these 'in use' objects will most likely cause a problem. Program objects are never locked so there is no good method of determining that a program object is in use. The purpose of the DLTOLDQRPL command is to allow you to clear QRPLOBJ with less concern over users who might be using one of the objects. It allows you to specify how many hours old an object in QRPLOBJ must be before it is deleted. DLTOLDQRPL is designed for those environments where IPL is rarely done, but periodic cleanup is needed. A typical command would be entered as: DLTOLDQRPL HOURS(10) Any objects which had been placed in QRPLOBJ over 10 hours ago would be deleted. Only the common object types are supported. To use DLTOLDQRPL, you must have *ALLOBJ authority (Program adopt may be used). Implementation method --------------------- DLTOLDQRPL gets an outfile of objects in QRPLOBJ. The change date/time of the object in QRPLOBJ is the time it was moved there. This time is compared against the HOURS value specified on the command and the objects are deleted as needed. Command parameters *CMD ------------------ HOURS The numbers of hours that an object must exist in QRPLOBJ before it is deleted. The default is 10. Any objects newer than 10 hours would remain. If a value is entered, it must be between 1 and 99. LIB The library to clear the objects from. QRPLOBJ is the default. If IASPs are used, a different QRPLOBJ library may be named such as QRPLOBJ033. Restrictions ------------ You must have *ALLOBJ authority to use DLTOLDQRPL (Program adopt may be used). Only the common object types are deleted. Messages appear for those object types that must be deleted manually. Prerequisites ------------- The following TAA Tools must be on your system: CLCDATDIF Calculate date difference CLCTIMDIF Calculate time difference EDTVAR Edit variable RTVDAT Retrieve date SNDCOMPMSG Send completion message SNDDIAGMSG Send diagnostic message SNDESCMSG Send escape 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 ------ ---- --------- ---------- ---------- DLTOLDQRPL *CMD TAASYSH QATTCMD TAASYSHC *PGM CLP TAASYSHC QATTCL


DLTOLDQRPL DELETE OLD QRPLOBJ OBJECTS TAASYSH
The QRPLOBJ library contains old versions of replaced objects such as programs, commands, and files. It is automatically cleared at each IPL. You may also clear QRPLOBJ with the CLRLIB command. Clearing with the CLRLIB command should only be done when you know that no one is using an old version of a replaced object. If a user is currently using an object which is deleted by CLRLIB, the user will receive an escape message and his job will probably be aborted. The most typical case where a problem may occur is with program objects. Program objects can be replaced while they are in use. Anyone using the old version will continue to do so even though the old version is placed in QRPLOBJ. Deleting one of these 'in use' objects will most likely cause a problem. Program objects are never locked so there is no good method of determining that a program object is in use. The purpose of the DLTOLDQRPL command is to allow you to clear QRPLOBJ with less concern over users who might be using one of the objects. It allows you to specify how many hours old an object in QRPLOBJ must be before it is deleted. DLTOLDQRPL is designed for those environments where IPL is rarely done, but periodic cleanup is needed. A typical command would be entered as: DLTOLDQRPL HOURS(10) Any objects which had been placed in QRPLOBJ over 10 hours ago would be deleted. Only the common object types are supported. To use DLTOLDQRPL, you must have ALLOBJ authority (Program adopt may be used). Implementation method --------------------- DLTOLDQRPL gets an outfile of objects in QRPLOBJ. The change date/time of the object in QRPLOBJ is the time it was moved there. This time is compared against the HOURS value specified on the command and the objects are deleted as needed. Command parameters CMD ------------------ HOURS The numbers of hours that an object must exist in QRPLOBJ before it is deleted. The default is 10. Any objects newer than 10 hours would remain. If a value is entered, it must be between 1 and 99. LIB The library to clear the objects from. QRPLOBJ is the default. If IASPs are used, a different QRPLOBJ library may be named such as QRPLOBJ033. Restrictions ------------ You must have ALLOBJ authority to use DLTOLDQRPL (Program adopt may be used). Only the common object types are deleted. Messages appear for those object types that must be deleted manually. Prerequisites ------------- The following TAA Tools must be on your system: CLCDATDIF Calculate date difference CLCTIMDIF Calculate time difference EDTVAR Edit variable RTVDAT Retrieve date SNDCOMPMSG Send completion message SNDDIAGMSG Send diagnostic message SNDESCMSG Send escape 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 ------ ---- --------- ---------- ---------- DLTOLDQRPL CMD TAASYSH QATTCMD TAASYSHC *PGM CLP TAASYSHC QATTCL

Added to TAA Productivity Tools April 1, 1995

Home Page

Last modified on July 15, 2010