Problems that can occur when QMF is not using current load modules

Unexpected behavior, as well as errors or warning messages when initializing QMF or connecting to a remote database, can happen when QMF initializes with modules from one or more prior releases.


Follow these steps to check whether QMF is initializing with the correct load modules:

  1. Issue the command SHOW GLOBALS and check the value of the DSQAO_QMF_VER_RLS variable. The value of this variable for QMF Version 13 Release 1 is QMFV13R1.0.

    If the variable value is not what you expect, it is likely that, during the initialization process, QMF is accessing load modules from prior releases. Depending on how you allocate the SDSQLOAD library, the load modules that QMF is accessing during initialization might be in an unexpected data set, the linklist, or the LPA.

  2. Determine the level of load modules that QMF is accessing. How you complete this step depends on whether you are able to start QMF.
    • If you are able to start QMF:
      1. Start the program with a value of ALL for the DSQSDBUG parameter.
      2. After you run the trace, review any resulting trace output. QMF Version 13.1 modules are associated with the eyecatcher V13R1.00 in the QMF trace. For example:
        ---------      ****** 09/12/22  10.25.52 ******  ------------ 
                 DSQCPARM:Applied Service Level                  (1) 
        34347370 DSQCABND V13R1.00     09/09/16 13:36 WIM11328       
        343476C8 DSQCADJM V13R1.00     09/09/16 13:36                 
        345F50C8 DSQCAVAR V13R1.00     09/09/16 13:36 WIM11266       
        3464D8D0 DSQCBDSS V13R1.00     09/09/16 13:36  WIM7688       
        34347E88 DSQCBMPA V13R1.00     09/09/16 13:36                 
        34349290 DSQCBOR  V13R1.00     09/09/16 13:36 WIM11215       
        346B69D8 DSQCB64C V13R1.00     09/09/16 13:36 WIM11525     
    • If you are unable to start QMF:

      Inspect any resulting dump output (such as SYSUDUMP, DSQUDUMP, or SYSMDUMP output) for the version and release information. Verify that the eyecatcher that is associated with all the QMF modules is be the same. QMF Version 13.1 modules are associated with the eyecatcher V13R1.00, as shown in the preceding example.

  3. If you find that the QMF initialization process is using load modules from one or more prior releases instead of the current release, determine the location from which the load modules are being accessed.
    • If you are running QMF for TSO under ISPF, you can use the ISPF ISRDDN diagnostic utility to obtain information about file allocations for the QMF load modules. ISRDDN is a utility that provides a list of allocated ddnames within a TSO user's address space. Thus, how you use this facility to view QMF file allocations depends on how these allocations are done. For example, if your QMF file allocations are done through ISPF, you can issue the following command from within QMF: TSO ISRDDN. The command returns a list of current data set allocations. Browse the list and check that all data sets are being accessed from the correct locations. For sample allocations for the data sets, see the following information: The default data set prefix for QMF Version 13.1 data sets is QMF1310. Your data set prefix for the QMF Version 13.1 load modules might be different.

      If you find allocations that are not pointing to the QMF Version 13.1 libraries, change these allocations to point to the correct locations.

    • You can also use the ISRDDN utility to retrieve allocation information for specific modules and optionally browse the modules if necessary. For example, you can issue the following command to determine the location from which the DSQQMF module was loaded and optionally browse the module: TSO ISRDDN MEMBER DSQQMF

      Be sure that the DSQQMF module is being accessed from the expected location and that it contains the version and release identifiers that you expect. For example, the following output shows that the DSQQMF module was loaded from the QMFCOM.QMF1310.SDSQLOAD data set, which was accessed via ddname DSQLLIB. The specific name of your QMF data sets will vary.

      If the QMF Version 13.1 data set prefix you chose does not include the version and release information, use the following command to browse the DSQQMF load module to help you determine this information: TSO ISRDDN BROWSE DSQQMF

      For QMF Version 13.1, verify that the eyecatcher matches V13R1.00, as shown in the following figure. The date, time, and service level of the module can vary depending on which PTFs were applied.

      Figure 1. Using the ISRDDN utility to browse the DSQQMF module to obtain version and release information
       BROWSE    DSQQMF JPA Start:34484B48 Size:0038BE10    Line 00000000 Col 001 080
      ********************************* Top of Data *********************************
            +0 (34484B48)   47F0F122 2EC4E2D8 C3C9D5E3 4040E5F1  *       DSQCINT  V1 * 
           +10 (34484B58)   F0D9F14B F0F04040 404040F0 F961F0F9  * 1R1.00     12/12 * 
           +20 (34484B68)   61F1F640 F1F37AF3 F740E6C9 D4F1F1F5  * /16 13:37 WIM125 * 
           +30 (34484B78)   F9F840D3 89838595 A2858440 D481A385  * 33 Licensed Mate * 
           +40 (34484B88)   99898193 A2406040 D7999697 8599A3A8  * rials - Property * 
           +50 (34484B98)   40968640 C9C2D440 F5F6F3F5 60C4C2F2  *  of IBM 5615-DB2 * 
           +60 (34484BA8)   6B40F5F6 F0F560C4 C2F2404D C35D40C3  * , 5697-P43 (C) C * 
           +70 (34484BB8)   9697A899 898788A3 40C9C2D4 40C39699  * opyright IBM Cor * 
           +80 (34484BC8)   974B40F1 F9F8F26B 40F2F0F1 F04B40C1  * p. 1982, 2013. A * 
           +90 (34484BD8)   939340D9 898788A3 A240D985 A28599A5  * ll Rights Reserv * 
           +A0 (34484BE8)   85844B40 E4E240C7 96A58599 95948595  * ed. US Governmen * 
           +B0 (34484BF8)   A340E4A2 8599A240 D985A2A3 998983A3  * t Users Restrict * 
           +C0 (34484C08)   858440D9 898788A3 A2406040 E4A2856B  * ed Rights - Use, * 
           +D0 (34484C18)   4084A497 93898381 A3899695 40969940  *  duplication or  * 
           +E0 (34484C28)   8489A283 9396A2A4 99854099 85A2A399  * disclosure restr * 
           +F0 (34484C38)   8983A385 844082A8 40C7E2C1 40C1C4D7  * icted by GSA ADP * 
          +100 (34484C48)   40E28388 8584A493 8540C396 95A39981  *  Schedule Contra * 
          +110 (34484C58)   83A340A6 89A38840 C9C2D440 C3969997  * ct with IBM Corp * 
          +120 (34484C68)   4B4090EC D00C187F 41807FFF 41908FFF  * -----------------* 
       Command ===>                                                  Scroll ===> PAGE