IT18838: "REPLICATE NODE" COMMAND WITH PREVIEW=YES OPTION DOES NOT GENERATE ANY PROCESS

8.1.2.000-IBM-SPSRV-AIX
8.1.2.000-IBM-SPSRV-Linuxppc64le
8.1.2.000-IBM-SPCMS-Linuxx86_64
8.1.2.000-IBM-SPCMS-WindowsI32
8.1.2.000-IBM-SPSRV-Linuxs390x
8.1.2.000-IBM-SPCMS-WindowsX64
8.1.2.000-IBM-SPSRV-Linuxx86_64
8.1.2.000-IBM-SPSRV-WindowsX64
8.1.2.000-IBM-SPOC-AIX
8.1.2.000-IBM-SPOC-LinuxPPC64le
8.1.2.000-IBM-SPOC-Linuxs390x
8.1.2.000-IBM-SPOC-Linuxx86_64
8.1.2.000-IBM-SPOC-WindowsX64
IBM Spectrum Protect Server V8.1 Fix Pack 2 (V8.1.2) Downloads
IBM Spectrum Protect Server V7.1 Fix Pack 8 (7.1.8.000) Downloads

APAR status

• Closed as program error.

Error description

• A REPLICATE NODE command done with the PREVIEW=YES option does
  not generate any process and it is difficult to track its result
   in the activity log.
  
  
  Customer/L2 Diagnostics:
  
  For example, if there is no damage in the stgpool for the node,
  and the command below is started:
  
    REPLICATE NODE NODEXXX   RECOVERDAMAGED=ONLY PREVIEW=YES
  
  No process number is reported as the activity log only shows
  this:
  
      ANR2017I Administrator ADMIN issued command: REPLICATE NODE
  NODEXXX RECOVERDAMAGED=ONLY PREVIEW=YES
  
  As there is nothing to recover, no other messages are reported.
  There is no easy way to know if or when this command completed..
  
  
  If the same is done while there are damages, the activity log
  shows:
  
  ANR2017I Administrator ADMIN issued command: REPLICATE NODE
   NODEXXX RECOVERDAMAGED=only preview=yes
  ANR0408I Session 112057 started for server TSMSRV (AIX) (Tcp/Ip)
   for replication.
  ANR0409I Session 112057 ended for server TSMSRV (AIX).
  ANR4029I A scan to identify damaged files is in progress. If
   damaged files are detected, a recovery process will begin after
   the scan is completed.
  ANR0408I Session 112058 started for server TSMSRV (AIX) (Tcp/Ip)
   for replication.
  ANR3649I A scan to identify damaged files was initiated at
   10:22:11.
  ANR4028I A scan for damaged files is in progress. Processed 1
   damaged file(s).
  ANR3650I A scan to identify damaged files was completed at
   10:22:12.
  ANR4910I A replication recovery preview was completed for the
   following nodes: NODEXXX. Nodes to be recovered: 1. Filespaces
   to be recovered: 1. Files to be recovered: 24. Bytes to be
   recovered: 24,600 KB. Estimated run time: 0 Days, 0 Hours, 1
   Minutes.
  ANR0409I Session 112058 ended for server TSMSRV (AIX).
  
  That is easier to track but still not process number.
  
  Tivoli Storage Manager Versions Affected:
   All Server platforms at level 6.3 ,  7.1 or 8.1
  
  
  Initial Impact: Low
  
  Additional Keywords:   TSM IBM Spectrum Protect preview
  

Local fix

• Use the WAIT=YES option to better track the end of the REPLICATE
   NODE / PREVIEW command
  

Problem summary

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

Problem conclusion

• This problem was fixed.
  Affected platforms for reported release:  AIX, HP-UX, Solaris,
  Linux, and Windows.
  Platforms fixed:  AIX, HP-UX, Solaris, Linux, and Windows.
  

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