DLTQHST DELETE QHST TAAHSTB
The Delete QHST command provides a simple method of cleaning up QHST logs. QHST contains system wide messages. The messages are kept in an internal file until the system value QHSTLOGSIZ is reached. A log version is created with the name QHSTyydddn where: yy the year ddd the Julian date the log version was created n the sequence number within the Julian date The DLTQHST command simplifies the cleanup of QHST logs by allowing a command to specify the number of days of log versions that you want to keep. The typical command would be entered as: DLTQHST DAYS(10) This will delete all QHST logs that are older than 10 days from the current system date. The date compared against is the date the log version was closed. This means all messages that were sent prior to 10 days ago would be deleted. The completion message includes a count of the files deleted and their size and the corresponding numbers for the remaining files. You must have *USE authority to TAADLTQHST to use the DLTQHST command. The DLTQHST command could be placed in an auto start job for the controlling subsystem to implicitly cleanup the old versions as part of the subsystem start. You could also consider saving the old logs before deleting them. Command parameters *CMD ------------------ DAYS The number of days to keep the QHST logs. The default is 5 meaning that any logs created in the last 5 days will be kept. All others will be deleted. Security considerations ----------------------- The DLTQHST command must be created by someone with *ALLOBJ special authority (e.g. the Security Officer). The TAAHSTBC program is created with USRPRF(*OWNER). The command DLTQHST and the TAAHSTBC CL program are created so they may not be executed unless a user is authorized to the TAADLTQHST authorization list. Prerequisites ------------- The following TAA Tools must be on your system: EDTVAR Edit variable Restrictions ------------ None. Implementation -------------- The tool is ready to use, but a user must be authorized to the TAADLTQHST authorization list. To authorize a user, use EDTAUTL or specify: ADDAUTLE AUTL(TAADLTQHST) USER(xxx) AUT(*USE) Objects used by the tool ------------------------ Object Type Attribute Src member Src file ------ ----- --------- ---------- ----------- DLTQHST *CMD TAAHSTB QATTCMD TAAHSTBC *PGM CLP TAAHSTBC QATTCL