IT33798: IBM SPECTRUM PROTECT FOR SPACE MANAGEMENT CLIENT DOES NOT HONOR HSMLOGNAME OPTION WHEN USING DSM.SYS WITH MULTI SERVER STANZAS

APAR status

• Closed as program error.

Error description

• The IBM Spectrum Protect for Storage Management client does not
  honor settings for the option HSMLOGNAME for each Spectrum
  Protect Server SERVERNAME stanza in dsm.sys. Instead the value
  for this variable is taken from the first SERVERNAME
  stanza.
  
  For example, the option file
  /opt/tivoli/tsm/client/ba/bin/dsm.sys is configured as
  follows:
  
  MIGRateserver SERVER_A
  
  SERVERNAME SERVER_A
   TCPPORT 1500
   TCPSERVERADDRESS X.X.X.X
   PASSWORDACCESS GENERATE
   COMMMETHOD TCPip
   NODENAME NODE_A
   HSMLOGEVENTFLAGS FILE
   HSMLOGNAME
  "/opt/tivoli/tsm/client/ba/bin/hsmactivity.log.server _A"
  
  SERVERNAME SERVER_B
   TCPPORT 1500
   TCPSERVERADDRESS X.X.X.X
   PASSWORDACCESS GENERATE
   COMMMETHOD TCPip
   NODENAME NODE_B
   HSMLOGEVENTFLAGS FILE
   HSMLOGNAME
  "/opt/tivoli/tsm/client/ba/bin/hsmactivity.log.server_B"
  
  Display the migration state of a migrated object using the
  servername 'SERVER_B':
  
  /opt/tivoli/tsm/client/hsm/bin # dsmls -extobjid
  /SMSVT/mmfs1/hsm/tf_SERVER_B_0 -se=SERVER_B
  IBM Spectrum
  Protect
  Command Line Space Management Client Interface
   Client
  Version 8, Release 1, Level 9.1
   Client date/time: 06/17/20
  10:01:35
  (c) Copyright by IBM Corporation and other(s) 1990,
  2020. All Rights Reserved.
  
  0101020C0000000014AC400C90D150780102
  BD24B3C02B3DF9C8612B (v) p
  /SMSVT/mmfs1/hsm/tf_SERVER_B_0
  
  /opt/tivoli/tsm/client/hsm/bin
  # dsmls /SMSVT/mmfs1/hsm/tf_SERVER_B_0
  IBM Spectrum
  Protect
  Command Line Space Management Client Interface
   Client
  Version 8, Release 1, Level 9.1
   Client date/time: 06/17/20
  10:06:11
  (c) Copyright by IBM Corporation and other(s) 1990,
  2020. All Rights Reserved.
  
   ActS ResS ResB FSt Srv   FName
  
  1048576 1048576 1024 p SERVER_B tf_SERVER_B_0
  
  Looking in the log file for the identifier generated for NODE_B
  in the log of NODE_A
  '0101020C0000000014AC400C90D150780102BD24B3C02B3DF9C8612B', we
  can see:
  
  /opt/tivoli/tsm/client/hsm/bin# cat
  /opt/tivoli/tsm/client/ba/bin/hsmactivity.log.server_A
  06/17/20
  09:43:33 File transparent recall begin node: NODE_B pid: 23197
  handle: AC140C405DC016A4-000000000000BA32-0000000000000000-7A9EC
  9C200000000 extobjid:
  0101020C00000000-14AC400C90D15078-0102BD24B3C02B3D-F9C8612B
  
  06/17/20 09:43:33 File transparent recall end node: NODE_B pid:
  23197 handle: AC140C405DC016A4-000000000000BA32-0000000000000000
  -7A9EC9C200000000 bytes: 1048576
  
  We see unexpected entries generated for NODE_B in the log of
  NODE_A.
  
  
  IBM Spectrum Protect Versions Affected:
  IBM Spectrum Protect for Space Management 8.1.x and 7.1.x on
  Linux and AIX platforms
  
  
  Initial Impact:
  Low
  
  
  Additional Keywords:
  IBM Spectrum Protect; HSM; TS003329446; server stanza;
  HSMLOGNAME
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect for Space Management client versions    *
  * 7.1 and 8.1 on Linux and AIX platforms.                      *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * see ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is projected *
  * to be fixed in level 8.1.11. Note that this is subject to    *
  * change at the discretion of IBM.                             *
  ****************************************************************
  *
  

Problem conclusion

• Transparent recall actions will be reported in the file which is
  specified by HSMLOGNAME
  

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

• dsmrecal
  

Fix information

• Fixed component name

  TSM SPACE MGMT

• Fixed component ID

  5698HSMCL

Applicable component levels