For ADS/ALIVE, when are DEBUGQUEUE records deleted and how is the QKEEP parameter used?

Document ID : KB000049706
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

For ADS/ALIVE, when are DEBUGQUEUE records deleted and how is the QKEEP parameter used to determine when DEBUGQUEUE Queue records are to be deleted.

Solution:

DEBUGQUEUE is created the first time a dialog aborts after ADS/ALIVE is installed. A DEBUGQUEUE record is created for each dialog abort and the the details of the abort can be viewed using QREVIEW. When the QREVIEW task code is invoked from ENTER NEXT TASK CODE, it presents a menu from which you can select or delete each entry.

When DEBUGQUEUE records are created/written to the Queue it is always with a retention value of 255 days. Whenever the CV is recycled the autotask USGADEL is run ( or it can be run online any time simply be entering the task code USGADEL at the Enter Next Task Code prompt) then the value defined in ADS/ALIVE USGTPARM macro for the QKEEP parameter is used and date the records were created is compared with the current date.

If this is greater than QKEEP then the queue record(s) will be deleted.

This is regardless of the retention date of 255 that was initially used.

If, for example, you set QKEEP to 5 and the CV gets recycled and there is greater than 5 days between the recycle date and the creation date the queue record(s) get deleted.

Thus this in effect takes precedence over the retention value of 255.

Example for USGTPARM

*ASSEMBLED VALUES AT INSTALLATION:
USGTPARM USGTSK='ADSALIVE',
         HLPDICT=' ',
         HLPNODE=' ',
         HLPVERS=1,
         PCHOFF=3800,
         SWEEP=Y,
         AUTO=Y,
         QKEEP=3,    
         PROKEEP=255,
  DICTDEF=P,
  ABRTSCR=Y
END
 
*----------------------------------------------------------------------

References:

IDMS Installation and Maintenance for z/OS
- Appendix F CA ADS Alive Runtime Parameters - USGTPARM QKEEP=INTEGER NUMBER OF DAYS TO RETAIN DEBUGQUEUE RECORDS