IBM Support

PI22545: LE/C TIME() FUNCTION ALWAYS RETURNS THE SAME TIME VALUE

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • Customer using VSE Connector based scenarios for job submission
    (like VSE HealthChecker, Navigator or other tools/exploiters)
    are likely to be impacted in the use of LE/C time() function.
    The symtom seen was that time() always returned the same value.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All LE/C for z/VSE Users.                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: 1.Any use of the LE/C run-time library  *
    *                      function time() will result in the      *
    *                      same time always being returned.        *
    *                      2.Invalid parsing of "SPACE" option     *
    *                      on a fopen() request for a SAMESDS      *
    *                      file.                                   *
    *                      3.Incorrect JCL DISP options set when   *
    *                      opening an implicity defined SAMESDS    *
    *                      file by dataset name.                   *
    *                      4.Incorrect component information       *
    *                      displayed for DSECT utility output      *
    *                      reports.                                *
    *                      5.Default IJSYSUC label used when       *
    *                      opening SAMESDS files by dataset        *
    *                      name for read access.                   *
    ****************************************************************
    * RECOMMENDATION: Apply the provided PTF.                      *
    ****************************************************************
    1. Incorrect compile options used in the maintenance system
    resulted in incorrect code generated for critical time function
    modules.
    2. Parsing of the fopen() parameters that include the "SPACE"
    option resulted in an undocumented format being required.
    3. Implicity defined SAMESDS files opened by dataset name for
    write-mode are incorrectly using read-only JCL DISP settings.
    4. DSECT utility messages display out-dated old component
    information.
    5. The installation default VSAM user catalog label is now
    "VSESPUC". Using the VSAM default user catalog processing can
    therefore result in open failures of "ELOCATE" (MSGEDC5049I)
    when opening a SAMESDS file by dataset name for read access.
    Even though the target dataset exists in an accessable VSAM
    user catalog.
    

Problem conclusion

  • 1. Maintenance system compile options corrected. All affected
    modules are rebuilt and shipped in this APARs associated PTF.
    2. Parsing code for the "SPACE" parameter has been corrected
    to behave as per the documentation.
    3. Correct JCL DISP options will now be set on the label when
    using fopen() in write-mode to open an implicity defined
    SAMESDS file when using a dataset name.
    4. The DSECT utility messages have been updated.
    5. The VSAM SAMESDS file information extraction processing
    has been improved to more reliably locate existing SAMESDS
    files when being opened by dataset name for read access. The
    default VSAM catalog label of VSESPUC will now be used.
    Additionally a new ENVAR is available to allow a programmer
    the specification of a different default VSAM User Catalog
    label. The ENVAR can be set in the C/VSE program or as an
    over-ride using any of the supported LE z/VSE option over-ride
    methods. See the below documentation updates for details.
    
    >> Start of Documentation Updates <<
    
    Manual : LE/VSE 1.4.8 C Run-Time Programming Guide
    Manual Ref : SC33-6688-08
    
    Please add the following to Section 4.2.2
    "Environment Variables Specific to the LE/VSE C Run-Time
    LIbrary" :
    
    Add " _EDC_SAMDS_UCAT " to the listed ENVARs.
    
    Add subtopic 4.2.2.9 _EDC_SAMDS_UCAT
    
    Add the following for subtopic 4.2.2.9 :
    
    This variable allows the programmer to specify a different
    default VSAM User Catalog label to be used for VSAM SAMESDS
    open processing. This ENVAR is not applicable to any other
    types of VSAM file processing.
    
    This ENVAR can be set using the "setenv()" function.
    Eg
       setenv("_EDC_SAMDS_UCAT","MYCATLG",1);
    
    Any subsequent VSAM SAMESDS file open processing would now use
    the VSAM user catalog label "MYCATLG".
    
    This environment variable is not set by default at run-time
    initialization.
    
    Usage Notes:
    This ENVAR is only used when opening a VSAM SAMESDS file by
    dataset name.
    If this ENVAR is not specified the default "VSESPUC" DLBL will
    be used.
    If the ENVAR value is set and specifies a label greater than
    seven (7) characters in length the contents will be ignored. No
    truncation will be performed. In this case the VSAM default
    processing behaviour will be performed.
    
    >> End of Documentation Updates <<
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI22545

  • Reported component name

    LE C + JAP

  • Reported component ID

    5686CF933

  • Reported release

    51L

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2014-07-23

  • Closed date

    2014-09-26

  • Last modified date

    2014-10-15

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

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

    UI21719 PI27491

Modules/Macros

  • EDCBDFMT EDCBP090 EDCBP096 EDCLVL   EDCTCPMX EDCTCPVD EDCTIME
    EDC1MPRS EDC1OPNV EDC1OPST EDC1VLIB EDDDMENU EDDDMJPN EDDDMUEN
    

Fix information

  • Fixed component name

    LE C + JAP

  • Fixed component ID

    5686CF933

Applicable component levels

  • R51L PSY UI21719

       UP14/10/15 I 1000

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.



Document information

More support for: z/VSE family

Software version: 51L

Operating system(s): VSE/ESA

Reference #: PI22545

Modified date: 15 October 2014