IBM Support

IT13631: LABEL LIBVOL MAY FAIL WHEN THE TAPE CARTRIDGE IS SET AT THE SLOT WHERE CLEANER CARTRIDGE WAS PLACED BEFORE

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • LABEL LIBVOL may fail when the tape cartridge is set at the
    slot at where the cleaner cartridge was placed before.  For
    example, when LABEL LIBVOL is executed with specifying
    labelsource=vollist vollist=vol_label, it may fail with
    ANR8946W.
    
    ANR8946W There were more labels in the vollist than volumes
    available to label.
    
    Here is steps to recreate the issue:
    [1] Do CHECKIN LIBV the cleaner cartridge at slot N.
    [2] Do CHECKOUT LIBV the cleaner, but leave the cleaner
    cartridge in the slot N because the library has no Imp/Exp
    ports.
    [3] Do CHECKIN LIBV some tape cartridges in other slots than
    slot N.
    [4] Manually remove the cleaner cartridge, then insert the tape
    cartridge into slot N.
    [5] Do LABEL LIBV labelsource=vollist vollist=vol_label
    checkin=private or scratch
    
    At step [5], it is expected that the tape cartridge at slot N
    could be labeled and checkin, but actually it failed with
    ANR8946W.
    
    This issue can occur because the server does not correctly
    update status of the slot if it is once set as Cleaner.  This
    problem will also occur in both cases of labelsource=volrange
    and labesource=barcode.
    At step [5], status of slot N is still Cleaner in output of
    SHOW SLOTS:
    ---
    Slot N, status Cleaner, element number ****, barcode present,
    barcode value <vol_label>, devT=ANY, mediaT=-1, elemT=ANY
    ---
    Trace with PVR MMS shows the problem:
    ---
    hh:mm:ss.sss [nnn][mmsscsi.c][10288][RefreshSlotInfo]:Slot N:
    addr=****, useCode=CLEANR, devT=ANY, mediaT=-1, elemT=ANY.
    hh:mm:ss.sss [nnn][mmsscsi.c][11116][CopyValidBarcode]:Barcode
    for volume in slot **** is 'vol_label'. (There is no CLN in the
    barcode of 'vol_label'.)
    ---
    
    Tivoli Storage Manager Versions Affected:
    Tivoli Storage Manager Server 6.3 and 7.1 with on all supported
    platform
    
    Initial Impact:
    Low
    

Local fix

  • Run AUDIT LIBRARY with REFRESHSTATE=Yes, or restart the server,
    after  the tape cartridge is set at the slot where cleaner was
    placed before.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All Tivoli Storage Manager server users.                     *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See error description.                                       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Apply fixing level when available. This problem is projected *
    * to be fixed in levels 6.3.6 and 7.1.5.                       *
    * Note that this is subject to change at the discretion of     *
    * IBM.                                                         *
    ****************************************************************
    

Problem conclusion

  • This problem was fixed.
    Affected platforms: AIX, HP-UX, Linux, Solaris, and Windows.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT13631

  • Reported component name

    TSM SERVER

  • Reported component ID

    5698ISMSV

  • Reported release

    71W

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-02-04

  • Closed date

    2016-02-12

  • Last modified date

    2016-02-12

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

  • Fixed component name

    TSM SERVER

  • Fixed component ID

    5698ISMSV

Applicable component levels

  • R63A PSY

       UP

  • R63H PSY

       UP

  • R63L PSY

       UP

  • R63S PSY

       UP

  • R63W PSY

       UP

  • R71A PSY

       UP

  • R71H PSY

       UP

  • R71L PSY

       UP

  • R71S PSY

       UP

  • R71W PSY

       UP



Document information

More support for: Tivoli Storage Manager

Software version: 7.1.3

Reference #: IT13631

Modified date: 12 February 2016