A fix is available
APAR status
Closed as program error.
Error description
When starting up the OSGi JVM server, the CICS BUNDLES attempting to be installed into the JVM server remain in a DISABLED state. The bundle resources are shared across multiple regions, and when all the regions are restarted, the bundles will remain disabled in random regions. In these regions where the bundle never enables, the transactions routed to the region fail until the bundle is discarded and reinstalled. The below messages occur: DFHSJ1004 An exception has been thrown by the route method of class com/ibm/cics/router/Router running in JVMSERVER MYJVMS. Exception 'A null service reference is not allowed.'.
Local fix
Increase com.ibm.cics.jvmserver.controller.timeout parameter
Problem summary
**************************************************************** * USERS AFFECTED: All CICS Users. * **************************************************************** * PROBLEM DESCRIPTION: DFHSJ1004 due to Exception 'A null * * service reference is not allowed.' when * * enabling a JVMSERVER. * **************************************************************** An OSGi JVMSERVER failed to enable with the following message issued: DFHSJ1004 An exception has been thrown by the route method of class com/ibm/cics/router/Router running in JVMSERVER MYJVMS. Exception 'A null service reference is not allowed.'. This Exception occurred because resource constraints meant the OSGi framework started very slowly, exposing a narrow timing window. The BUNDLEs containing applications for this JVMSERVER were marked as disabled.
Problem conclusion
Improved diagnostics when the timeout has occurred.
Temporary fix
Comments
APAR Information
APAR number
PH38448
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
200
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2021-06-25
Closed date
2021-09-21
Last modified date
2021-10-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI77240 UI77241
Modules/Macros
DFJ@H350
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
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.
[{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.5"}]
Document Information
Modified date:
02 October 2021