This procedure implements TRU SCAN/RECLAIM as a manual process controlled by TRU commands. This is the most common implementation that is used in the field. In addition to this manual process there are 2 other runtime methods that you can use:
- Completely automatic TRU SCAN/RECLAIM processing
- Specifying precise times when TRU should be run every day.
Additional details on TRU SCAN/RECLAIM can be found in the following KB articles and in the ResourcePak_Base Product Manual:
KB 13664: Deployment KB: Mainframe Thin Reclaim Utility (TRU) Frequently Asked Questions
KB 22107: MFE SCF: Support: Recommended TRU Parameter Settings and Maintenance Requirements
KB 66341: VMAX3, VMAX All Flash, PowerMax: Storage Resource Pool (SRP) threshold alert
Procedure to setup and run the TRU SCAN/RECLAIM feature:
1. Query your existing SRP Pool utilization.
The pool usage information should be displayed before and after TRU RECLAIM activity.
The jobs to query SRP Pool utilization are provided after step 7 below.
2. Add these recommended TRU parameters to the SCF initialization member:
********* TRU DEFINITION ************
SCF.TRU.DEBUG=NO
SCF.TRU.DEV.INCLUDE.LIST=ccuu-ccuu ccuu = z/OS device address(s)
SCF.TRU.DEV.INCLUDE.LIST=ccuu-ccuu ccuu = z/OS device address(s) SCF.TRU.DEV.EXCLUDE.LIST=ccuu example exclude ccuu address
SCF.TRU.RECLAIM.SCRATCH.WAIT=100
SCF.TRU.RECLAIM.TASK.LIMIT=5
SCF.TRU.SCAN.TASK.LIMIT=5
SCF.TRU.RECLAIM.METHOD=3
SCF.TRU.RECLAIM.POST.TYPE=DEVICESIZE
SCF.TRU.SCRATCH.POST.TYPE=DEVICESIZE
SCF.TRU.RECLAIM.POST.PCT=100
SCF.TRU.SCRATCH.POST.PCT=100
SCF.TRU.RECLAIM.POST.MIN=9999999
SCF.TRU.SCRATCH.POST.MIN=9999999
SCF.TRU.RECLAIM.POST.MAX=9999999
SCF.TRU.SCRATCH.POST.MAX=9999999
SCF.TRU.OFFLINE=NOPROCESS
SCF.TRU.RECLAIM.STRESS.MONITOR=YES
SCF.TRU.RECLAIM.STRESS.WAIT=15
SCF.TRU.RECLAIM.STCNAME=EMCTRU
SCF.TRU.RECLAIM.DSPREFIX=dsn-prefix that can be allocated on volumes
********* TRU DEFINITION END **********
3. Create 1 new started task EMCTRU for the RECLAIM function:
//EMCTRU PROC CCUU=,TYPE=RECLAIM
//ESFTRURC EXEC PGM=ESFTRURC,PARM='&TYPE,&CCUU'
//STEPLIB DD DISP=SHR,DSN=your.linklib
//SCF$nnnn DD DUMMY
//SYSABEND DD SYSOUT=*
//ESFTRURC DD SYSOUT=*
4. Recycle SCF to activate the new parameters.
5. When you are ready to perform the RECLAIM, issue these SCF commands:
F emcscf,TRU,ENABLE
F emcscf,TRU,SCAN,ccuu-ccuu or 0000-FFFF
** Note: wait 15 minutes **
F emcscf,TRU,RECLAIM,ccuu-ccuu or 0000-FFFF
** Note: the RECLAIM can take a long time. When the RECLAIM is finished perform the DISABLE **
F emcscf,TRU,DISABLE
6. Query your existing SRP Pool utilization again.
These queries will reflect the new SRP space allocations after RECLAIM.
7. In order to verify that the TRU processing is working correctly and is optimally configured, these files need to be reviewed:
- SRP Pool query output (before and after RECLAIM)
- SCF STC output
- Host Component STC output
- SYSLOG that includes the entire TRU processing
- Some output from the EMCTRU started tasks.
Sample Batch Job to Query SRP and Pool utilization. Run steps 1 and 2.
1. Run this job to obtain your SRP and pool usage information.
//Job1 jobcard-----
//SNAP1 EXEC PGM=ESFGPMBT,REGION=4M
//STEPLIB DD DISP=SHR,DSN=your.linklib
//SCF$nnnn DD DUMMY
//SYSPRINT DD SYSOUT=*
//GPMPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//QCOUTPUT DD SYSOUT=*
//GPMINPUT DD *
QUERY SRP LOCAL(UNIT(ccuu))
QUERY POOLS LOCAL(UNIT(ccuu))
/*
2. To obtain poolname details, use these GPMINPUT statements in the above job.
The poolnames is found in the output of step 1.
//GPMINPUT DD *
DISPLAY( -
LOCAL(UNIT(ccuu))
DISPLAY( -
LOCAL(UNIT(ccuu)) -
TYPE(THINPOOL) POOL(poolname))
QUERY THINDEV LOCAL(UNIT(ccuu)) POOL(poolname)
QUERY DATADEV LOCAL(UNIT(ccuu)) POOL(poolname)
/*
3. To show all the individual LOCAL and REMOTE device allocations, use these GPMINPUT commands in the above job.
//GPMINPUT DD *
QUERY ALLOC (UNIT(ccuu))
QUERY ALLOC RMT(UNIT(ccuu) PATH(nn))
/*