IBM Support

PM61304: IMPLICIT CLOSE OF SYSPRINT FAILS WITH MSGIEC214I SYSTEM CODE=614WHEN SYSPRINT IS AN HFS FILE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Implicit close of SYSPRINT fails with MSGIEC214I system code=614
    when SYSPRINT is an HFS file.  Message IEC204I also received
    noting error in DOWRITE routine with a function code of 0000000B
    Function code indicates an unexpected error was returned from
    Unix System Services.  If an explicit close of SYSPRINT is added
    to the program the application runs successfully.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All PL/I users of SYSPRINT with SYSPRINT     *
    *                 routed to an HFS file.                       *
    *                                                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Implicit close of SYSPRINT fails with   *
    *                      MSGIEC214I system code=614 when         *
    *                      SYSPRINT is an HFS file.                *
    *                                                              *
    ****************************************************************
    * RECOMMENDATION: Apply the PTF for this APAR, along with the  *
    *                 PTFs for Enterprise PL/I APAR PM56686 and    *
    *                 LE APAR PM60031.                             *
    *                                                              *
    ****************************************************************
    Part of LE enclave termination when HFS files are involved
    include calling a BPX service to perform thread-related
    clean-up. If the enclave happens to be the last one in the
    process, the BPX service will proceed to clean up process-level
    resources as well.
    
    It was in this scenario that SYSPRINT was closed.
    - The user batch program routed SYSPRINT to an HFS file.
    - There was no explicit CLOSE statement coded for SYSPRINT.
    - During LE enclave termination, the BPX service proceeded to
    close out SYSPRINT since the enclave was the last one in the
    process.
    
    SYSPRINT being closed during LE enclave termination caused a
    problem on the PL/I side because SYSPRINT is a process-level
    resource for PL/I. With this being a batch program, QSAM I/O
    was involved, and thus, a DCB for SYSPRINT existed. When the
    BPX service closed out the HFS file for SYSPRINT, the DCB
    remained open.
    
    Going through process-level termination, the PL/I library
    proceeded to close SYSPRINT since the DCB was open. The abend
    occurred in DFSMS during CLOSE processing for SYSPRINT since
    the file has essentially been closed.
    

Problem conclusion

  • The fix for this problem involves three components:
    - For LE, a new event is introduced that will call member
    languages during enclave termination when it is the last enclave
    in the process. This will allow member languages to perform
    needed clean-up before LE calls the BPX service mentioned above.
    - For Enterprise PL/I and PL/I for MVS & VM, when LE calls via
    the new event, SYSPRINT will be closed if needed.
    
    This APAR pre-reqs LE APAR PM60031 and co-reqs Enterprise PL/I
    APAR PM56686.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM61304

  • Reported component name

    LE PL/I LIBRARY

  • Reported component ID

    568819803

  • Reported release

    760

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2012-03-27

  • Closed date

    2012-04-17

  • Last modified date

    2012-05-02

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

    PM56686

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

    UK78021 UK78022 UK78026

Modules/Macros

  •    IBMRECLS IBMREV10 IBMROPBA
    

Fix information

  • Fixed component name

    LE PL/I LIBRARY

  • Fixed component ID

    568819803

Applicable component levels

  • R760 PSY UK78021

       UP12/04/20 P F204

  • R770 PSY UK78022

       UP12/04/20 P F204

  • R780 PSY UK78026

       UP12/04/20 P F204

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":"SG19M","label":"APARs - z\/OS environment"},"Platform":[{"code":"PF054","label":"z\/OS"}],"Version":"7.6"}]

Document Information

Modified date:
24 January 2021