Troubleshooting
Problem
APAR OA59665 / UJ03635 is a JES2 toleration PTF, which includes the following HOLD(MULTSYS) information: This PTF must be installed and active on all members of a JES2 MAS before APAR OA58190 can be applied to any z/OS2.4 (HJE77C0) member within that MAS.
However, the preREQ chain of UJ03635 can include PTFs that require the inclusion of OA58190; thereby contradicting the instruction of the MULTSYS.
Attempting to apply OA59665 / UJ03635 with an EXCLUDE of OA58190 / UJ03971 results in GIM30204E and GIM35905I error messages.
Symptom
GIM30204E ** APPLY PROCESSING FAILED FOR SYSMOD UJnnnnn
GIM35905I PREREQUISITE SYSMOD UJ03971 WAS EXCLUDED.
Cause
The preREQ chain of UJ03635 can include PTFs that require the inclusion of OA58190, which contradicts the instructions of the OA59665 HOLD(MULTSYS).
Environment
Installations running JES2 V2R4 attempting to APPLY OA59665 / UJ03635
Diagnosing The Problem
If you are attempting to apply UJ03635 and receiving messages such as GIM30204E, GIM35905I, or nonzero SMP/E return code, then review if the APPLY is pulling in UJ03971 due to its preREQ chain.
Resolving The Problem
Updated on 06/29/2022 as the result of creation of APAR OA63458. OA63458 delivers an external one-way switch (default off) that controls when JES2 attempts to create the new checkpoint structures associated with JES2 Policy Function. OA63458 must be installed at the same time as OA58190. By installing these PTFs together, installations can disregard the HOLD(MULTSYS) identified in OA59665 and OA58190 and instead apply the maintenance in rolling fashion, member by member. When all members have OA59665 applied, the external switch can be turned on to enable the JES2 Policy Function. The addition of this switch will greatly ease the installation requirements of OA58190 and OA59665, by allowing them to be applied together in rolling fashion with OA63458.
Alternatively, installations can still install the maintenance through the original options listed.
There are 3 suggested ways to apply the maintenance.
1. Install all requisite maintenance via two separate waves rolled throughout the JES2 multi-access spool (MAS).
- APPLY UJ03635 / OA59665 with an explicit EXCLUDE of UJ03971 / OA58190 and BYPASS of OA59714, OA60486 such as
APPLY CHECK
SELECT(UJ03635)
NOJCLINREPORT
EXCLUDE(UJ03971)
BYPASS(HOLDSYS,HOLDERROR(CA59714,CA60486)) GROUP.
SELECT(UJ03635)
NOJCLINREPORT
EXCLUDE(UJ03971)
BYPASS(HOLDSYS,HOLDERROR(CA59714,CA60486)) GROUP.
- Roll this maintenance to all MAS members to fulfill the HOLD(MULTSYS). At this time, installations could be exposed to the scenarios described by OA59714 and OA60486 until the second wave of maintenance is applied.
- After all MAS members have OA59665 applied, APPLY a second wave of maintenance to all MAS members including OA58190, OA59714, OA60486.
2. Install all requisite maintenance through two separate waves rolled throughout the JES2 multi-access spool (MAS).
- Contact IBM JES2 Support for a ++APAR containing the UJ03635 / OA59665 SOURCE update.
- Apply the ++APAR as a SOURCE update to your current level of JES2.
-
Roll this maintenance to all MAS members to fulfill the HOLD(MULTSYS).
- After all MAS members have the OA59665 source code applied, you can APPLY other JES2 maintenance including OA58190 as you see fit.
3. APPLY all maintenance including OA59665, OA58190, and their respective preREQs in one single wave of maintenance by taking down all MAS members at the same time (all-member WARM start). APPLY all of the maintenance to each member as it starts/joins the MAS. In this, there is no time at which an active MAS member exists that does not have OA59665 applied.
Document Location
Worldwide
[{"Line of Business":{"code":"LOB56","label":"Z HW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG90","label":"z\/OS"},"ARM Category":[{"code":"a8m0z0000000A0HAAU","label":"z\/OS-\u003EJES-\u003EJES2"}],"ARM Case Number":"TS004994480","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.4.0"}]
Was this topic helpful?
Document Information
Modified date:
08 December 2022
UID
ibm16414775