IC90620: WAY OF SETTING VARIABLES IN USERPROFILE SHOULD BE MODIFIED TO FIT ALSO FOR BOURNE SHELL

APAR status

• Closed as documentation error.

Error description

• When starting Tivoli Storage Manager server process with
  rc.dsmserv script,
  it also runs sqllib/userprofile script to set variables for db
  backup.
  However, because the description in Installation Guide does not
  fit for Bourne shell,?setting variables according to the manual%
  may lead it to failure.
  Description should be modified to fit also for Bourne shell.
  The installation guide is missing the  db2cshrc script for C
  shell and it should also be described.
  
  Tivoli Storage Manager for Sun Solaris Version 6.1 Installation
  Guide
  Chapter 3. Taking the first steps after you install Tivoli
  Storage Manager Version 6.1
  P.27 Preparing the database manager for backup step 1.
  -------------------------
  c. Add or update the following lines to the userprofile file in
  the /home/tsminst1/sqllib directory:
  export DSMI_CONFIG=/home/tsminst1/tsminst1/tsmdbmgr.opt
  export DSMI_DIR=/opt/tivoli/tsm/client/api/bin64
  export DSMI_LOG=/home/tsminst1/tsminst1
  -------------------------
  
  
  Tivoli Storage Manager Versions Affected: 6.X versions for all
  UNIX/Linux environment.
  
  
  Customer/L2 Diagnostics (If Applicable)
  When setting variables in userproflie according to the current
  manual description,
  the following error may occur while trying to start TSM server
  process with rc.dsmserv:
  -------------------------
  # /opt/tivoli/tsm/server/bin/rc.dsmserv -u  tsminst1 -i
  /export/home/tsminst1
  /opt/tivoli/tsm/server/bin/rc.dsmserv:
  DSMI_CONFIG=/export/home/tsminst1/tsmdbmgr.opt: is not an
  identifier
  -------------------------
  
  
  Initial Impact: Low
  
  
  Additional Keywords: zz61 zz62 zz63 userprofile export
  

Local fix

• Modify the way of setting variables of DSMI_CONFIG, DSMI_DIR and
   DSMI_LOG as follows:
  -------------------------
  DSMI_CONFIG=/home/tsminst1/tsminst1/tsmdbmgr.opt
  export DSMI_CONFIG
  DSMI_DIR=/opt/tivoli/tsm/client/api/bin64
  export DSMI_DIR
  DSMI_LOG=/home/tsminst1/tsminst1
  export DSMI_LOG
  -------------------------
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Tivoli Storage Manager users.            *
  ****************************************************************
  * PROBLEM DESCRIPTION: See error description.                  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The "Preparing the database manager for backup" topic in the
  Installation Guide now includes the Bourne shell information
  for AIX, HP-UX, Linux, and Solaris. The entries appear like
  this:
  
  AIX (Korn or Bash shell)
  export DSMI_CONFIG=/home/tsminst1/tsminst1/tsmdbmgr.opt
  export DSMI_DIR=/usr/tivoli/tsm/client/api/bin64
  export DSMI_LOG=/home/tsminst1/tsminst1
  
  HP-UX, Linux, Solaris  (Korn or Bash shell)
  export DSMI_CONFIG=/home/tsminst1/tsminst1/tsmdbmgr.opt
  export DSMI_DIR=/opt/tivoli/tsm/client/api/bin64
  export DSMI_LOG=/home/tsminst1/tsminst1
  
  AIX (Bourne shell)
  DSMI_CONFIG=/home/tsminst1/tsminst1/tsmdbmgr.opt
  DSMI_DIR=/usr/tivoli/tsm/client/api/bin64
  DSMI_LOG=/home/tsminst1/tsminst1
  export DSMI_CONFIG DSMI_DIR DSMI_LOG
  
  HP-UX, Linux, Solaris (Bourne shell)
  DSMI_CONFIG=/home/tsminst1/tsminst1/tsmdbmgr.opt
  DSMI_DIR=/opt/tivoli/tsm/client/api/bin64
  DSMI_LOG=/home/tsminst1/tsminst1
  export DSMI_CONFIG DSMI_DIR DSMI_LOG
  
  AIX (C shell)
  setenv DSMI_CONFIG=/home/tsminst1/tsminst1/tsmdbmgr.opt
  setenv DSMI_DIR=/usr/tivoli/tsm/client/api/bin64
  setenv DSMI_LOG=/home/tsminst1/tsminst1
  
  HP-UX, Linux, Solaris (C shell)
  setenv DSMI_CONFIG=/home/tsminst1/tsminst1/tsmdbmgr.opt
  setenv DSMI_DIR=/opt/tivoli/tsm/client/api/bin64
  setenv DSMI_LOG=/home/tsminst1/tsminst1
  

Problem conclusion

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:

Fix information

Applicable component levels