IBM Support

RELABELSCRATCH parameter supported for DEFINE and UPDATE library commands (for Virtual Tape Libraries)

Product Documentation


The RELABELSCRATCH parameter allows you to automatically relabel volumes when they are returned to scratch. Support for this parameter is available in Fix Pack 5.5.1 and later levels.


Virtual Tape Libraries (VTLs) maintain volume space allocation after Tivoli Storage Manager has deleted a volume and returned it to a scratch state. The VTL has no knowledge that the volume was deleted and it keeps the full size of the volume allocate. This can be extremely large depending on the devices being emulated. As a result of multiple volumes that return to scratch, the VTL can maintain their allocation size and run out of storage space.

The only way for the VTL to realize that a volume has been deleted and its space can be reallocated is to write to the beginning of the newly returned scratch volume. The VTL will then see the volume as available. Tivoli Storage Manager can relabel volumes that have just been returned to scratch if the RELABELSCRATCH parameter is specified.

This optional parameter has been added to the DEFINE and UPDATE LIBRARY commands and is intended for use with VTLs. See the sections below for command changes.

Command Updates:




    Specifies whether the server relabels volumes that have been deleted and returned to scratch. When this parameter is set to Yes, a LABEL LIBVOLUME operation is started and the existing volume label is overwritten. This parameter is optional and intended for use with Virtual Tape Libraries (VTLs).
    Note: If you have both virtual and real volumes in your VTL, both types will be relabeled when this parameter is enabled. If the VTL includes real volumes, specifying this option could impact performance.

    Specifies that the server does not relabel volumes that are deleted and returned to scratch. This is the default value.

    Specifies that the server relabels volumes that are deleted and returned to scratch.

To determine if the RELABELSCRATCH parameter is set to Yes, you can issue the QUERY LIBRARY command.


FORMAT= DETAILED updated output:

[{"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":"Server","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"5.5","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
17 June 2018