Fixes are available
8.5.5.2: WebSphere Application Server V8.5.5 Fix Pack 2
8.5.5.3: WebSphere Application Server V8.5.5 Fix Pack 3
8.5.5.4: WebSphere Application Server V8.5.5 Fix Pack 4
8.5.5.5: WebSphere Application Server V8.5.5 Fix Pack 5
8.5.5.6: WebSphere Application Server V8.5.5 Fix Pack 6
8.5.5.7: WebSphere Application Server V8.5.5 Fix Pack 7
8.5.5.8: WebSphere Application Server V8.5.5 Fix Pack 8
8.5.5.9: WebSphere Application Server V8.5.5 Fix Pack 9
8.5.5.10: WebSphere Application Server V8.5.5 Fix Pack 10
8.5.5.11: WebSphere Application Server V8.5.5 Fix Pack 11
8.5.5.12: WebSphere Application Server V8.5.5 Fix Pack 12
8.5.5.13: WebSphere Application Server V8.5.5 Fix Pack 13
8.5.5.14: WebSphere Application Server V8.5.5 Fix Pack 14
8.5.5.15: WebSphere Application Server V8.5.5 Fix Pack 15
8.5.5.14: WebSphere Application Server V8.5.5 Fix Pack 14
8.5.5.17: WebSphere Application Server V8.5.5 Fix Pack 17
8.5.5.20: WebSphere Application Server V8.5.5.20
8.5.5.18: WebSphere Application Server V8.5.5 Fix Pack 18
8.5.5.19: WebSphere Application Server V8.5.5 Fix Pack 19
8.5.5.16: WebSphere Application Server V8.5.5 Fix Pack 16
8.5.5.21: WebSphere Application Server V8.5.5.21
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
Document Information
Modified date:
28 April 2022