BMC AMI Ops Automation for Batch ThruPut: "IEW2454W SYMBOL UNRESOLVED" message occurs during link-edit of DTMJ2SVn or DTMJ2MVn load module(s).

Knowledge Article

BMC AMI Ops Automation for Batch ThruPut: "IEW2454W SYMBOL UNRESOLVED" message occurs during link-edit of DTMJ2SVn or DTMJ2MVn load module(s).
The re-assembly and re-link of the ThruPut Manager source stubs (DTMJ2MVn, DTMJ2SVn) should complete with RC=0. This article explains what to do when the re-link causes "IEW2454W SYMBOL UNRESOLVED" warning message(s).
BMC Compuware ThruPut Manager Standard Edition
Customers are required to Synchronize JES2 and BMC ThruPut Manager following the APPLY of z/OS maintenance which updates JES2 macros.

Performing the re-assembly and re-link of the ThruPut Manager source stubs (DTMJ2MVn, DTMJ2SVn) in SMP/e ensures that the correct datasets are used. When the re-assembly/re-link is done outside of SMP/e using the sample JCL shipped in INSTALL(I$JESLK2), the customer must supply a SYSLIB DD concatenation for the assembly and a SYSLMOD DD allocation for the DTMLINK library containing the existing DTMJ2MVn and DTMJ2SVn load modules. If the incorrect SYSLIB or SYSLMOD are supplied, the assembly and/or link may complete with warnings or errors.

In the example below, the link-edit of load module DTMJ2SV7 failed because the symbol for JES2 exit routine DTMOMX36 could not be resolved:

z/OS V2 R4 BINDER     14:27:25 WEDNESDAY SEPTEMBER  4, 2024
BATCH EMULATOR  JOB(I$JESLP1) STEP(LPALIB  ) PGM= HEWLH096
IEW2278I B352 INVOCATION PARAMETERS - XREF,LIST,LET,NCAL,RENT,REFR
IEW2322I 1220  1    INCLUDE OBJ
IEW2322I 1220  2    INCLUDE SYSLMOD(DTMJ2SV7)
IEW2322I 1220  3    ORDER   DTMJ2SV7
IEW2322I 1220  4    ORDER   DTMCSMAP
IEW2322I 1220  5    ENTRY   DTMJ2SV7
IEW2322I 1220  6    NAME    DTMJ2SV7(R)
IEW2454W 9203 SYMBOL DTMOMX36 UNRESOLVED.  NO AUTOCALL (NCAL) SPECIFIED.

A review of the assembly for the DTMJ2SV7 source stub shows a LOAD instruction for DTMOMX36:

DTMJ2SV7 Pre-Authorization exit routine (exit 36)
  Active Usings: LMT,R1  BRTRANS,R5  CSVP,R9  HCCT,R11
R-Loc  Object Code    Addr1 Addr2  Stmt   Source Statement                                  HLASM R6.0  2024/09/04 14.27
000466 58F0 C19C            005EC 37156          L     R15,=V(DTMOMX36)    call ThruPut Manager        #V071918 05620012

Submitting the sample JCL shipped in INSTALL(TMVERIFY) with a STEPLIB DD allocating the DTMLINK used in the SYSLMOD DD allocation showed that the existing DTMJ2SV7 load module did NOT contain the required DTMOMX36 module:

//TMDLEVEL EXEC PGM=DTMTMLV8,REGION=0M          
//STEPLIB  DD   DISP=SHR,DSN=HLQ.SYSLMOD.DTMLINK

DTM6578I ADS DISPLAY APARS                                         
LOADMODN CSECT    LEVEL    ASM DATE/TIME  LMOD LOC APAR INFORMATION
DTMJ2SV7 DTMCOPYR                                  NOT SUPPORTED   
         DTMJ2SV7 #V071956 09/04/24/14.27 00000000 NO APARS APPLIED
         DTMOMX08 #V071770 20190904/19.14 0000E7D8 NO APARS APPLIED
         DTMOMX52 $V071809 20191205/16.05 00012EE8 NO APARS APPLIED
         DTMOMX54 #V071808 20191205/16.05 00013880 NO APARS APPLIED
The DTMLINK dataset used in the SYSLMOD DD allocation of the link-edit step contained a version of the DTMJ2SVn load module which did not contain the DTMOMX36 module (a required JES2 exit routine for the DTMSRC(DTMJ2SVn) being used in the assembly step).
Rerun the INSTALL(I$JESLK2) JCL using a SYSLMOD DD allocation that uses the correct DTMLINK dataset. It should be the same dataset as the one used in the linklist for the system where JES2 will initialize with ThruPut Manager load modules and exit routines.
BMC Compuware ThruPut Manager Standard Edition
BMC Compuware ThruPut Manager Standard Edition
Attachment(s):