IBM Support

VM66470: MSFCXUSL317A NOT CREATED AFTER 32768 MINUTES

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • An accumulator overflows causing Performance Toolkit to stop
    producing MSFCXUSL317A when a USRLIMIT threshold is exceeded.
    If a USRLIMIT threshold is continuously exceeded for more than
    32768 minutes, the halfword accumulator that contains the number
    of minutes overflows and message FCXUSL317A is no longer
    produced.
    

Local fix

  • N/A
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: User of Performance Toolkit for VM that      *
    *                 establish thresholds via the 'FCONTROL       *
    *                 USRLIMIT' command.                           *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    ****************************************************************
    * RECOMMENDATION: APPLY PTF                                    *
    ****************************************************************
    The problem occurred in Performance Toolkit when a user
    continually exceeds an established threshold for over 32768
    minutes.
    
    The storage location that is used to accumulate the total number
    of minutes the threshold has been exceeded is defined as a
    halfword.  The accumulation was handled via signed logic, so
    when the halfword value 32768 (X'8000') is loaded into a
    register, the resulting value is a large negative value.  When a
    comparison is done to determine if the accumulated value is
    greater than the (T1) delay time, the negative value is not
    larger than the delay time, and message FCXUSL317A is not
    displayed.
    

Problem conclusion

  • The code has been changed to use fullword storage areas to
    retain the accumulation of contiguous minutes a user has
    exceeded an established threshold for %CPU, IO/S, or UR/S.
    
    In UCMOSECT COPY:
       The following fields in UCMOSECT DSECT were increased from
       halfword to fullword in size:
          UCMCTIME - total CPU
          UCMITIME - total IO/S
          UCMUTIME - total UR/S
       The following field in ULMTSECT DSECT was increased from
       halfword to fullword in size:
          ULMTIME  - total limit exceeded time
    
    In FCXUSL ASSEMBLE:
       The following field was increased from halfword to fullword
       in size:
          SMPMINUT - sample length in minutes
    
       The logic was changed from halfword logic to fullword logic
       in each location where any of the above fields were
       referenced.
    
    In FCXUSR ASSEMBLE:
       UCMCTIME, UCMITIME, and UCMUTIME are checked to determine
       proper highlighting of output.
    
       The logic was changed from halfword logic to fullword logic
       in each location where any of the above three fields were
       referenced.
    

Temporary fix

  • FOR RELEASE PERFKIT-6.4.0 :
    PREREQ: VM65647 VM66234 VM66085
    CO-REQ: NONE
    IF-REQ: NONE
    FOR RELEASE PERFKIT-7.1.0 :
    PREREQ: VM65647 VM66234
    CO-REQ: NONE
    IF-REQ: NONE
    FOR RELEASE PERFKIT-7.2.0 :
    PREREQ: NONE
    CO-REQ: NONE
    IF-REQ: NONE
    

Comments

APAR Information

  • APAR number

    VM66470

  • Reported component name

    PERF TOOLKIT

  • Reported component ID

    568411218

  • Reported release

    640

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-10-22

  • Closed date

    2020-11-12

  • Last modified date

    2021-03-30

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

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

    UM35774 UM35775 UM35776

Modules/Macros

  • FCXCPL   FCXGHU   FCXIPQ   FCXLSM   FCXLSN   FCXMTU   FCXPSD
    FCXPSF   FCXRSM   FCXTCM   FCXTLN   FCXTRN   FCXUCF   FCXUCL
    FCXUCM   FCXUCN   FCXUPA   FCXUPG   FCXUPU   FCXUQD   FCXURS
    FCXUSI   FCXUSL   FCXUSO   FCXUSR   FCXUST
    

Fix information

  • Fixed component name

    PERF TOOLKIT

  • Fixed component ID

    568411218

Applicable component levels

  • R640 PSY UM35774

       UP20/11/25 I 1000

  • R710 PSY UM35775

       UP20/11/25 I 1000

  • R720 PSY UM35776

       UP20/11/25 P 2101

Fix is available

  • Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG27M","label":"APARs - z\/VM environment"},"Platform":[{"code":"PF054","label":"z\/OS"}],"Version":"640","Line of Business":{"code":"LOB16","label":"Mainframe HW"}}]

Document Information

Modified date:
31 March 2021