IT23425: HTTP ERROR 500 WITH JAVA.LANG.STRINGINDEXOUTOFBOUNDSEXCEPTION WHEN RUNNING CMS QUERY FOR SAVED OBJECTS

APAR status

• Closed as program error.

Error description

• Querying the IBM Spectrum Protect Server for objects backed up
  for a node using the Client Management Service (CMS) web
  interface can return the http error 500 when the node option
  file contains the option 'ASNODENAME'.
  
  Here is an example on Linux :
  
  /opt/tivoli/tsm/client/ba/bin/dsm.sys
  
  SERVERNAME SERVER1
  COMMMETHOD TCPIP
  TCPPORT 1500
  TCPSERVERADDRESS 1.2.3.4
  NODENAME NODE_A
  ASNODENAME NODE_B
  PASSWORDACCESS GENERATE
  ERRORLOGNAME /var/log/tsm/NODE_A.log
  
  The CMS configuration must have the required FILE_RESTORE
  capability enabled to be able to run the queries for the backed
  up objects stored on the server as seen below :
  
  /opt/tivoli/tsm/cms/bin/CmsConfig.sh enable NODE_A FILE_RESTORE
  
  Enable capability
  Finished enabling capability.
  
  /opt/tivoli/tsm/cms/bin/CmsConfig.sh list
  
  Listing CMS configuration
  1.2.3.4:1500 NODE_A
  Capabilities: [LOG_QUERY, DAEMON_QUERY, DAEMON_UPDATE,
  FILE_RESTORE]
  Opt Path: /opt/tivoli/tsm/client/ba/bin/dsm.opt
  Sys Path: /opt/tivoli/tsm/client/ba/bin/dsm.sys
  Log File: /var/log/tsm/NODE_A.log
  en_US MM/dd/yyyy HH:mm:ss UTF-8
  
  Trying the following queries will return the errors :
  
  URL : https://<CMS
  host>:9028/tsmcms/backupSystems/NODE_A/savedObjects
  Message :
  Error 500: java.lang.StringIndexOutOfBoundsException: String
  index out of range: -2
  
  URL : https://<CMS
  host>:9028/tsmcms/backupSystems/NODE_A/savedObjects?path=/tmp/te
  st_1
  Message :
  Error 500: java.lang.NumberFormatException: For input string:
  &quot;---&quot;
  
  Customer/L2 Diagnostics :
  
  Looking into the CMS log :
  /opt/tivoli/tsm/cms/Liberty/usr/servers/cmsServer/logs/message.l
  og
  
  The following type of errors will be seen :
  
  [ERROR ] An unhandled exception occurred which will be
  propagated to the container.
  [ERROR ] SRVE0777E: Exception thrown by application class
  'java.lang.String.substring:1,377'
  java.lang.StringIndexOutOfBoundsException: String index out of
  range: -2
  
  
  [ERROR ] An unhandled exception occurred which will be
  propagated to the container.
  [ERROR ] SRVE0777E: Exception thrown by application class
  'java.lang.NumberFormatException.forInputString:76'
  java.lang.NumberFormatException: For input string: "---"
  
  These messages are happening because from the client query
  response, the code sees an unexpected line :
  "Accessing as node: NODE_B"
  that causes the parser to fail.
  
  For our example, the client queries outputs that are used look
  as follow :
  
  dsmc -se=SERVER1
  IBM Spectrum Protect
  Command Line Backup-Archive Client Interface
  Client Version 8, Release 1, Level 0.2
  Client date/time: <client_timestamp>
  (c) Copyright by IBM Corporation and other(s) 1990, 2017. All
  Rights
  Reserved.
  
  Node Name: NODE_A
  Session established with server SERVER1: Linux/x86_64
  Server Version 7, Release 1, Level 4.100
  Server date/time: <server_timestamp> Last access: <timestamp>
  
  Accessing as node: NODE_B
  
  Protect> q fi
  
  # Last Incr Date Type File Space Name
  - ---------------- ---- ---------------
  1 00/00/0 00:00:00 ext4 /tmp
  
  Protect> q ba /dss/dsstestfs01/
  Size Backup Date Mgmt Class A/I File
  ------- ------------------- ---------- --- -----------
  4,096 B 11/11/2017 14:00:00 STANDARD A /tmp/test_1
  
  
  When the client option 'ASNODENAME' is used, the extra line :
  "Accessing as node: <nodename>"
  will be seen and that is causing the parser to fail.
  
  IBM Spectrum Protect Versions Affected:
  IBM Spectrum Protect Operations Center 7.x and 8.1.x on all
  supported platforms
  
  Initial Impact: Low
  
  Additional Keywords: cms asnode query
  

Local fix

• Prefer using the option 'asnodename' in the client commands or
  schedules instead of in the client option file.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All IBM Spectrum Protect Client Management Services users.   *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See error description.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in levels 8.1.6. Note that this is     *
  * subject to change at the discretion of IBM.                  *
  ****************************************************************
  

Problem conclusion

• This problem was fixed.
  Affected platforms for reported release:  AIX, Linux, and
  Windows.
  Platforms fixed:  AIX, 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 OPERATIONS

• Fixed component ID

  5608E01UI

Applicable component levels