PK92513: IQC7003E, IQC6903I AND IQC6709E RECEIVED WHEN MESSAGE QUEUE USAGE CROSSES A PARTITION BOUNDARY

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The following error messages were received when MSG queue
  crossed a partition boundary:
  In the IMS CTL region:
  IQC6903I QCF EXTENSION SEND OF PROCNAME, TO QCF SERVER WAS
          SUCCESSFUL
  IQC6709E QCF EXTENSION UNABLE TO NOTIFY CLIENT WITH MEMBER NAME
           OF ID51$WTO WITH BAD AWE FUNCTION CODE ERROR MSG
  In the QCF server:
  IQC7003E - RC=0010 QCF CRITICAL ERROR IN MODULE IQCZREQ0
             RC=00000048,RSN=INVLDMEM
  IQC7003E - RC=0010 QCF CRITICAL ERROR IN MODULE IQCZRSP0
             SRCHZCIB RC=00000000,RSN=NOTFCLNT
  
  This occurs when the Queue Space Notification ( QSN ) table is
  loaded from a member when IMS starts up. The member does not
  have a PROCNAME card.
  
  Keywords: MSGIQC7003E MSGIQC6903I MSGIQC6709E
  

Local fix

• Add the PROCNAME card to the member before loading it at IMS
  start to look like this:
    function QC_LTBL
    JOBSCARD ID51QSNBID51QSNCID51QSNDID51QSNU
    PROCNAME                 <------ be sure this card is here
    AREAA    060N060N060N060N060N060N060N060N060N060N060N060N
    .
    .
    .
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of QCF3.1 which use jobs to change the *
  *                 A,B,C U thresholds - and put jobnames in the *
  *                 table to be started on crossing the          *
  *                 thresholds, but do not put PROCNAME          *
  *                 control card with blanks for member names.   *
  *                 If the PROCNAME control card is missing      *
  *                 in the input control statement stream - the  *
  *                 PROCNAMEs in the table remain x'00000000'    *
  *                 and are accepted by the programs for real    *
  *                 QCF 3.1 server procedure names - they fail   *
  *                 to start and error message show.             *
  ****************************************************************
  * PROBLEM DESCRIPTION: Some users use batch jobs to change the *
  *                      QTU and QTL and user threshold values.  *
  *                      If the jobstream does not contain       *
  *                      PROCNAME control card - the QCF3.1      *
  *                      server procedure members in the table   *
  *                      are not set to blanks or to the values  *
  *                      in the control card, but they remain    *
  *                      x'00000000'. The programs that start    *
  *                      server or JCL procedures on crossing    *
  *                      the thresholds are checking for blanks, *
  *                      and if not a blank or default dummy     *
  *                      name- a valid name is assumed. They     *
  *                      send a message to the server to start   *
  *                      the member with value of x'00000000' -  *
  *                      and the server issue an error message   *
  *                      that the member is invalid and can not  *
  *                      be found in the PROCLIB library.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The programs are changed :
  -IQCXREAD is changed
  to blank the fields before looking for JOBSCARD and PROCNAME
  control statements in QCFIN:
  function QC_LTBL
  JOBSCARD ID51QSNBID51QSNCID51QSNDID51QSNU
  PROCNAME
  AREAA    060N060N060N060N060N060N060N060N060N060N060N060N
  AREAB    050N050N050N050N050N050N050N050N050N050N050N050N
  AREAC    005N005N005N005N005N005N005N005N005N005N005N005N
  AREAD    000W000W000W000W000W000W000W000W000W000W000W000W
  PERCENTS 050085090Y
  end
  - Control region programs are changed to check for
  X'00000000' when submitting the message  with the member name
  to server
  

Problem conclusion

• Install the maintenance
  

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:

  UK48774

Modules/Macros

• IQCQMREA IQCQMREB IQCQMREX IQCQMRE8 IQCQMRE9
  IQCXREAD
  

Fix information

• Fixed component name

  IMS QUEUE CNTL

• Fixed component ID

  5697E9900

Applicable component levels

• R310 PSY UK48774

     UP09/07/29 P F907

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.