24. KBNIX0003 - "ANS4042E Object name ... contains one or more unrecognized characters and is not valid."

Summary If you wish to back up files with names containing special characters such as symbols and diacritical marks, but are failing to do so, you need to ensure the backup is run with appropriate localization settings. To make sure every file is backed up we recommend the use of the "en_US" language setting. With other settings such as C, POSIX, or UTF-8, some special characters will be skipped.
Symptom When backing up, you see one or more instances of the error message 'ANS4042E Object name ... contains one or more unrecognized characters and is not valid.' Scheduled backups nonetheless complete, but not all files get backed up.
Cause The en_US locale is not installed on the problem machine.
Resolution
  • Check the en_US locale (en_US.UTF-8 is insufficent) is installed on your machine with: 
    locale -a |grep en_US
    On some Ubuntu machines this locale is not installed by default and can be added with: 
    sudo locale-gen en_US
    On other distributions you may need to install aditional language filesets, most likely related to ISO8859-1 or ISO8859-15.
  • As the root user, please edit the files dsmc, dsmcad and dsmj located in /usr/bin, by adding the following lines immediately above the final 'exec' command: 
    export LANG=en_US
    export LC_ALL=en_US
  • If you are running TSM 5.5 or below then you need to restart dsmcad. To do this please run the following command as root: 
    /etc/init.d/dsmcad restart
  • If you are running TSM 6.1 or above then instead you need to restart the TSM scheduler. To do this please run the following commands as root: 
    /opt/tivoli/tsm/client/ba/bin/HFSscheduler off
/opt/tivoli/tsm/client/ba/bin/HFSscheduler on
  • After the next backup, check your dsmsched.log and dsmerror.log files, located in /var/log, for failures. If failures persist after making the changes described above, please send a copy of the following files to hfs@ox.ac.uk: dsmsched.log, dsmerror.log, dsmc, dsmcad, and dsmj. In addition please send the output of the 'locale' command, run as the root user.
Status
More Information
Applies To TSM, Linux

Up: Contents Previous: 23. KBNIX0002 - "ANS1501E Trusted agent execution/owner permissions are invalid". Next: 25. KBNIX0004 - "ANS5179E TSM is unable to continue. Exiting program."