PK59504: CONSISTENT CODES ARE NOT BEING RETURNED FROM BATCH FUNCTIONS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• No consistent codes are returned from batch functions. There's a
  need to pass back to the job step consistant QCF return codes.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users f QCF3.1                           *
  ****************************************************************
  * PROBLEM DESCRIPTION: Batch step ends  with RC=00 in all      *
  *                      cases. Message IQC4998I is issued if no *
  *                      error has been deected, message         *
  *                      IQC4999E is issued when some error is   *
  *                      detected. In message IQC4999E there are *
  *                      return codes from IQCXCTRL, SCI         *
  *                      requests and IMS requests, but these    *
  *                      codes are not communicated to job step  *
  *                      and job step ends with RC=00.           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Programs have been changed to communicate the errors to the job
  step and job step ends with different return codes. Return codes
  and possible reasons are in following table ( the table will be
  included in User's guide ):
   Return Codes
   The following Return Codes are also reflected in the:
     Batch Job as the Cond Code,
     Batch Job Report Output for those Batch Jobs that generate a
   and in
     One of the following messages
   o IQC7003E
   o IQC7006E
   o IQC4999E.
  
   For clarification of where the Return Code is placed in the abo
   messages, please see the explanation for these messages (in the
   following pages  (or) a connector pointing to chapter 17 Messag
   Codes if not part of messages and codes)
  RETURN CODE             MEANING
  
  00(X'00')   JOB SUCCESSFUL
  
     1. FUNCTIONS QUERY/BROWSE/UNLOAD/RECOVER SUCCESSFULY
  COMPLETED. AIB RETURN CODE AND AIB  REASON CODE ZERO.
     2. FUNCTION LOAD- NO REQUEST FOR MESSAGES TO BE SENT TO
  SCRAP LOG.
     3.FUNCTION LOAD - REQUEST FOR MESSAGES TO BE SENT
   SCRAP LOG AND ONLY REQUESTED MESSAGES SENT TO  CRAP LOG.
     4.FUNCTION LOAD - SPECIFYING CERTAIN TYPES OF  MESSAGES
   LOADED, THEY ARE LOADED, ALL OTHER  MESSAGES GO TO SCRAP LOG
  
   04(X'04')   JOB SUCCESSFUL
  
      1.FUNCTION LOAD- NO REQUEST FOR MESSAGES TO BE SENT TO
   HOWEVER MESSAGES WERE SENT TO SCRAP LOG.
     2.FUNCTION LOAD - SPECIFYING CERTAIN TYPE OF MESSAGES TO
  BE LOADED, OTHER MESSAGES TO GO TO SCRAP LOG. HOWEVER SOME
  MESSAGES THAT SHOULD BE LOADED GO TO SCRAPLOG.
     3.FUNCTION LOAD- UNABLE TO OPEN SCRAPLOG DATA SET.
     4.FUNCTIONS BROWSE/UNLOAD/RECOVER- UNABLE TO OPEN
  BROWSE/UNLOAD/RECOVER DATA SETS.
     5.FUNCTION RECOVER FOR SHARED QUEUES- THERE ARE NO
  MESSAGES ON COLD QUEUE.
  
  08(X'08')   JOB FAILS
  
     1.PARSE QCFIN DD CARD FAILED
     2.FUNCTION RECOVER- FUNCTION IS EXECUTED IN NON-SHARED QUEUE
  ENVIRONMENT
     3. IMS ADDRESS SPACE IS DOWN AFTER REQUESTED FUNCTION HAS
  STARTED.
     4. SCI ADDRESS SPACE IS DOWN AFTER REQUESTED FUNCTION HAS
  STARTED
     5 .NO RACF AUTHORIZATION FOR REQUESTED FUNCTION OR  DATA
  SETS
  
  12(X'0C')   JOB FAILS
  
     1.UNABLE TO OPEN QCFIN OR QCFPRINT DATA SETS
     2.FUNCTION LOAD- UNABLE TO OPEN LOAD DATA SET
  
  16(X'10')  JOB FAILS
  
     1. NO SCI ADDRESS SPACE
     2. NO IMS ADDRESS SPACE
     3.NONZERO RETURN CODES FROM SCI REQUESTS
     4.IMS IS NOT RESPONDING AND SERVER TIMES OUT IMS.
  

Problem conclusion

• Programs have been changed to communicate the return code to the
  job step.
  

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:

  UK33998

Modules/Macros

• IQCBCVC0 IQCBIN10 IQCBMST0 IQCINI0$ IQCLOAD0
  IQCM1ENU IQCM2ENU IQCP0000 IQCQUERY IQCUNLOD IQCXCTRL IQCXSEL6
  IQCXTIOT IQCZIN10 IQCZMST0 IQCZQAB  IQCZXNF0
  

Fix information

• Fixed component name

  IMS QUEUE CNTL

• Fixed component ID

  5697E9900

Applicable component levels

• R310 PSY UK33998

     UP08/02/26 P F802

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.