IBM Support

ANS4042E Unrecognized characters during backup of data from Linux clients

Troubleshooting


Problem

Unable to backup data containing foreign characters. ANS4042E Unrecognized characters in object name when backing up data from Linux Tivoli Storage Manager client machines.

Symptom

ANS4042E Object name 'xxxx' contains one or more unrecognized characters and is not valid.

Cause

Performing Manual backups:
If manual backups generate the ANS4042E error, the user’s locale environment settings are not able to handle foreign characters.

Performing Scheduled backups (using scheduler service or dsmcad service)
The scheduler and dsmcad services started from the inittab may not have the proper locale environmental settings regardless of the user’s locale settings.

Resolving The Problem

Correcting the problem above requires changing the locale settings for the operating system.

1. To check the current locale settings, please run the following script. The shell script exp.sh can be started via /etc/inittab to give the locale settings at start time of the Linux system. The contents of the shell script:
---------------
#! /bin/sh
exec 1>/root/exp.out 2>>/root/exp.out
export
locale
--------------

2a. If performing manual backups, change the variables LANG and LC_CTYPE to en_US:
export LANG=en_US
export LC_CTYPE=en_US

2b. If performing scheduled backups and if the scheduler is being started from the inittab a script must be used to change the locale settings.

Script for the scheduler:
Example for an /etc/inittab entry:
tsm2:345:once:/opt/tivoli/tsm/client/ba/bin/start_dsmcsched.sh > /tmp/dsmcsched.txt 2>&1

Example for the script "start_dsmcsched.sh":
#!/bin/sh
DSM_CONFIG=/opt/tivoli/tsm/client/ba/bin/dsm.opt
DSM_DIR=/opt/tivoli/tsm/client/ba/bin/
DSM_LOG=/opt/tivoli/tsm/client/ba/bin/
LANG=en_US
LC_ALL=en_US
export DSM_CONFIG DSM_DIR DSM_LOG LANG LC_ALL
cd /opt/tivoli/tsm/client/ba/bin
dsmc sched & > /tmp/schedok.txt 2> /tmp/schederr.txt

2c. If performing scheduled backups using dsmcad and if the dsmcad is being started from the inittab a script must be used to change the locale settings.

Script for the dsmcad:
Example for an /etc/inittab entry:
tsm1:345:once:/opt/tivoli/tsm/client/ba/bin/start_dsmcad.sh > /tmp/dsmcad.txt 2>&1

Example for the script "start_dsmcad.sh":
#!/bin/sh
DSM_CONFIG=/opt/tivoli/tsm/client/ba/bin/dsm.opt
DSM_DIR=/opt/tivoli/tsm/client/ba/bin/
DSM_LOG=/opt/tivoli/tsm/client/ba/bin/
LANG=en_US
LC_ALL=en_US
export DSM_CONFIG DSM_DIR DSM_LOG LANG LC_ALL
cd /opt/tivoli/tsm/client/ba/bin
dsmcad & > /tmp/cadok.txt 2> /tmp/caderr.txt

[{"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Client","Platform":[{"code":"PF016","label":"Linux"}],"Version":"All Supported Versions","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}}]

Product Synonym

TSM

Document Information

Modified date:
17 June 2018

UID

swg21290640