IT41169: QUERY REPLICATION MAY DISPLAY A FAILED STATUS EVEN THE REPLICATION STORAGE RULE COMPLETED SUCCESSFULLY

8.1.15.100-IBM-SPSRV-WindowsX64
8.1.15.100-IBM-SPSRV-Linuxx86_64
8.1.15.100-IBM-SPSRV-Linuxs390x
8.1.15.100-IBM-SPSRV-Linuxppc64le
8.1.15.100-IBM-SPSRV-AIX
8.1.16.000-IBM-SPCMS-WindowsX64
8.1.16.000-IBM-SPCMS-WindowsI32
8.1.16.000-IBM-SPCMS-Linuxx86_64
8.1.16.000-IBM-SPOC-WindowsX64
8.1.16.000-IBM-SPOC-Linuxx86_64
8.1.16.000-IBM-SPOC-Linuxs390x
8.1.16.000-IBM-SPOC-LinuxPPC64le
8.1.16.000-IBM-SPOC-AIX
8.1.16.000-IBM-SPSRV-WindowsX64
8.1.16.000-IBM-SPSRV-Linuxx86_64
8.1.16.000-IBM-SPSRV-Linuxs390x
8.1.16.000-IBM-SPSRV-Linuxppc64le
8.1.16.000-IBM-SPSRV-AIX

APAR status

• Closed as program error.

Error description

• On the IBM Spectrum Protect server, "Query Replication" may
  display a failed status for a node or node filespace pair even
  if the replication storage rule completed successfully.
  
  Bellow are steps how to determine if this APAR applies.
  Server trace with trace flags REPLSTATS REPLPROC REPLPHASE
  active during replication storage rule shows:
  ..[DoReplUpdatePhaseStats]:Phase 1691390334105 completed,
        chunksCompleted=7765, chunksFailed=0
  ..[nrCatalogTcrPhase]:Cataloging TCR phase.
        PhaseId=1691390334105, jobId=263, replSrvId=1
  ..[UpdateReplHistRecord]:Enter: Updating history record for
        nodeId=15, fsId=1, copytype=1
  ..[UpdateReplHistRecord]:Failed repl: 4257078868 of 4601281090
        bytes, 553 of 578 files replicated
    --> the above 2 lines report a failed replication for
        nodeId=15, fsId=1, copytype=1
  ..[UpdateReplHistRecord]:Exit: rc 0
  ..[nrCatalogTcrPhase]:Exit: rc=0
  ...
  ..[DoReplUpdatePhaseStats]:Phase 1691390334115 completed,
        chunksCompleted=435, chunksFailed=0
  ..[nrCatalogTcrPhase]:Cataloging TCR phase.
        PhaseId=1691390334115, jobId=263, replSrvId=1
  ..[UpdateReplHistRecord]:Enter: Updating history record for
        nodeId=15, fsId=1, copytype=1
  ..[UpdateReplHistRecord]:Exit: rc 0
     --> this line reports the last replication for the same
         nodeId=15, fsId=1, copytype=1 was successful
  ..[nrCatalogTcrPhase]:Exit: rc=0
  
  If UpdateReplHistRecord will show failed replication for certain
  phases for the (node, filespace, copytype) during replication
  processing but not the for the last one then this APAR will
  apply.
  
  IBM Spectrum Protect Versions Affected:
  IBM Spectrum Protect Server 8.1.13 and higher on all supported
  platforms
  
  Additional Keywords:
  Spectrum Protect; replication; stgrule; failed; q replication;
  TSM; TS008696318
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All IBM Spectrum Protect server users of replication storage *
  * rules.                                                       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See error description.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in levels 8.1.15.100 and 8.1.16. 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.
  

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