PK99737: OVERFLOW JOB KICKS OFF AND UNLOAD IS SUCCESSFUL TO EMPTY THE QUEUES, BUT NOTHING IS IN THE UNLOAD DATA SET

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• After an overflow job kicks off, the unload is successful and
  the queues are emptied, however nothing is in the unload
  data set. We found this to occur because for each "function"
  statement the data set is reopened and the new unload overlays
  the old content.  See Local Fix for workaround if this occurs.
  

Local fix

• Remove the END and FUNCTION to code all INCLUDES one after
  the other (similar to the following):
  FUNCTION UNLOAD QUEUETYPE=ALL,SBMPUT
  IN       DESTYPE=MSC,
           IMSIDS=*,
           PERCENTDST=01
  
  IN       DESTYPE=LTERM,
           PERCENTDST=15
  
  IN       DESTYPE=TRANS,
           IMSIDS=*,
           PERCENTDST=01
  END
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of QCF3.1                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: If several UNLOAD functions are coded   *
  *                      in a single run , the unload data set   *
  *                      is opened at the start and closed at    *
  *                      the end of each UNLOAD                  *
  *                      function, and at the end of the run it  *
  *                      will contain only messages unloaded     *
  *                      with the last function UNLOAD.          *
  *                      After batch run with next QCFIN contro  *
  *                      statements:                             *
  *                      FUNCTION UNLOAD QUEUETYPE=ALL           *
  *                      IN       DT=APPC                        *
  *                      END                                     *
  *                      FUNCTION UNLOAD QUEUETYPE=ALL           *
  *                      IN       DT=OTMA                        *
  *                      END                                     *
  *                                                              *
  *                      UNLOAD data set will contain only       *
  *                      OTMA messages, if any have been on the  *
  *                      the queues.                             *
  *                      The APPC messages will be lost, because *
  *                      the UNLOAD data set is closed after the *
  *                      first function and reopened for the     *
  *                      next function.                          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The programs have been changed to open the UNLOAD data set for
  the first unload function and to close the data set after all
  functions are executed and the batch job ends.
  
  This APAR includes also next improvements to the samples,
  scripts and messages:
  1.Comments have been added to start up script IQC31 and to the
  sample job for overflow protection data sets allocation
  IQCSTRTJ. The naming convention for the data sets are explained
  and text is added to make more clear each data set name
  component and how to locate the MVS name.
  2.Debugging info is added to server programs to identify the
  member( control region or client) that can not be found in the
  group and the message can not be sent. This info is needed to
  follow the messages that are lost when debugging some processes.
  The changes are valid only if the server runs with DEBUG=Y
  parameter in server start up member.
  

Problem conclusion

• The programs are fixed to preserve unloaded messages from
  several unloadfunctions in a single run. Comments are added to
  samples and scripts toexplain the naming convention for overflow
  protection data sets
  

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:

  UK52764

Modules/Macros

• IQCSTRTJ IQCUNLOD IQCXCTRL IQCXGUN6 IQCZRSP0
  IQC31
  

Fix information

• Fixed component name

  IMS QUEUE CNTL

• Fixed component ID

  5697E9900

Applicable component levels

• R310 PSY UK52764

     UP09/12/11 P F912

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.