My Oracle Support Banner

HSM (SAM-QFS): How To Verify That Tapes Marked for Recycling Are Draining (Doc ID 1010050.1)

Last updated on AUGUST 02, 2023

Applies to:

Oracle Hierarchical Storage Manager (HSM) and StorageTek QFS Software - Version 5.4 and later
All Platforms


The sam-recycler(1M) command invokes the recycler. The recycler marks all the current (valid) archive images that are present on a volume with the rearchive attribute.
The recycler also marks the selected archive volume with the recycle attribute. This prevents the archiver from writing any more archive images to the volume.

The archiver moves all the marked images to another volume. This operation is called "rearchiving" or for the recycler, it's called "draining".

After the archiver moved the current archives to other volumes, the sam-recycler(1M) can be run again, at which point it will find the old volume empty (i.e. it only contains obsolete archives) and will activate the script configured in /etc/opt/SUNWsamfs/scripts/  This script can be configured to issue a tplabel command to relabel the cartridge with its existing label. Relabeling has the effect of clearing all the expired archive images from the cartridges, thus enabling the archiver to re-use the cartridge. Labeling also clears the recycle bit in the VSN's catalog entry.

For more information on the recycler process, reference the 6.1 HSM and StorageTek QFS Software Maintenance and Administration Guide.


To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.