IBM Support

IC45537: TSM LIBRARY CLIENT DOES NOT SUPPORT MULTI-VOLUME CHECKOUT

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as fixed if next.

Error description

  • The TSM library client does not currently support the concurrent
    checkout of multiple volumes.  For example, if a MOVE DRMEDIA
    process is initiated from the library client and requires the
    checkout of multiple volumes, an unique checkout process will be
    started for each volume on the library manager.  This creates a
    problem with shared ACSLS libraries, as the checkout processes
    on the library manager require that the volume be removed from
    the CAP before the process will complete successfully.  Thus, a
    checkout of 20 volumes from the library client will require that
    the customer remove each individual volume from the CAP one at a
    time.
    .
    Platforms Affected:  All 5.3 TSM Servers
    .
    Initial Impact: LOW
    

Local fix

  • Here is a workaround for shared ACSLS libraries that can be used
    to avoid having to remove each volume from the CAP after each
    volume is checked out individually.
    .
    1. Set the REQSYSAUTHOUTFILE server option to Yes
    2. Issue the following MOVE DRMEDIA command to process database
       and storage pool volumes that are in MOUNTABLE state, and
       generate a list of tapes that should be moved off-site:
          MOVE DRMEDIA * WHERESTATE=MOUNTABLE TOSTATE=To_State
          REMOVE=NO CMD=&VOL CMDFILE=Vol_List APPEND=No WAIT=YES
             Where:
                - 'To_State' may be NOTMOUNTABLE, COURIER or VAULT
                - 'Vol_List' specifies the fully qualified name of
                  the file that will contain the volumes that have
                  to be moved off-site.  You may place this file on
                  a directory that may be accessed by the Library
                  Client server and the Library Manager server, or
                  you may ftp the file to the machine where the
                  Library Manager Server resides.
    .
    On Library Manager:
    3. Issue the following command:
          CHECKIN LIBVOL lib_name search=yes stat=private
          checklabel=no vollist=FILE:Vol_List
    4. Wait until all the volumes are checked in.
    5. Issue the following command to eject the tapes from the
       library
          CHECKOUT LIBVOL lib_name vollist=FILE:Vol_List
    6. Wait until all the volumes are checked out.
    7. Remove the volumes from the CAP
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: 5.3.x TSM servers on AIX, HP, Linux,         *
    *                 Sun Solaris, and Windows being used          *
    *                 as a library client in a library             *
    *                 sharing configuration with ACSLS             *
    *                 libraries.                                   *
    ****************************************************************
    * PROBLEM DESCRIPTION: The behavior of the MOVE DRMEDIA        *
    *                      command documented in the ERROR         *
    *                      DESCRIPTION is a current limitation     *
    *                      of library sharing with ACSLS           *
    *                      libraries. The Library Client does      *
    *                      not support a checkout request for      *
    *                      multiple volumes.                       *
    *                                                              *
    *                      The MOVE DRMEDIA command supports       *
    *                      checkout of multiple volumes for        *
    *                      ACSLS libraries if the command is       *
    *                      issued on the Library Manager.          *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    See ERROR DESCRIPTION.
    

Problem conclusion

Temporary fix

Comments

APAR Information

  • APAR number

    IC45537

  • Reported component name

    TSM SERVER 510

  • Reported component ID

    5698ISMSV

  • Reported release

    53A

  • Status

    CLOSED FIN

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2005-03-25

  • Closed date

    2005-04-08

  • Last modified date

    2005-04-08

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

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

Fix information

Applicable component levels

  • R53A PSY

       UP

  • R53H PSY

       UP

  • R53L PSY

       UP

  • R53S PSY

       UP

  • R53W PSY

       UP



Document information

More support for: Tivoli Storage Manager

Software version: 53A

Reference #: IC45537

Modified date: 08 April 2005