PI92070: WebSphere Liberty z/OS WOLA CICS link server fixes for RTXSYS and RTX parameters

Fixes are available

APAR status

Closed as program error.

Error description

Customers using the Liberty WOLA CICS link server to route
requests over to a remote CICS region are not able to
specify both the RTXSYS (remote sysid) and RTX (remote
transid) parameters together for the same link server. This
means there is no way to pass both the TRANSID() and SYSID()
parameters to the link invocation task (BBO# transaction) so
that it may provide these on the EXEC CICS LINK PROGRAM()
API call to invoke the target program.  Another issue is the
ability to pass the RTXSYS parameter, without also
specifying either RTX or RTXP. A link server should be able
to start with just the RTXSYS parameter.

Local fix

Problem summary

****************************************************************
* USERS AFFECTED:  All users of IBM WebSphere Application      *
*                  Server Liberty for z/OS                     *
****************************************************************
* PROBLEM DESCRIPTION: WebSphere Liberty z/OS WOLA CICS link   *
*                      server fixes for RTXSYS and RTX         *
*                      parameters                              *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
Customers using the Liberty z/OS WOLA CICS link server to route
requests over to a remote CICS region are not able to specify
both the RTXSYS (remote sysid) and RTX (remote transid)
parameters together for the same link server. This means there
is no way to pass both the TRANSID() and SYSID() parameters to
the link invocation task (the default BBO# transaction) so that
it may provide these on the EXEC CICS LINK PROGRAM() API call to
invoke the target program. There is also no way to provide the
RTXSYS parameter, without also providing either RTX and RTXP.
This needs to be a supported option.

Problem conclusion

The WOLA CICS link server now allows both the RTX and RTXSYS
parameters to be supplied for remote invocation of a target
program. The parameter RTX=<remote transid> results in the WOLA
link invocation task using 'EXEC CICS LINK PROGRAM()
TRANSID(<remote transid>)' and RTXSYS=<remote sysid> results in
'EXEC CICS LINK PROGRAM() SYSID(<remote sysid>)'. With this fix,
if both are supplied, both will be used for the same link server
(for example: 'EXEC CICS LINK PROGRAM() TRANSID(<remote
transid>) SYSID(<remote sysid>)'). The WOLA CICS link server
also now allows the RTXSYS parameter to be provided alone,
without the need to pass either RTXP or RTX.
Behavior of the RTXP=Y|N parameter remains unchanged, and tells
the link invocation task to use whatever the current EIBTRNID is
for the transaction ID parameter on the EXEC CICS LINK PROGRAM()
TRANSID().

The fix for this APAR is currently targeted for inclusion in fix
pack 18.0.0.1.  Please refer to the Recommended Updates page for
delivery information:
http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980

Temporary fix

Comments

APAR Information

APAR number
PI92070
Reported component name
LIBERTY PROF -
Reported component ID
5655W6514
Reported release
CD0
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2018-01-04
Closed date
2018-01-08
Last modified date
2018-01-08

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
LIBERTY PROF -
Fixed component ID
5655W6514

Applicable component levels

RCD0 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":"CD0","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
04 May 2022

Tips

PI92070: WebSphere Liberty z/OS WOLA CICS link server fixes for RTXSYS and RTX parameters

Fixes are available

Subscribe

APAR status

Closed as program error.

Error description

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

APAR Information

APAR number

Reported component name

Reported component ID

Reported release

Status

PE

HIPER

Special Attention

Submitted date

Closed date

Last modified date

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

Fixed component ID

Applicable component levels

RCD0 PSY

Document Information

Share your feedback

Need support?