After applying JES3 maintenance, USERMOD TT83409 may get SMP/E MODID errors when trying to re-apply TT83409. How do you resolve these MODID errors?

Document ID : KB000053398
Last Modified Date : 14/02/2018
Show Technical Document Details

Description

The ACF2 JES3 interface is implemented as 2 pieces. One is a CA ACF2 provided USERMOD to update the JES3 code directly, the other is to manually add calls into IBM provided JES3 exit points to invoke the CA ACF2 provided JES3 interface programs (modules). (Refer to the CA ACF2 Installation Guide for additional details.)

During the install of CA ACF2, function CX1C009 assembles and links the CA ACF2 provided JES3 interface modules into the JES3 load library. The manually updated IBM JES3 exit modules will invoke these CA ACF2 JES3 interface modules. The IBM JES3 exits are: IATUX28, IATUX29, IATUX33, and IATUX40.

CA ACF2 provides USERMOD TT83409 which updates JES3 source and macro elements to insert the CA ACF2 JES3 interface calls. TT83409 is located in member JES3U313 of the CA ACF2 provided ACFPTFS library.

When applying IBM JES3 maintenance, there are 2 distinct events that need to be addressed.

  1. Re-assemble and re-link the ACF2 JES3 interface code that is invoked from the JES3 exits. This is most easily accomplished by running the CA ACF2 provided sample job JXBUMJ3, found in the CA ACF2 provided SAMPJCL library, which applies the CA ACF2 provided dummy USERMOD (UMJ3999) that forces the re-assembly of the CA ACF2 JES3 modules; ACFCSCAN, ACFINWKG, ACFJBEOR, ACFJBINT, ACFUSX01, ACFUSX02, and ACFUSX03. This step is necessary when the IBM JES3 maintenance modifies any of the macros invoked by the CA ACF2 JES3 interface modules. It is best to just automatically perform this step whenever IBM JES3 maintenance is installed.


  • The CA ACF2 USERMOD TT83409 may be impacted by the IBM JES3 maintenance, seen as SMP/E MODID errors when attempting to apply the IBM JES3 maintenance.


When applying IBM maintenance that impacts any site installed USERMODs, it is considered standard convention to perform the following steps.

  1. The initial APPLY CHECK of the IBM maintenance will identify if any site installed USERMODs were impacted.


  • Run an SMP/E job to RESTORE the USERMOD to return the impacted elements to their pre-modified form.


  • Continue with the IBM maintenance process to APPLY the IBM maintenance.


  • Run an APPLY CHECK for the site USERMODs, this will identify any MODID errors, where the USERMOD is not accounting for the new IBM maintenance.


  • Update the USERMOD, adding the identified IBM SYSMODS (from item 4) to the PRE of the USERMOD.


  • REJECT the original USERMOD and RECEIVE the newly updated USERMOD.


  • Run an APPLY CHECK for the USERMOD to ensure there are no more SMP/E conflicts.


  • When there are no identified problems or issues (from item 7), then APPLY the USERMOD.


  • NEVER ACCEPT site installed USERMODs.
  • When applying IBM JES3 maintenance, if any of the IBM JES3 source elements referenced by TT83409 have been changed by the IBM maintenance, then TT83409 will have to be updated to include a PRE statement to acknowledge the new IBM maintenance.

    Solution

    When applying IBM JES3 maintenance, if any of the IBM JES3 source elements referenced by TT83409 have been changed by the IBM maintenance, then TT83409 will have to be updated to include a PRE statement to acknowledge the new IBM maintenance.

    Here is an example:

    • These IBM JES3 PTFs are flagged with SMP/E MODID errors due to TT83409: UA34876, UA34887, UA35246, UA35552, UA37770, UA38429, UA39487, UA40823, UA40981 and UA43047.


  • Restore TT83409.


  • Continue to apply the IBM JES3 maintenance.


  • After the IBM JES3 maintenance is applied, update TT83409 to add (or update) the PRE statement  (if you do not perform this update, the APPLY of TT83409 will fail due to SMP/E MODID errors.):


++USERMOD(TT83409) .....
.....
++VER(Z038) FMID(HJS7730)                        
  SUP(TP85231 TT83378 TT83408 TT93664) 
  PRE(
       UA34876 UA34887 UA35246 UA35552 UA37770 
       UA38429 UA39487 UA40823 UA40981 UA43047  
     ) .
++MACUPD(..... 
.....


  • REJECT TT83409 (remove old version from SMP/E) and RECEIVE the updated TT83409.


  • APPLY CHECK TT83409 to ensure there are no other conflicts (errors).


  • When there are no more conflicts, APPLY TT83409.