IT30151: DSMC RETRIEVE COMMAND MIGHT FAIL WITH MISLEADING ANS1102E AND ANS1133W FOR OBJECT NAMES ENCODED IN JAPANESE LOCALES

APAR status

• Closed as program error.

Error description

• dsmc retrieve / dsmc restore command might fail with misleading
  ANS1102E and ANS1133W for object names encoded in Japanese
  locales.
  dsmc command line does not work correctly while dealing with
  filename or directory name which includes Japanese characters
  such as Japanese EUC locale and Japanese UTF8 locale.
  
  
  <Example 1>
  Output of "dsmc query archive":
  
  # dsmc query archive /tmp/test/euc/
  
  ????: XXXX                                                  €€€€
  Session established with server SERVER1: XXX
    Server Version 8, Release 1, Level 4.0
    Server date/time: 08/29/2019 11:13:05  Last access: 08/29/2019
  11:12:47
  
              Size  Archive Date - Time    File - Expires on -
  Description
               ----  -------------------
  -------------------------------
              38  B  08/29/2019 10:51:04
  /tmp/test/euc/???????2 08/28/2021 ????????:     cäcÍböl³nÈš€€€€€
  08/29/2019
  
  # dsmc query archive /tmp/test/euc/???????2             €€€€€€€€
  ANS1102E An excessive number of command line arguments are
  passed to the program.
  ANS1133W An expression might contain a wildcard not enclosed in
  quotes.
  
  # dsmc query archive "/tmp/test/euc/???????2"           €€€€€€€€
  ANS1102E An excessive number of command line arguments are
  passed to the program.
  ANS1133W An expression might contain a wildcard not enclosed in
  quotes.
  
  
  Output of 'dsmc retrieve /tmp/test/euc/???????2':       š€€€€€€€
  #?dsmc retrieve /tmp/test/euc/???????2                 €€€€€€€€€
  ANS1102E An excessive number of command line arguments are
  passed to the program.
  ANS1133W An expression might contain a wildcard not enclosed in
  quotes.
  
  
  Output of 'dsmc retrieve "/tmp/test/euc/???????2"':     ‚š€€€€€
  # dsmc retrieve "/tmp/test/euc/???????2"                €€€€€€€€
  ANS1102E An excessive number of command line arguments are
  passed to the program.
  ANS1133W An expression might contain a wildcard not enclosed in
  quotes.
  
  
  <Example 2>
  Output of command in dsmc prompt:
  
  # dsmc
  tsm> retrieve /tmp/test/euc/???????2                    €€€€€€€€
  ANS1102E An excessive number of command line arguments are
  passed to the program.
  ANS1133W An expression might contain a wildcard not enclosed in
  quotes.
  tsm>
  tsm> retrieve "/tmp/test/euc/???????2"                  €€€€€€€€
  Retrieve function invoked.
  
  ANS1302E No objects on server match query
  
  
  
  Tivoli Storage Manager and IBM Spectrum Protect versions
  affected:
  IBM Spectrum Protect client 7.1.X for Solaris
  
  
  Initial Impact: Middle
  Additional Keywords: dsmc restore retrieve Japanese euc utf8
  TS002583394
  

Local fix

• Please use dsmc with "-pick" option or dsm GUI to restore or
  retrieve.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Backup-Archive Client versions 7.1 and  *
  * 8.1 running on Solaris SPARC and Solaris x86 platforms.      *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * see ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is projected *
  * to be fixed in levels 7.1.8.8, 8.1.9.1 and 8.1.10. Note that *
  * this is subject to change at the discretion of IBM.          *
  ****************************************************************
  

Problem conclusion

• Command line interface operations which include arguments with
  Japanese characters will work without errors.
  

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:

Modules/Macros

• dsmc
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels