PH29277: CSQ4RCH1 (CSQ4TCH2) ISPLINK( "TBGET ", MSG_TABLE ) RETURNS RC=8

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• RC=8 returned while using CSQ4RCH1 with C load module to browse
  specific message in queue.
  The code that return the error is CSQ4TCH2
  =======================
  retCode = ISPLINK( "TBGET   ", MSG_TABLE );
  =======================
  Explaination of this error code:
  RC=8
      Keyed tables: The row specified by the value in the key
  variables does not exist in any row after the current row
  pointer, the CRP is set to TOP (ZERO).
      Non-keyed tables: the CRP was at TOP and remains at TOP.
  
  Symptoms:
  1. When the queue contains less than 11 messages, browse will
  be failed for No. 1 - No. 9 messages. The No.10 message can be
  browsed.
  2. When there are 11 - 21 messages,  No. 01 message and No. 10
  - 21 can be viewed. However the No.01 message is actually the
  11th message while checking the msgID.
  3. Similar pattern while there are 22-98 messages.
  4. When there are 99 or above messages, all message can be
  browsed but No.1 - No.9 message are No.19 - No.99 message.
  

Local fix

• Use COBOL load module or QLOAD
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 1 Modification 0 and Release 2       *
  *                 Modification 0.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: When using the CSQ4RCH1 sample to get   *
  *                      messages from a queue, when choosing a  *
  *                      message from the message list either:   *
  *                                                              *
  *                      - The sample exits with error:          *
  *                      "Message table handling error.          *
  *                       Return Code: 8"                        *
  *                      or                                      *
  *                      - A different message is returned.      *
  ****************************************************************
  An error in the declaration of the variables used in CSQ4TCH2 to
  identify the requested message to ISPF, caused an incorrect
  message number to be requested. This resulted in this incorrect
  message being returned, or if it did not exist, the sample
  failing with the reported error.
  

Problem conclusion

• The declaration of the variables in CSQ4TCH2 has been corrected.
  

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:

  UI73261 UI73262

Modules/Macros

• CSQ4TCH2
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R100 PSY UI73262

     UP21/01/28 P F101

• R200 PSY UI73261

     UP21/01/28 P F101

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.