PQ02466: SQTT PARAMETER NOT DETECTED WHEN SPECIFIED ON DFSVSMXX PROCLIB MEMBER

APAR status

• Closed as program error.

Error description

• SQTT parameter is not detected when specified on DFSVSMxx
  proclib member.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS/ESA 6.1 users that use DFSVSMxx to   *
  *                 set traces.                                  *
  ****************************************************************
  * PROBLEM DESCRIPTION: SQTT parameter not detected on the      *
  *                      DFSVSMxx proclib member.                *
  *                      Also, table trace parameters not        *
  *                      recognized on an input card in the      *
  *                      DFSVSMxx proclib member after a         *
  *                      parameter that is not valid for the     *
  *                      current environment.                    *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
    The SQTT parameter (which requests the shared queues trace)
  is not recognized when specified on the DFSVSMxx proclib
  member.
    Also, when a table trace is requested on an input card in
  the DFSVSMxx proclib member and that table trace is not valid
  for the current environment (i.e. requesting the LRTT trace in
  a non-RSR environment), all table traces following the invalid
  trace are ignored.  An example of this is the following:
  
          OPTIONS,LRTT=HIGH,DL/I=OUT,DISP=HIGH
  
    In the above OPTIONS card, the DL/I and DISP traces would
  not be activated by the DFSVSMxx proclib member in an non-RSR
  environment.
  

Problem conclusion

• SDB: LVLS/610 AR610 AR600
   AIDS: RIDS/SYS RIDS/INIT SYS INIT
    DEP: NONE
    GEN:
  
  *** END IMS KEYWORDS ***
    Both of these problems are fixed by changes to DFSTRAI0.
  
    The first problem was caused by a check being made for the
  existence of the DFSSQM block before allowing the SQTT trace
  to be activated (if the block did not exist it is not a
  shared queues environment).  The problem is that this block
  is not allocated in a shared queues environment at the time
  the DFSVSMxx proclib member is processed.  The fix is to
  remove the check for the DFSSQM block and allow the trace to
  active even in a non-shared queues environment.
  
    The second problem occurs because when a valid parameter is
  found (i.e. LRTT), but the parameter is not valid for the
  current environment (i.e. non-RSR for the LRTT trace table),
  the current position on the input card is not updated to be
  past the current parameter.  The fix for the problem is to
  move the code that bumps the current position on the input
  card so that it is always executed (instead of only when the
  parameter itself is invalid).
  
    While reviewing this APAR, it was discovered that there were
  a number of potential 0C4's in the code that parsed the input
  card.  When the input parameters were being validated, it was
  possible to look past the end of the input card.  Checks were
  added to ensure that this is not done.
  
  ***********************
  * PUBLICATION CHANGES *
  ***********************
  
    Change the explanation for message DFS3616I to the
    following:
  
     Explanation:  IMS encountered an invalid trace table
     option statement for the cccc trace table. The valid
     options are listed in the IMS/ESA V6 Install Volume 2.
  
      The change removes any references to the actual valid
    parameters and instead refers to the Install Guide Vol 2.
  

Temporary fix

Comments

APAR Information

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

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

  UQ03615

Modules/Macros

• DFSTRAI0
  

Fix information

• Fixed component name

  IMS V6

• Fixed component ID

  565515800

Applicable component levels

• R600 PSY UQ03615

     UP97/04/17 P F704