IBM Support

PM55389: DATECALC RETURN CODE HANDLING

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Per PMR 20279,379,000
    
    ================================================================
    Prerequisite: APAR - PM55081
    
    Date reported: 12/28/2011
    
    
    Severity: 3
    
    Users Affected:
     All IMU users who use Date Calculation Routines
    
    Problem Description:
     Customer is setting return code (RC=08) before invoking
     DATECALC but the date is not returned even when RC=0 in
     the date routines.
    
    Problem Summation
     The IF instruction post DATECALC returns date only on zero
     RETURN-CODE. However, RETURN-CODE is not captured when
     RETURNC=EASYT option is in effect, thus the RETURN-CODE
     value set before the DATECALC macro is still present in
     the RETURN-CODE register after FSDATEZ0 call.
    
     The DATEABE=(RC) option works properly in combination with
     RETURC=NATIVE. With this combination, the RETURN-CODE is
     captured and programmer can test return code for zero or
     none zero and take appropriate action.
    
    Problem Conclusion:
     A change was made to preserve RETURN-CODE set by the user and
     restore it after the call to FSDATEZ0 program interrogates
     returned code.
    
     This change is applicable when RETURNC=EASYT option is in
     effect. This change is not applicable when RETURNC=NATIVE
     option is in effect.
    
    
    Impact on existing programs:
     There is no impact on programs that do not use the date
     routines.  There is not impact on programs that have been
     compiled and run clean as load modules.
    
     Link & Go programs or re-compiled programs will be generated
     with the correct logic.
    
    Changed byte code macros in FSOFT01.V3R2M0.SFSYCCLM:
      DAYSAGO  - existing macro
      DATECONV - existing macro
      DAYSCALC - existing macro
      DATECALC - existing macro
    
    
    Changed byte code macros in FSOFT01.V3R2M0.SFSYFJCC:
      EASYOVRD - existing macro
      EASYTRAN - existing macro
      DAYSAGO  - existing macro
      DATECONV - existing macro
      DAYSCALC - existing macro
      DATECALC - existing macro
    ================================================================
    

Local fix

  • N/A
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All IMU V3.2 users who use Data              *
    *                 Calculation Routines.                        *
    ****************************************************************
    * PROBLEM DESCRIPTION: Customer is setting return code         *
    *                      (RC=08) before invoking DATECALC but    *
    *                      the date is not returned even when      *
    *                      RC=0 in the date routines.              *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    The IF instruction post DATECALC returns date only on zero
    RETURN-CODE. However, RETURN-CODE is not captured when
    RETURNC=EASYT option is in effect, thus the RETURN-CODE
    value set before the DATECALC macro is still present in the
    RETURN-CODE register after FSDATEZ0 call.
    
    The DATEABE=(RC) option works properly in combination with
    RETURC=NATIVE. With this combination, the RETURN-CODE is
    captured and programmer can test return code for zero or
    none zero and take appropriate action.
    

Problem conclusion

  • A change was made to preserve RETURN-CODE set by the user
    and restore it after the call to FSDATEZ0 program
    interrogates returned code. This change is applicable
    when RETURNC=EASYT option is in effect. This change is
    not applicable when RETURNC=NATIVE option is in effect.
    
    Link & Go programs or re-compiled programs will be
    generated with the correct logic.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM55389

  • Reported component name

    MIGRATION UTILI

  • Reported component ID

    5697N4400

  • Reported release

    320

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-01-05

  • Closed date

    2012-01-20

  • Last modified date

    2012-02-02

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

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

Modules/Macros

  •    FSYDTCAL FSYDTCLC FSYDTCNV FSYDTCVT FSYDYAGO
    FSYDYCAL FSYDYSGO FSYDYSLC FSYESORD FSYETRAN
    

Fix information

  • Fixed component name

    MIGRATION UTILI

  • Fixed component ID

    5697N4400

Applicable component levels

  • R320 PSY UK75631

       UP12/01/25 P F201

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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSY4B9","label":"IBM Migration Utility for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"320","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
27 October 2020