IT31771: "INVALID CATEGORY END CALL" COMPLETION STATUS IN DSMINSTR.LOG IF A COMMUNICATION PROBLEM HAPPENS DURING BACKUP OR ARCHIVE

APAR status

• Closed as program error.

Error description

• At the end of a successful backup or archive, the
  instrumentation report is generated in the dsminstr.log file but
   will not display the expected information if communication
  problems or any timeout happens during the backup or archive.
  
  The dsminstr.log will display this completion status message:
  
  "Invalid category end call"
  
  The connection problem may or may not appear clearly externally,
  in the backup or archive process output or in client or server
  logs.
  If a client trace flag "service" is activated a message ANS1005E
  might be seen.
  
  
    Spectrum Protect Versions Affected: All V7.1 and V8.1 versions
             on all supported platforms.
  
    Customer/Support Diagnostics (If Applicable):
  
  Example in the dsminstr.log:
  ----------------------------------------------------------------
  PROCESS[6856] TSM Client final instrumentation statistics: Sun
  Dec  1 08:06:11 2019
  
  Instrumentation class: Client detail
  Completion status: Invalid category end call
  ----------------------------------------------------------------
  No instrumented activity reported for thread 9200
  ----------------------------------------------------------------
  No instrumented activity reported for thread 9200
  ---------------------------------------------------------------
  No instrumented class associated with thread 53884
  No instrumented class associated with thread 48516
  No instrumented class associated with thread 8828
     ...
  A client "service" trace from a Windows client might display:
   ANS1005I TCP/IP read error on socket = xxx, errno = 10054,
   reason : 'An existing connection was forcibly closed by the
   remote host'
  
  Initial Impact: Low
  
  Additional Keywords: TS002828195 TSM performance intrument
  report network time out
  

Local fix

• . If a timeout appears, increase the IDLETIMEOUT and COMMTIMEOUT
     Spectrum Protect server options values.
  . Check and correct any potential communication problem.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Backup-archive client versions 7.1 and 8.1 running on all    *
  * platforms.                                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Backup-Archive    *
  * Client version 8.1.10 on all platforms.                      *
  * Note that this is subject to change at the discretion of     *
  * IBM.                                                         *
  ****************************************************************
  

Problem conclusion

• The problem described in this APAR has been fixed so that it no
  longer occurs.
  

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:

Modules/Macros

• dsmc
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels