IBM Support

PH30719: SYSIDERR ON A REMOTE READ OF AN USER-MAINTAINED DATA TABLE (UMDT) WHEN TWO TASKS OPEN THE FILE AT THE SAME TIME.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Two tasks running concurrently open the UMDT. The first task
    manages to open the file, gets the enqueue FCFLUMTL and then
    loads the UMDT.
    The second tasks fails to read the record and gets Response =
    DTP_EXCEPTION & Reason = DTP_NOT_IN_TABLE.
    Further checks set FCFR_RESPONSE = FCFR_EXCEPTION; and
    FCFR_REASON = FCFR_SHIP.
    The task then waits on the enqueue FCFLUMTL. Meaning "wait
    during loading of a user-maintained data table".
    .
    After the UMDT is loaded (by the first task), the enqueue is
    released and the second task is resumed.
    The second task repeats the read of the record, this time it is
    successful but FCFR_EXCEPTION and FCFR_SHIP are still set.
    .
    On return from DFHFCDTS, we get an exception SHIP, this causes a
    ISP CONVERSE but there is no termid associated with the task
    so this results in a SYSIDERR.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: SYSIDERR returned on a read of a        *
    *                      user maintained data table.             *
    ****************************************************************
    EXEC CICS READ requests were function shipped to a file
    owning CICS region and CSMI transactions attached to process
    them. The first command attached CFTL to load the user
    maintained data table being read. Before this completed, the
    second READ command detected that the record to be read was
    not yet available. DFHFCDTS set fcfr_response to fcfr_exception
    and fcfr_reason to fcfr_ship. However, before returning this
    to DFHFCFR it determined the table load had completed so
    retried a read of the UMDT. This was now successful. DFHFCDTS
    returned to DFHFCFR but the exception response had not been
    reset, and so DFHFCFR attempted to function ship the request
    on to a file owning region. No such SYSID was provided as there
    was not a remote FOR. The command failed with a SYSIDERR.
    

Problem conclusion

  • DFHFCDTS has been changed to reset fcfr_response and fcfr_reason
    before retrying a data table read after loading has completed.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH30719

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-10-20

  • Closed date

    2020-12-02

  • Last modified date

    2021-01-04

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

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

    UI72874 UI72875 UI72876

Modules/Macros

  • DFHFCDTS
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R100 PSY UI72876

       UP20/12/07 P F012

  • R200 PSY UI72875

       UP20/12/07 P F012

  • R300 PSY UI72874

       UP20/12/11 P F012

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.

[{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4"}]

Document Information

Modified date:
05 January 2021