IT29878: "DSMSERV RESTORE DB" MAY FAIL WITH "ANR2022E DEFINE SERVER: ONE OR MORE PARAMETERS ARE MISSING" IF SPOKE SERVERS ARE IN PLACE

8.1.8.100-IBM-SPSRV-AIX
8.1.8.100-IBM-SPSRV-Linuxppc64le
8.1.8.100-IBM-SPSRV-Linuxs390x
8.1.8.100-IBM-SPSRV-Linuxx86_64
8.1.8.100-IBM-SPSRV-WindowsX64
8.1.8.100-IBM-SPCMS-Linuxx86_64
8.1.8.100-IBM-SPOC-AIX
8.1.8.100-IBM-SPCMS-WindowsI32
8.1.8.100-IBM-SPOC-LinuxPPC64le
8.1.8.100-IBM-SPCMS-WindowsX64
8.1.8.100-IBM-SPOC-Linuxs390x
8.1.8.100-IBM-SPOC-Linuxx86_64
8.1.8.100-IBM-SPOC-WindowsX64
8.1.9.000-IBM-SPOC-AIX
8.1.9.000-IBM-SPSRV-AIX
8.1.9.000-IBM-SPOC-LinuxPPC64le
8.1.9.000-IBM-SPOC-Linuxs390x
8.1.9.000-IBM-SPSRV-Linuxppc64le
8.1.9.000-IBM-SPCMS-Linuxx86_64
8.1.9.000-IBM-SPOC-Linuxx86_64
8.1.9.000-IBM-SPCMS-WindowsI32
8.1.9.000-IBM-SPSRV-Linuxs390x
8.1.9.000-IBM-SPCMS-WindowsX64
8.1.9.000-IBM-SPOC-WindowsX64
8.1.9.000-IBM-SPSRV-Linuxx86_64
8.1.9.000-IBM-SPSRV-WindowsX64
IBM Spectrum Protect Server V8.1.8.X interim fix downloads
IBM Spectrum Protect Server V8.1 Fix Pack 8 (V8.1.9) Downloads

APAR status

• Closed as program error.

Error description

• On the HUB server, after the definition of one or more SPOKE
  servers via Operations Center (OC), a DSMSERV RESTORE DB may
  fail as follows:
  
  ANR2022E  DEFINE SERVER: One or more parameters are missing.
  ANR0902W Unsupported keyword or invalid value found in file
  /home/devcnfg.out.
  ANR0906I   Line No. : 4
  ANR0907I  Statement : DEFINE SERVER SPOKE COMMMETHOD=TCPIP
  HLADDRESS=10.1.2.3 LLADDRESS=1509
  
  ANR3239E  Error 2800 while creating device class DEVC1.
  
  ANR4592I  Restore database backup series 21 includes eligible
  operation 0 with volume /home/SERVER1/stg/stgpool/123456789.DBV
  having sequence 100002 and using device class DEVC1.
  
  ANR4602E No volumes found for TODATE 05/21/2019 01:49:27 PM.
  
  ANR2032E RESTORE DB: Command failed - internal server error
  detected.
  
  ANR9999D Thread<1> issued message 2032 from: ANR9999D Thread<1>
  0x125c9a4 ./dsmserv_SERVER1(outMsgfTrFL+0x94)
  
  
  
  
  Customer/L2 Diagnostics:
  The DEFINE SERVER command in the DEVCONFIG is incorrectly
  formed, leading to the failure.
  
  
  
  
  IBM Spectrum Protect versions affected:
  Server versions 8.1.7 and 8.1.8 on supported platforms
  
  
  
  
  
  Initial Impact:
  Medium
  
  
  
  
  Additional Keywords:
  TSM "Spectrum Protect" TS002301485 "restore db" ANR3239E  "Error
  2800" ANR2032E
  

Local fix

• The local workaround is to define a password for the server on
  which the database backup resides using the SET SERVERPASSWORD
  command AND then adding the PASSWORD= parameter for that server
  in the devconfig of the server whose database is to be restored.
  It should be noted that the remote (server) system may need to
  be modified with
  SET SERVERPASSWORD password
  if one has not already been set.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All IBM Spectrum Protect server users.                       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See error description.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in levels 8.1.7.100, 8.1.8.100, and    *
  * 8.1.9. Note that this is subject to change at the discretion *
  * of IBM.                                                      *
  ****************************************************************
  

Problem conclusion

• This problem was fixed.
  Affected platforms for reported release:  AIX, Linux, and
  Windows.
  Platforms fixed:  AIX, Linux, and Windows.
  Note: A fixing level must be installed on both Library Clients
  and Library Servers.
  In Addition, if a new data base backup is not made after
  installing a Library Client fixing level,
  the BACKUP DEVCONFIG command must be run to update the device
  configuration
  (devconfig) file.
  

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

• Fixed component name

  TSM SERVER

• Fixed component ID

  5698ISMSV

Applicable component levels