IC90559: ERROR MESSAGE IWNH1702E NEEDS TO BE UPDATED IN THE INFO CENTER TO INCLUDE RETURN CODE EXPLANATION.

Fix Pack 5.1.1.2 (September 2013) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.5 (July 2014) for Tivoli Storage Productivity Center
4.2.2 Fix Pack 7 (July 2014) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.6 (March 2015) for Tivoli Storage Productivity Center
4.2.2 Fix Pack 8 (March 2015) for Tivoli Storage Productivity Center
4.2.2 Fix Pack 9 (May 2015) for Tivoli Storage Productivity Center
4.2.2 Fix Pack 10 (August 2015) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.9 (October 2015) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.12 (October 2016) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.13 (February 2017) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.14 (June 2017) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.15 (Sept 2017) for Tivoli Storage Productivity Center
Fix Pack 5.1.1.8 (July 2015) for Tivoli Storage Productivity Center

APAR status

• Closed as documentation error.

Error description

• - Improve IWNH1702E message in TPC-R
  The following return codes need to be added to the message so
  that customers can easily debug the problem:
  
  
  
            <li><b>Return Code = -1</b> - Unsatisfied Link Error
  Occurred.  Possible causes include:
  WebSphere Application Server is in 64-bit addressing mode,
  insufficient permissions are defined for libANTKCCWP.so, there
  is an invalid version of libANTKCCWP.so, two or more instances
  of Tivoli
  Storage Productivity Center for Replication are running, or
  shared library libANTKCCWP.so is not configured correctly in
  WebSphere Application Server. Please contact your IBM service
  Representative.</li>
            <li><b>Return Code = -10</b> - A timeout
  occurred.</li>
            <li><b>Return Code = 904</b> - DFSMS SDM is not
  active.  Ensure that prerequisite levels
  of SDM are installed.</li>
            <li><b>Return Code = 912</b> - Insufficient RACF
  authority.  Either no facility class is
  defined or the facility class is defined but the user doesn't
  have access.
              To list this class, issue the command <q/>RLIST
  FACILITY ANT.ReplicationManager<q/>
              To add the appropriate permissions, commands similar
  to the following will need to be
  issued, filling in the correct USER_ID.
              <q/>RDEFINE FACILITY ANT.REPLICATIONMANAGER
  UACC(NONE)<q/>
              <q/>PERMIT ANT.ReplicationManager CLASS(FACILITY)
  ID(USER_ID) ACCESS(control)<q/>
              After these changes are completed, Tivoli Storage
  Productivity Center for Replication
  will need to be restarted.</li>
            <li><b>Return Code = 923</b> - Discovery failed due to
  no results returned.  Ensure that
  prerequisite levels of SDM and IOS are installed.</li>
            <li><b>Return Code = 900-999</b> - DFSMSsdm
  error.</li>
          </ul>
        </Explanation>
  these error codes are already documented on the server side
  messages under IWNR5400E - IWNR5405E, but should be added to the
  IWNH set of messages for easier access.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * TPC for Replication users                                    *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Need to improve the IWNH1702E messages for TPC for           *
  * Replication to include return codes.                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Reference updated Information Center when available.         *
  ****************************************************************
  

Problem conclusion

• The Information Center update for TPC 5.1.1.2 is expected to
  contain this information.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

  PM83856

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels