IBM Support

PM90865: WOLA BBOACNTL UTILITY RETURNS IMPROPER RESULTS MESSAGE AFTER APPLICATIONS EC LINK TO IT

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When invoking program BBOACNTL via EXEC CICS LINK, the message
    returned in the COMMAREA does not reflect the results of the
    BBOACNTL program.
    
    So the COMMAREA may say something like "BBOA8001I Invoking OLA
    Register API for MVCSERVICE", but the actual result was that
    Register failed.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:  All users of IBM WebSphere Application      *
    *                  Server V8.5 for z/OS                        *
    ****************************************************************
    * PROBLEM DESCRIPTION: WOLA CICS control program, BBOACNTL     *
    *                      had no proper way to provide            *
    *                      a good or bad return/reason code        *
    *                      when it's called in CICS using          *
    *                      EXEC CICS LINK PROGRAM('BBOACNTL')      *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    There is no documented structure for what BBOACNTL returns for
    an EXEC CICS LINK to it with a COMMAREA.
    

Problem conclusion

  • The fix for this APAR includes support for a structured
    response area for an EXEC CICS LINK to BBOACNTL. Callers need
    to use the documented V1 input commarea structure, as
    shown in a new C header, bboaapic.h (struct
    outputCommarea_v1). When the COMMAREA is atleast this size or
    larger on input to BBOACNTL, the utility will return a
    Version, Return code, and Reason in the bytes just past 256.
    The following is the Version 1 COMMAREA request and response
    area format (shown in C):
    
       struct outputCommarea_v1 {
          char message[256];
          int version;
          int returnCode;
          int reasonCode;
        };
    
    This APAR also contains support for a new BBOACNTL and BBOC
    WOLA CICS transaction parameter called 'LIST_SRVR'.  Passing
    LIST_SRVR with a Register name will produce a list of all WOLA
    Link Servers that match the passed in register name in the
    WOLA BBOQ transient data queue in the CICS job output. There
    is also a new 'LTSQ' parameter which can be provided in
    addition to LIST_SRVR and it can provide the name of a CICS
    temporary storage queue where the list of Link Servers will be
    written to. This provides EXEC CICS LINK callers of
    BBOACNTL the ability to work with the returned list.
    
    Also included is a new CICS shut down PLT program, BBOACPLS
    and a sample JCL showing how to include it in your CICS
    shutdown PLT list.  This new PLT program will stop any running
    Link Servers in the CICS region during shutdown when enabled.
    
    Sample PLT programs are also included to demonstrate how to
    build your own CICS initialization and shutdown PLT programs.
    
    The following are included with this APAR. These are located
    in the /<WAS_HOME>/AppServer/util/zos/OLASamples directory:
    
    bboacplt.jclsamp - sample assembler showing PLT init
    to issue EC LINK to BBOACNTL for BBOC START_TRUE
    
    bboacpl2.jclsamp - sample assembler showing PLT init
    to issue read from INITPARMS on CICS startup and issue BBOC
    commands
    
    bboacpl3.jclsamp - sample assembler showing PLT init
    to issue multiple BBOC commands during CICS startup
    
    bboacpls.jclsamp - sample assembler showing PLT shutdown
    EXEC CICS LINK BBOACNTL with LIST_SRVR parm and then read
    through the list and shut down each Link Server
    
    Refer to the WebSphere Application Server V8.5 Information
    Center for more details on the capabilities added with this
    APAR.
    
    APAR PM90865 is currently targeted for inclusion in Fix Pack
    8.5.5.2 of WebSphere Application Server.
    
    Please refer to the Recommended Updates page for delivery
    information:
    http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
    
    In addition, please refer to URL:
    http://www.ibm.com/support/docview.wss?rs=404&uid=swg27006970
    for Fix Pack PTF information.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM90865

  • Reported component name

    WEBSPHERE FOR Z

  • Reported component ID

    5655I3500

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-06-11

  • Closed date

    2013-11-25

  • Last modified date

    2013-11-25

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

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

Fix information

  • Fixed component name

    WEBSPHERE FOR Z

  • Fixed component ID

    5655I3500

Applicable component levels

  • R800 PSY

       UP

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS7K4U","label":"WebSphere Application Server for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"800","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
28 April 2022