IBM Support

Tivoli Storage Manager: DELETE VOLUME command returns ANR2401E.

Troubleshooting


Problem

Tivoli Storage Manager DELETE VOLUME command returns ANR2401E, although the target volume looks to exist.

Symptom

Tivoli Storage Manager volumes are often defined manually by using DEFINE VOLUME command. After that, however, the volumes rarely cannot be deleted by DELETE VOLUME command.

Then, the volume looks to exists because it is listed in output of QUERY VOLUME command, but DELETE VOLUME command returns ANR2401E, as below.

    tsm: SERVER1>delete volume VOLUME01
    ANR2401E  DELETE VOLUME: Volume VOLUME01 is not defined in a storage pool.
    ANS8001I  Return code 11.

Even if the user tries "delete volhistory" to delete the volume, the volume still remains.
Hence the user cannot delete the volume by using Tivoli Storage Manager Server Administrative commands.

Cause

This problem is caused by the user's mis-operations.
When the user manually inputs the volume name in the DEFINE VOLUME command, the user rarely inserts some unreadable characters into the volume name unexpectedly.
After the volume is defined, the user cannot see the unreadable characters on the QUERY VOLUME command's output.
Therefore, the customer cannot specify the defined volume name correctly.

Diagnosing The Problem

The user can check the data from DB2 directly if any garbage is included in the volume name, by using the following two DB2 select statements.

    select volid, volname, hex(volname), length(volname) from tsmdb1.SS_VOLUME_NAMES where volname like '%<volume name>%';
    select volid, volname, hex(volname), length(volname) from tsmdb1.as_volume_status where volname like '%<volume name>%';

For example, when the following command runs:
    select volid, volname, hex(volname), length(volname) from tsmdb1.SS_VOLUME_NAMES where volname like '%VOLUME01%';

the user can see if any unreadable characters are included, as below:
    VOLID  VOLNAME    3                     4  
    -----  ---------  --------------------  -----
      123  VOLUME01   564F4C554D4530317F        9

In above case, X'7F' is included unexpectedly. In addition, the length has become 9.

Resolving The Problem

The volume name can be fixed directly by using DB2 command, and then the DELETE VOLUME command can delete it, as below.

1. Get volid of the target volume from the above DB2 command's output.
2. Run two DB2 UPDATE commands, as below:

    update tsmdb1.SS_Volume_Ids set volname='<volume name>' where volid=<volid>
    update tsmdb1.as_volume_status set volname='<volume name>' where volid=<volid>

For example:
    update tsmdb1.SS_Volume_Ids set volname='VOLUME01' where volid=123
    update tsmdb1.as_volume_status set volname='VOLUME01' where volid=123

3. Run the DELETE VOLUME command of Tivoli Storage Manager.

[{"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"--","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"6.3;6.4;7.1","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}}]

Historical Number

81854

Document Information

Modified date:
17 June 2018

UID

swg21961520