IT47980: REPLICATION FAILS WITH ANR3178E AND ANR0479W WHEN A COPY GROUP IS MISSING

APAR status

• Closed as program error.

Error description

• When replicating a node to an IBM Storage Protect server with a
  missing copy group, the source reports a communication error,
  while the target server ends the connection without any errors
  reported. This happens during regular replications or storage
  rule replications, for both archive and backup copy groups, as
  long as each type of data is being replicated.
  
  On the source's actlog, these messages are reported:
  ANR3178E A communication error occurred during session XXXX with
  replication server TARGET.
  ANR0479W Session XXXX for server TARGET (OS) terminated -
  connection with server severed.
  
  At the same time, this message is reported on the target's
  actlog:
  ANR0409I Session XXXX ended for server SOURCE.
  
  Simultaneously, these messages may also be generated on the
  dsmffdc of both servers:
  (tcpcomm.c:XXXX)(SESSION: XXXX) write error on sock XXXX, errno
  32
  (tlsio.c:XXXX)(SESSION: XXXX) gsk_secure_soc_write error: sessId
  XXXX, rc 406 GSK_ERROR_IO
  
  Besides that, the "query replfailure" output will report the RCs
  1062, 2339, and 3014.
  
  Even though the target server is expected to end the connection
  after detecting the issue in the copy groups, thus generating
  all the messages above, it should also indicate the problem with
  the copy groups.
  
  To determine if this APAR applies, collect a trace with the
  "REPL" class on the target server and look for these messages:
  [xirepl.c][4451][xiParseObjRec]:Archive/Backup copygroup for
  mcId X in domain X not found. Using default MC/CG
  [xirepl.c][4843][xiParseObjRec]:exit, rc=1120
  [smrepl.c][16577][DoObjInfo]:Error 1120 parsing attrs for remote
  objId XXXXXX
  
  If the replication was executed before, it's also possible to
  determine if the APAR applies in the "validate replpolicy"
  output, which reports:
  Change detected
  ----------------------------------------
  Archive/Backup copygroup only on source
  
  Additional Keywords:
  TS018436059, SP, STORAGE PROTECT, STORAGE RULE REPLICATION,
  REPLICATE NODE, POLICY, 406 GSK_ERROR_IO, WRITE ERROR ON SOCK,
  ERRNO 32
  
  Versions Affected:
  IBM Storage Protect Server 8.1.x on all supported platforms
  

Local fix

• Manually create the missing copy group on the target server:
  DEFINE COPYGROUP [DomainName] [PolicyName] [ClassName] ...
  
  Or, export the domain from the source to the target server:
  EXPORT POLICY [DomainName] TOSERVER=[TargetServerName]
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All IBM Storage 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.27.100 and 8.2.0. Note   *
  * that this is subject to change at the discretion of IBM.     *
  ****************************************************************
  

Problem conclusion

• This problem was fixed.
  Platforms fixed:  AIX, Linux, and Windows.
  
  NOTE:  There is an undocumented option to skip the checking that
  is taking place which should not be enabled if using
  bi-directional virtual volumes.  In addition, the usage of
  virtual volumes for storage pools usage is likely to be
  deprecated in the future.  If this undocumented option is
  required then open a case with the support team.
  

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