Tivoli Storage Manager fails BMR0001E and BMR0030E rc = 610 Unable to open message text file

Technote (troubleshooting)


Problem(Abstract)

SysBack Tivoli Storage Manager operations such as backup, adding a Tivoli Storage Manager virtual device, and readsbheader for SysBack backups to Tivoli Storage Manager fail with rc = 610 Unable to open message text file.

Symptom

BMR0001E An error occurred initializing the environment: rc = 610, Unable to open message text file.

BMR0030E sbtsm.c(400): Error from Tivoli Storage Manager API during QueryCliOptions call: rc = 610, Unable to open message text file.


Cause

Tivoli Storage Manager API rc = 610 is: DSM_RC_NLS_CANT_OPEN_TXT
Explanation: The system is unable to open the message txt file dsmclientV3.cat for AIX.
User response: Verify that the dsmclientV3.cat file has a symbolic link to /usr/lib/nls/msg/<locale>/dsmclientV3.cat .

For SysBack Tivoli Storage Manager operations, this is symptomatic of setting the DSMI_DIR environmental variable.

Resolving the problem

Check DSMI environmental variables with:


    # set | grep DSMI

Sample results:
    DSMI_DIR=/tmp/nodir
    DSMI_LOG=/usr/tivoli/tsm/client/api/bin

The manual says that the only supported Tivoli Storage Manager environmental variables are DSMI_CONFIG, and DSMI_LOG, SysBack will ignore DSMI_DIR.

However, unsetting the DSMI_DIR environmental variable resolves the errors.

To unset the DSMI_DIR environmental variable run:


    # export DSMI_DIR=''

With 'single quotes' after the equals (=) sign.

Retry the failing SysBack Tivoli Storage Manager command.

References:

Tivoli Storage Manager API 5.5 manual: Appendix A. API return codes with explanations
http://publib.boulder.ibm.com/infocenter/tivihelp/v1r1/topic/com.ibm.itsmfdt.doc/b_api130.htm?path=1_0_10#rc

SysBack 6.1 manual: Set Tivoli Storage Manager Environment Variables for Use by SysBack
http://publib.boulder.ibm.com/infocenter/tivihelp/v1r1/topic/com.ibm.itsmsbr.doc/sbrug610174.htm?path=18_0_19_1_3#wq450

Rate this page:

(0 users)Average rating

Document information


More support for:

Tivoli Storage Manager for System Backup and Recovery

Software version:

6.1.2.0, 6.1.3.0

Operating system(s):

AIX

Software edition:

Edition Independent

Reference #:

1577266

Modified date:

2013-12-02

Translate my page

Machine Translation

Content navigation