IT35696: SCHEDULED JOB SHOWS ANS4042E ERROR ON LINUX BECAUSE THE LANG & LC_ALL VARIABLES ARE NOT SET IN THE DSMCAD.SERVICE FILE

APAR status

• Closed as program error.

Error description

• The LANG and LC_ALL variables which are recommended in the
  manual page below, are not set by default in the provided
  dsmcad.service startup file.
  
   https://www.ibm.com/support/knowl
  edgecenter/SSEQVQ_8.1.11/client/c_cfg_nlsupportunix.html
  
  During a scheduled backup if some special characters are found
  this might trigger the following message in the client
  dsmerror.log:
  
   ANS4042E Object name 'xxxx' contains one or more unrecognized
  characters and is not valid.
  
  The dsmcad.service should be adjusted and have these variables
  set.
  
  IBM Spectrum Protect Versions Affected: V7.1 or V8.1 on all
        supported Linux client platforms
  
  Initial Impact: Low
  
  Additional Keywords:
     TS004723525 TSM systemctl systemd scheduler
  

Local fix

• The lines below may be added to the startup script file
   /opt/tivoli/tsm/client/ba/bin/dsmcad.service:
  
  
    Environment="LANG=en_US"
    Environment="LC_ALL=en_US"
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Backup-archive client version 8.1.10, 8.1.11 running on all  *
  * Linux platforms.                                             *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in level 8.1.12. Note that this is     *
  * subject to change at the discretion of IBM.                  *
  ****************************************************************
  

Problem conclusion

• systemd startup script for dsmcad module was relying on system
  language settings, inheriting the default locale.
  In case the system variables are set to a UTF-8 locale, dsmcad
  can not backup files with multi-byte symbols in their names.
  The systemd startup script was changed so single-byte locale is
  set explicitly and all files can be backuped.
  

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

• dsmcad
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels