IBM Support

PH55306: IDZ ZUNIT THE FIX THAT IMPLEMENTS THE NEW IMS DLI SUBFUNCTION FOR THE INQY CALL DOES NOT WORK

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • In IBM Developer for z/OS - IDz - v16.0, the IBM fix in IMSU to
    get info about the active JVM via a new INQY ENVIRON2 call does
    not work if the ZUnit library is integrated in the step lib
    chaining of the IMSU region
    
    Scenario:
    ZVTP does not support the latest IMS release's version of the
    INQY
    Executing an IBM fix in IMSU- INQY ENVIRON DL/I Call Enhancement
    is calling the usermod DA45098
    But the INQY call ends with an RC != zero. The abend needs to be
    forced
    
    BZUDINQY.asm does not handle the ENVIRON2 new subfunction
    

Local fix

  • Without ZUnit, the ENVIRON2 subfonction delivers the desired and
    expected results
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: 01.Clients using DTR in an IMS environment   *
    *                    with programs that have INQY calls with   *
    *                    subFunction ENVIRON2                      *
    *                 02.Users replaying tests for programs that   *
    *                    call DLL functions with the same name as  *
    *                    the containing DLL                        *
    *                 03.All DTR users making use of the internal  *
    *                    restart feature where CSECTs are involved *
    *                 04.All clients using IBM Z Virtual Test      *
    *                    Platform's Server Extension component     *
    *                 05.All DTR users making use of 'ENTRY' COBOL *
    *                    statement                                 *
    *                 06.All DTR users that need to filter         *
    *                    ELAXMGUX and SPOC utility                 *
    *                 07.sysprog                                   *
    *                 08.sysprog                                   *
    *                 09.Users obtaining the entry address of      *
    *                    statically linked sub-programs or DLL     *
    *                    functions with the BZUGETEP utility       *
    *                 10.All DTR users using the CBLTDLI interface *
    *                    for IMS calls in programs under test      *
    *                 11.CICS users recording with program to      *
    *                    program interception                      *
    ****************************************************************
    * PROBLEM DESCRIPTION: 01.DTR does not properly process IMS    *
    *                         INQY calls that have the new         *
    *                         subFunction ENVIRON2 specified       *
    *                      02.Replay does not find records for DLL *
    *                         functions with the same name as the  *
    *                         containing DLL in the playback file  *
    *                      03.On playback, CICS transactions from  *
    *                         a previous test are executed         *
    *                      04.When generating the DD:BZUMETA data  *
    *                         set during the replay of a recording *
    *                         a S0C4 ABEND occurs when a Severe or *
    *                         Error level message is generated in  *
    *                         the DD:BZUMSG data set               *
    *                      05.DTR cannot record statically linked  *
    *                         ENTRY statement without ALIAS        *
    *                      06.DTR tries to record the IMS Batch    *
    *                         SPOC utility (CSLUSPOC)              *
    *                      07.BZUVERS to report registration info  *
    *                      08.BZUVERS writes to DD DD SYSOUT       *
    *                         instead of SYSPRINT                  *
    *                      09.BZUGETEP always returns the main     *
    *                         entry point of the load module or    *
    *                         program object instead of the entry  *
    *                         point of the requested CSECT         *
    *                      10.CBLTDLI GN (getNext) does not return *
    *                         any data in zUnit                    *
    *                      11.Incorrect parameter length used      *
    ****************************************************************
    01.Dynamic Test Runner does not properly process IMS INQY calls
       that have the new subFunction ENVIRON2 specified
    02.Replay does not find records for DLL functions with the same
       name as the containing DLL in the playback file. Warning
       message BZUP240W is issued, input to the function is not
       verified, and no response from the function is set
    03.On playback, CICS transactions from a previous test might be
       executed instead. This due to the restart condition being
       triggered when program records remained that matched on load
       module but not on CSECT name.
    04.The Dynamic Test Runner's data gathering component for
       metadata to populate the JSON file intended for Server
       Extension fail with a S0C4 abend when a Severe or Error level
       message is encountered during replay of a recording data set
    05.Dynamic Test Runner cannot record statically linked ENTRY
       statement without ALIAS
    06.Dynamic Test Runner tries to record the IMS Batch SPOC
       (Single Point of Control) utility (CSLUSPOC) which is used to
       define resources to IMS or query existing. The SPOC utility
       is NOT an application program.
    07.BZUVERS will now report product registration information on
       top of the existing build date & APAR
    08.BZUVERS writes to DD DD SYSOUT instead of SYSPRINT
    09.BZUGETEP always returns the main entry point of the load
       module or program object
    10.CBLTDLI GN (getNext) does not return any data in zUnit
    11.Incorrect parameter length used resulting in too much data
       being recorded, leading to buffer overrun on replay
    

Problem conclusion

  • 01.DTR was modified to allow the INQY call to process
    02.Code corrected
    03.Added a check for CSECT name in determining whether the
       restart test condition should be set
    04.Installing this update eliminates the system error S0C4 when
       generating the DD:BZUMETA data set allowing Server Extension
       to process properly
    05.Added secondary search for labels matching intercept
       statement after search for CSECT fails
    06.The mentioned services now are filtered
    07.This enhancement allows to see the report registration of DTR
    08.Now SYSOUT is being used and not SYSPRINT
    09.Code corrected
    10.DTR was recording Cobol Dynamic call program names for IMS
       records instead of the program under test. Added secondary
       check for these cases and stepped back one DSA level to get
       the proper program name. With the proper name, the test case
       exit program names will match and data will be returned.
    11.Code corrected
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH55306

  • Reported component name

    DEV FOR Z/OS

  • Reported component ID

    5724T0700

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2023-06-21

  • Closed date

    2023-10-17

  • Last modified date

    2023-11-01

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UI94049

Modules/Macros

  • BZU1SMPE BZU2EXEC BZU2LAYR BZU2THIN BZU2TLYR BZU3ALOC BZU6DDEF
    BZUACAF@ BZUACP   BZUADSMF BZUAEIN@ BZUAETR@ BZUAINIT BZUAIP2
    BZUAIPI  BZUAIPS  BZUAIPX  BZUALLOC BZUAPIPI BZUAPRC2 BZUAPRCA
    BZUAPRCD BZUAPRCX BZUAPRH@ BZUAPRS@ BZUARGID BZUARRS@ BZUARSMF
    BZUARST0 BZUARST1 BZUARST2 BZUARST3 BZUARST4 BZUARST5 BZUARST6
    BZUARST7 BZUARST8 BZUARST9 BZUASSRT BZUASTB0 BZUASTB1 BZUASTB2
    BZUASTB3 BZUASTB4 BZUASTB5 BZUASTB6 BZUASTB7 BZUASTB8 BZUASTB9
    BZUASTC0 BZUASTC1 BZUASTC2 BZUASTC3 BZUASTC4 BZUASTC5 BZUASTC6
    BZUASTC7 BZUASTC8 BZUASTC9 BZUASTMD BZUASTMP BZUASTUB BZUASTUC
    BZUAVRDT BZUBATCH BZUBCON@ BZUBCP   BZUBDSC@ BZUBSRV@ BZUCBCBL
    BZUCBPL1 BZUCCDFN BZUCCINT BZUCCOLL BZUCDEFN BZUCF410 BZUCF420
    BZUCF510 BZUCF520 BZUCF530 BZUCF540 BZUCF550 BZUCF560 BZUCF610
    BZUCI410 BZUCI420 BZUCI510 BZUCI520 BZUCI530 BZUCI540 BZUCI550
    BZUCI560 BZUCI610 BZUCICPT BZUCICSA BZUCICSL BZUCICSN BZUCICSS
    BZUCICST BZUCICSW BZUCICSX BZUCIDFN BZUCIDRI BZUCIDRP BZUCIDRR
    BZUCIDRS BZUCIDRT BZUCO410 BZUCO420 BZUCO510 BZUCO520 BZUCO530
    BZUCO540 BZUCO550 BZUCO560 BZUCO610 BZUCODES BZUCPLTI BZUCPLTS
    BZUCPLTT BZUCRECS BZUCRECT BZUCSD   BZUCSTUB BZUDB2CA BZUDB2CP
    BZUDB2CV BZUDB2PA BZUDB2PP BZUDB2PV BZUDB2ST BZUDCP   BZUDLAYR
    BZUDTHIN BZUDTLYR BZUDYNAL BZUECP   BZUEIBPL BZUESPIE BZUESPR@
    BZUESTAE BZUGETEP BZUGTARG BZUGTMEM BZUHFIO@ BZUHFIOH BZUHFIOP
    BZUHPRN@ BZUII410 BZUII420 BZUII510 BZUII520 BZUII530 BZUII540
    BZUII550 BZUII560 BZUII610 BZUIMSSB BZUIMSSE BZUIMSSF BZUIMSTR
    BZUIMSVN BZUIMSVR BZUINCL  BZUIO410 BZUIO420 BZUIO510 BZUIO520
    BZUIO530 BZUIO540 BZUIO550 BZUIO560 BZUIO610 BZUISVI0 BZUITERC
    BZUITERP BZUJFIOH BZUJFIOP BZUKFIO@ BZUKFIOH BZUKFIOP BZULCEE
    BZULDB2  BZULEOPT BZULFIOH BZULFIOP BZULIMS  BZULLE   BZULMQ
    BZUMCP   BZUMETA  BZUMSGEN BZUPBCP  BZUPBMP  BZUPDB2  BZUPDCP
    BZUPDLI  BZUPECP  BZUPLAY  BZUPMCP  BZUPPLAY BZUPRH00 BZUPRH0@
    BZURCP   BZURI410 BZURI420 BZURI510 BZURI520 BZURI530 BZURI540
    BZURI550 BZURI560 BZURI610 BZURO410 BZURO420 BZURO510 BZURO520
    BZURO530 BZURO540 BZURO550 BZURO560 BZURO610 BZURPLAY BZURRCP
    BZURTCP  BZURUN   BZUSCFG  BZUSCP   BZUSETUP BZUSLAYR BZUSTLYR
    BZUSUDSN BZUSYSIN BZUTCP   BZUTRACE BZUUFIOH BZUUFIOP BZUUMODC
    BZUUMODD BZUUMODI BZUUMODL BZUVERS  BZUVFIOH BZUVFIOP BZUVRM
    

Fix information

  • Fixed component name

    DYNAMIC TEST RU

  • Fixed component ID

    5724T0763

Applicable component levels

  • R100 PSY UI94049

       UP23/10/21 P F310

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.

[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SG19M"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"100"}]

Document Information

Modified date:
02 November 2023