IBM Support

PM92201: REDUCE THE STORAGE OVERHEAD WHEN PERFORMING AN INVOKE SERVICE COMMAND

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Your region goes Short on Storage when acting as a Web Service
    Requester to an outside vendor to retrieve documents. Storage
    utilization peeks to 15 times the document size during INVOKE
    WEBSERVICE COMMAND or first GET CONTAINER after INVOKE
    WEBSERVICE completes. SOS occurs in EUDSA.
    Further diagnosis, found that
    1)There is no ability at the moment for the pipeline to
      indicate it no longer requires the SET storage.
    2)The other issue is the codepage conversion required of
      the DFHWS-BODY container. DFHPGCR does not know how big
      the data will be after conversion. So it acquires a storage
      area that is guaranteed to be large enough for even the most
      expansive conversion process.
    Additional Symptom(s) Search Keyword(s): KIXREVSCB SOS EUDSA
    DFHWS-BODY PIPELINE DFHSM0133 SM0133
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS Users                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: Excessive storage usage on EXEC CICS    *
    *                      INVOKE SERVICE command.                 *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    An application does an EXEC CICS INVOKE SERVICE command which
    receives a large response from the service provider.
    When processing the response, module DFHPIIW issues
    GET_CONTAINER_SET which results in a large getmain for the
    storage for the SET. This storage is then unnecessarily
    retained until end of task. Module DFHPGCR also allocates
    storage for codepage conversion but this may be more than is
    necessary. If PI level 2 trace is active then DFHPIIS traces
    the first 4000 bytes of the DFHREQUEST and DFHRESPONSE
    containers. To get the data it issues GET_CONTAINER_SET which
    again may may allocate more storage than required.
    The combined effect of these issues is to allocate and retain
    more storage than necessary which can cause CICS to
    become short of storage in the EUDSA and msgDFHSM0133
    may be issued.
    

Problem conclusion

  • Modules DFHPGCR and DFHPIIW have been changed to free the SET
    storage obtained during SOAP processing once it is no longer
    required.
    Module DFHPISN has been changed to free the set storage for
    the work container DFHPARSE-OUTPUT when it is no longer
    required.
    DFHPGCR has been changed to allocate and use above the bar
    storage for codepage conversion of large CHAR containers,
    when requested by callers. This is used by DFHPISN and DFHPIIW.
    DFHPIIS has been changed to get container data into a 4k area
    for trace when required, for request and response containers.
    

Temporary fix

  •             *********
                * HIPER *
                *********
    FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM92201

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    700

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-07-01

  • Closed date

    2014-02-07

  • Last modified date

    2014-03-03

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

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

    PI07017 UI13306

Modules/Macros

  •    DFHAPCR  DFHAPCR1 DFHAPRT  DFHECEAH DFHECEAM
    DFHECEAS DFHECEAT DFHECEB  DFHECEC  DFHECEI  DFHECIS  DFHECRL
    DFHECSC  DFHEIBAM DFHEIIC  DFHEIQBA DFHEPAS  DFHEPC   DFHEPEV
    DFHEPRL  DFHICXM  DFHIIRR  DFHJSON  DFHMLJS  DFHMLPC  DFHMLTF
    DFHMQTM  DFHPCXDF DFHPGCH  DFHPGCP  DFHPGCR  DFHPGCRT DFHPIAD
    DFHPIAT  DFHPIA1  DFHPICA  DFHPICC  DFHPIDM  DFHPIDSH DFHPIDSQ
    DFHPIDUF DFHPIII  DFHPIIW  DFHPILN  DFHPILSQ DFHPIMM  DFHPIPL
    DFHPIPM  DFHPIPM2 DFHPIPS  DFHPIRE  DFHPIRI  DFHPIRM  DFHPIRS
    DFHPIRT  DFHPISC  DFHPISF  DFHPISN  DFHPISN2 DFHPIST  DFHPITC
    DFHPITC1 DFHPITC2 DFHPITC3 DFHPITE  DFHPITH  DFHPITL  DFHPITQ
    DFHPITQ1 DFHPITRI DFHPITS  DFHPIUE  DFHPIWR  DFHPIWT  DFHPIXI
    DFHPIXM  DFHPIXO  DFHRLBR  DFHRLDM  DFHRLPK1 DFHRLPM  DFHRLRG1
    DFHRLRO  DFHRLRS1 DFHRLST  DFHRLVC  DFHRZDM  DFHRZIX  DFHRZLN
    DFHRZNR2 DFHRZRG2 DFHRZRM  DFHRZRS1 DFHRZSO  DFHRZSO1 DFHRZTA
    DFHRZTCX DFHRZTRI DFHRZTR1 DFHRZXM  DFHSJDM  DFHSJJI  DFHSJST
    DFHSJTH  DFHWBAP  DFHWBCL  DFHWBQM  DFHWSADH DFHWSATH DFHWSATR
    DFHWSATX DFHW2ER  DFHW2FD  DFHW2FI  DFHW2FR  DFHW2SD  DFHW2TS
    DFHW2W2  DFHXSTS  DFHZIS2
    

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R700 PSY UI13306

       UP14/02/21 P F402

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":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 March 2014