IBM Support

IT38157: RETENTION SET COPY JOB TERMINATED BY SYSTEM AFTER TWO INCOMPLETE RETRIES.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A retention copy job will be automatically set to TERMINATED
    status if the second attempt to resume the job results in an
    INCOMPLETE state for the job.
    
    Messages are seen in the server activity log when the job is set
    to terminated by the system, for example:
      ANR0985I Process # for COPY RETENTION SET (SUMMARY)
    
       running in the BACKGROUND completed with completion
    
       state INCOMPLETE at hh:mm:ss. (SESSION: ####, PROCESS: ###,
    JOB: ###)
    
    
    
      ANR3852I Retention set with ID XX for rule
    
       <RULE_NAME>  is copied to tape storage with state Incomplete.
    
    
       The following results are available: total number of
    
       retention set files: XX, number of copied files:
    
       YY, number of files that failed to copy: ZZ.
    
       (SESSION: ###, PROCESS: ###, JOB: ###)
    
      ANR4161E Job ### terminated by SYSTEM. (SESSION: ###, PROCESS:
    ###, JOB: ###)
    
    
    A query of the job with "QUERY JOB <id>" shows the status as
    terminated.
    
    A server trace shows the copy job can only be restarted twice
    before it is automatically set to terminated status:
    [imret.c][6961][imUpdateRetsetCopyRetry]:Current retry time is
    2, already reach the max retry times, cannot be retried.
    .
    [admjob.c][1332][TraceMsg]:ANR4161E Job ### terminated by
    SYSTEM.~
    
    The error that has lead to the job finishing as incomplete is
    not relevant, the job will be set to terminated after the second
    incomplete retry.
    
    Jobs that are interrupted by a server administrator (INTERRUPT
    JOB command) are not affected by this issue.
    
    This APAR will alter the observed behaviour, the incomplete job
    will be no longer terminated by the system.
    
    Termination of the job (TERMINATE JOB command) will be left to
    the discretion of the server administrator.
    

Local fix

  • Recreate the terminated retention set.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All IBM Spectrum Protect server users.                       *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See ERROR DESCRIPTION.                                       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Apply fixing level when available. This problem is currently *
    * projected to be fixed in level 8.1.13. 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 number

    IT38157

  • Reported component name

    TSM SERVER

  • Reported component ID

    5698ISMSV

  • Reported release

    81L

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-08-25

  • Closed date

    2021-09-24

  • Last modified date

    2021-09-24

  • 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

  • R81A PSY

       UP

  • R81L PSY

       UP

  • R81W PSY

       UP

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"81L","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
17 December 2021