IBM Support

PK56097: WEB SERVICES MONITORING

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Web services monitoring
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All                                          *
    ****************************************************************
    * PROBLEM DESCRIPTION: Add support for the new CICS Global     *
    *                      User Exit point XWSPRROO.               *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    Supply support for the new GLUE XWSPRROO and a sample exit
    DFH$PIEX in order to facilitate CICS web services monitoring.
    

Problem conclusion

  • Support for XWSPRROO has been implemented and sample DFH$PIEX
    provided.
    
    The CICS Transaction Server for z/OS Customization Guide Version
    3 Release 2 SC34-6814-01 has been altered to add a new section
    after 'Monitoring domain exit XMNOUT' called 'Pipeline
    domain exits' as follows:-
    
    "Pipeline domain exits
    
    Use the pipeline domain exit to customize the processing that
    occurs for outbound Web services in the pipeline.
    
    Exit XWSPRROO
    The XWSPRROO exit enables you to access containers on the
    current channel after the Web services provider application
    has issued the Web service response message and before CICS
    creates the body of the response message.
    
    You can use this exit to issue API and SPI commands to examine
    the containers on the current channel. You cannot issue a SOAP
    fault or update any of the containers. CICS ignores any return
    code specified in register 15 after the global user exit
    program has finished.
    
    Exit-specific parameters
    
    UEPTRANID
    Address of the 4-byte transaction ID. This is the transaction
    ID under which the exit, or task, is running.
    
    UEPUSER
    Address of the 8-byte user ID. The user ID will be the one
    associated with the transaction ID.
    
    UEPTERM
    Address of the 4-byte terminal ID. The value will be null
    for a Web service provider.
    
    UEPPROG
    Address of the 8-byte application program name. The
    application program name is that of the application handler
    DFHPITP.
    
    UEPCHANN
    Address of a 16-byte field that contains the name of the
    current channel. You can identify the channel explicitly using
    this parameter.
    
    UEPCONTR
    Address of a 16-byte field that contains the name of
    the data container on the channel named by UEPCHANN. This
    container holds the application data structure.
    
    UEPAPAB
    A 1-byte field indicating if the Web service provider
    application completed its processing successfully. Valid values
    are as follows:
     UEPAPABY (X'80')
     The Web service provider application abended.
     UEPAPABN (X'40')
     The Web service provider application completed its
     processing successfully.
    
    UEPAPSF
    A 1-byte field indicating if the Web service provider
    application set a SOAP fault. Valid values are as follows:
     UEPAPSFY (X'80')
     The Web service provider application is returning a
     SOAP fault.
     UEPAPSFN (X'40')
     The Web service provider application is not returning
     a SOAP fault.
    
    Return codes
    
    UERCNORM
    Continue processing.
    
    API and SPI commands
    
    The following commands are supported:
    . EXEC CICS ABEND
    . EXEC CICS ADDRESS
    . EXEC CICS ASKTIME
    . EXEC CICS ASSIGN
    . EXEC CICS FORMATTIME
    . EXEC CICS GET CONTAINER
    . EXEC CICS HANDLE ABEND
    . EXEC CICS INQUIRE WEBSERVICE
    . EXEC CICS WRITE FILE
    . EXEC CICS WRITEQ TD
    . EXEC CICS WRITEQ TS"
    
    ...and after 'The MRO and APPC session queue management sample
    exit program' to add a new section called 'The pipeline sample
    exit program' as follows:-
    
    "The pipeline sample exit program
    
    The DFH$PIEX sample global user exit program provides sample
    processing for the XWSPRROO global user exit.
    
    If you enable this sample program, it is invoked in a Web
    service provider pipeline after the Web service provider
    application has finished processing and returned to CICS, but
    before CICS creates the response message SOAP body.
    
    The sample program retrieves the name of the Web service, the
    name of the transaction, and all of the attributes of the Web
    service."
    
    The CICS Transaction Server for z/OS Web Services Guide Version
    3 Release 2 SC34-6838-00 has been changed to add a new section
    after 'Message handlers' called 'Customizing pipeline
    processing' as follows:-
    
    "In addition to providing your own message handlers, you can
    also use a global user exit point to customize the processing
    of provider mode pipelines.
    
    You must understand the best practices for writing global user
    exit programs before customizing the pipeline. You must be
    using the DFHPITP application handler in your pipeline to use
    the global user exit point.
    
    1. Use the DFH$PIEX sample exit program to write your own global
    user exit program. DFH$PIEX is in the SDFHSAMP library. You are
    recommended to make the program threadsafe.
    
    2. Enable the global user exit program.
    
    3. Test your global user exit program to ensure it works
    correctly.
    
    Use the XWSPRROO exit to access containers on the current
    channel after the Web services provider application issues
    the Web service response message and before CICS creates the
    body of the response message."
    
    The CICS Transaction Server for z/OS Trace Entries Version
    3 Release 2 SC34-6828-01 manual has been changed to add a new
    entry after 'PI 1012' as follows:-
    
    "PI 1013 DFHPITL PI Exc XWSPRROO GLUE error 1 PITL parameter
                                                            list"
    
    The CICS Transaction Server for z/OS Application Programming
    Reference Version 3 Release 2 SC34-6819-00 has been changed
    to add a new RESP2 value of 3 associated with CHANNELERR
    condition for these commands as follows:-
    
    MOVE CONTAINER (CHANNEL):
    
    "CHANNELERR
        3
          Either the current channel or the channel specified on
          the CHANNEL option is read-only"
    
    PUT CONTAINER (CHANNEL):
    
    "CHANNELERR
        3
          Either the current channel or the channel specified on
          the CHANNEL option is read-only"
    
    SOAPFAULT DELETE:
    
    "CHANNELERR
        3
          The channel where this SOAPFAULT object is being
          deleted is read-only."
    
    SOAPFAULT ADD:
    
    "CHANNELERR
        3
          The channel where this SOAPFAULT object is being added
          is read-only."
    
    SOAPFAULT CREATE:
    
    "CHANNELERR
        3
          The channel where this SOAPFAULT object is being created
          is read-only."
    
    The CICS Transaction Server for z/OS Version 3 Release 2
    Supplementary Data Areas manual, GC34-6864-00, section
    'PIDCC Pipeline Manager Control Blocks' has been altered.
    Fields have been added to the end of the PI Domain anchor
    block (the PIA), after field PIA_PITCR_COUNT, as follows:
    
    (4E0)  FULLWORD  4   PIA_PITCR_COUNT      use count dfhpitcr
    (4E4)  CHARACTER 1   PIA_USER_EXIT_STATUS Global user exits
           1... ....     PIA_XWSPRROO_ACTIVE  XWSPRROO is active
           .1.. ....     PIA_XRSINDI_ACTIVE   XRSINDI is active
           ..11 1111     *                    reserved
    
    (4E5)  CHARACTER 3   *                    filler
    (4E8)  CHARACTER 0   *
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

  • ž**** PE08/01/30 FIX IN ERROR. SEE APAR PK60040  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PK56097

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    500

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2007-11-07

  • Closed date

    2008-01-17

  • Last modified date

    2008-04-02

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

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

    PK56098 UK33060

Modules/Macros

  •    DESABAB  DESAPRC  DESBRFM  DESEIPI  DESEITBA
    DESLI1   DESPGCH  DESPGCOX DESPGCP  DESPGCR  DESPGDC  DESPGDUF
    DESPGEX  DESPICC  DESPIDC  DESPIDM  DESPIDUF DESPIII  DESPIIS
    DESPIPM  DESPIRE  DESPIRM  DESPIRS  DESPISF  DESPISN  DESPITL
    DESPITQ  DESPITRI DESPIUE  DESWSATH DESWSATX DFH$PIEX DFH$STTB
    DFHABAB  DFHABABA DFHABABM DFHABABT DFHAITM  DFHAPEX  DFHAPLI1
    DFHAPLJ1 DFHAPLX1 DFHAPPG  DFHAPRC  DFHAPTRC DFHBRBFB DFHBRBSB
    DFHBRFM  DFHBRFMA DFHBRFMM DFHBRFMT DFHEIBAM DFHEIPI  DFHERM
    DFHEXITP DFHPGCH  DFHPGCHA DFHPGCHI DFHPGCHM DFHPGCHT DFHPGCON
    DFHPGCP  DFHPGCPA DFHPGCPI DFHPGCPM DFHPGCPT DFHPGCR  DFHPGCRA
    DFHPGCRI DFHPGCRM DFHPGCRT DFHPGDCC DFHPGDCD DFHPGDUF DFHPGEX
    DFHPGEXA DFHPGEXI DFHPGEXM DFHPGEXT DFHPIAP  DFHPICC  DFHPICCA
    DFHPICCM DFHPICCT DFHPIDCC DFHPIDCD DFHPIDM  DFHPIDUF DFHPIII
    DFHPIIIA DFHPIIIM DFHPIIIT DFHPIISC DFHPIISI DFHPIPM  DFHPIPMA
    DFHPIPMM DFHPIPMT DFHPIRE  DFHPIREA DFHPIREM DFHPIRET DFHPIRM
    DFHPIRS  DFHPISF  DFHPISFA DFHPISFC DFHPISFD DFHPISFM DFHPISFT
    DFHPISN  DFHPISNA DFHPISNC DFHPISND DFHPISNM DFHPISNT DFHPISN1
    DFHPISN2 DFHPITL  DFHPITLA DFHPITLM DFHPITLT DFHPITP  DFHPITQ
    DFHPITQ1 DFHPITRI DFHPIUCC DFHPIUCD DFHPIUE  DFHSIC1  DFHSUEX
    DFHUEH   DFHUEHC  DFHUEIQ  DFHUEM   DFHUEXIT DFHWSATH DFHWSATX
    HCI6500J
    

Publications Referenced
SC34681401SC34683800SC34682801SC34681900GC34686400

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R500 PSY UK33060

       UP08/01/29 P F801

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":"3.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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
02 April 2008