IC75795: DSMADMC RETURNS ZERO WHEN BACKUP STGPOOL COMMAND FAILS.

IBM Tivoli Storage Manager (TSM) server V6.1.5.x interim fix downloads

APAR status

• Closed as program error.

Error description

• The highest return code of dsmadmc returns zero
  when "BACKUP STGPOOL" command fails.
  Tivoli Storage Server should have reported back to the command
  that the process fails by setting a flag value.
  However, the flag value does not get saved properly.
  Therefore Tivoli Storage Server reports zero return code to the
  admin client for the BACKUP STGPOOL command.
  
  
  Example of error case:
  # dsmadmc -id=admin -password=xxx backup stgpool pripool
  copypool maxprocess=2 wait=yes
  IBM Tivoli Storage Manager
  Command Line Administrative Interface - Version 6, Release 2,
  Level 2.0
  (c) Copyright by IBM Corporation and other(s) 1990, 2010. All
  Rights Reserved.
  
  Session established with server xxxxx: AIX
    Server Version 6, Release 2, Level 2.0
  
  ANS8000I Server command: 'backup stgpool PRIPOOL COPYPOOL
  maxprocess=2 wait=yes'
  ANR0984I Process 8 for BACKUP STORAGE POOL started in the
  FOREGROUND at 20:19:28.
  ANR2110I BACKUP STGPOOL started as process 9.
  ANR1210I Backup of primary storage pool PRIPOOL to copy storage
  pool COPYPOOL started as process 8.
  ANR0984I Process 9 for BACKUP STORAGE POOL started in the
  FOREGROUND at 20:19:28.
  ANR2110I BACKUP STGPOOL started as process 9.
  ANR1210I Backup of primary storage pool PRIPOOL to copy storage
  pool COPYPOOL started as process 9.
  ANR1221E BACKUP STGPOOL: Process 8 terminated - insufficient
  space in target storage pool COPYPOOL.
  ANR1221E BACKUP STGPOOL: Process 9 terminated - insufficient
  space in target storage pool COPYPOOL.
  ANR0985I Process 8 for BACKUP STORAGE POOL running in the
  FOREGROUND completed with
  completion state FAILURE at 20:19:30.
  ANR0985I Process 9 for BACKUP STORAGE POOL running in the
  FOREGROUND completed with
  completion state FAILURE at 20:19:30.
  ANR1214I Backup of primary storage pool PRIPOOL to copy storage
  pool COPYPOOL has ended.
   Files Backed Up: 0, Bytes Backed Up: 0, Unreadable Files: 0,
  Unreadable Bytes: 0.
  ANS8002I Highest return code was 0.
  
  
  TSM Versions Affected:
  6.1 and 6.2 TSM Servers for all platform
  
  Initial Impact: Low
  
  Additional Keywords:
  zz61 zz62 RC
  

Local fix

• Please login to server directly and then execute "BACKUP
  STGPOOL" command.
  

Problem summary

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

Problem conclusion

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

Temporary fix

Comments

APAR Information

• 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

• R61S PSY

     UP

• R61W PSY

     UP

• R62A PSY

     UP

• R62H PSY

     UP

• R62L PSY

     UP

• R62S PSY

     UP

• R62W PSY

     UP