Console Commands › Console Commands › REFRESH=POOLS

REFRESH=POOLS

This command causes the SVTS address space to reload the Volume Pool Definitions Section of parmlib. This allows you to add to or change the pool assignment of Virtual Volumes. It can also be used to delete Virtual Volume from CA Vtape.

Since the Virtual Volumes are stored in the Global VCAT, this command only needs to be issued once in a CA Vtape complex. The CA Vtape subsystem that processes the command makes the necessary changes to the Global VCAT to add new VOLSER ranges, change the pool assignment of VOLSER ranges, or delete VOLSER ranges. The other CA Vtape subsystems sharing this Global VCAT will automatically pick up the changes.

For example, if your CA Vtape complex is composed of SVT1 and SVT2 running on SYSA and SVT1 running on SYSB and you issue the console command SVT1 REFRESH=POOLS on SYSA, SVT1 on SYSA will update the Global VCAT. SVT2 on SYSA and SVT1 on SYSB will automatically pick up those changes. The same is true if the SVT1 REFRESH=POOLS,DELETE command was issued on SYSA.

Syntax

SVTn REFRESH=POOLS [,DELETE]

DELETE

Specify DELETE if you want to remove Virtual Volumes which are not defined in the <VolumePoolDefinition> from CA Vtape.

Note: If you do not specify DELETE, the REFRESH=POOLS command will not delete Virtual Volumes that are no longer defined or are assigned to the wrong Pool. This is to guard against accidental deletion of Virtual Volumes.

Example of information displayed by the REFRESH=POOLS command

SVT5 REFRESH=POOLS 
IEE252I MEMBER XE61SVT5 FOUND IN hlq.PARMLIB  
IEE252I MEMBER  VTPSVT5 FOUND IN hlq.PARMLIB  
SVT5S1600I Scratch Pool(1) #Cells(3900) #Free(3898) Extents(39) 
SVT5S1600I Scratch Pool(2) #Cells(700) #Free(700) Extents(7) 
SVT5S1600I Scratch Pool(8) #Cells(1000) #Free(440) Extents(10) 
SVT5S2500I VolumePoolOptions refresh complete  
SVT5X0100I Command Complete