PM25360: INTRODUCE A NEW QCF OPTION TO THE AREA STATEMENT FOR PARM OSTARTACTION= 11/03/31 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Introduce a new QCF option to the AREA Statement for parm
  OSTARTACTION=.  A requirement request is to implement a STOP
  action against either the source or destination once the total
  number of records for a destination reaches the sepcified "USED"
  percentage of total queue space, when the percent of the total
  queue space used reaches the specified "TOTAL" amount.
  
  This is based off of FITS marketing request: MR041210594
  
  Additional issue addressed:
  After PTF UK66243 (APAR PM31433), on rare occasions, with
  no AREA or no FAIL cards in place an abend0c9 can occur.
  Therefore, UK66243 has been marked PE and this APAR/PTF
  will correct that issue.
  Keywords: S0C9 abends0c9 IQCCQAT8 IQCCQAT9 IQCCQATA
  IQCCQATB IQCCQATC offset x'A4A' A4A
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of QCF3.1 Overflow protection      *
  *                 function.                                    *
  *                 New action  has been added to AREA           *
  *                 OSTARTACTION parameter-JTSTP.                *
  *                 It stops the source of a message, if         *
  *                 the destination for the message has          *
  *                 reached some number, that is calculated      *
  *                 based on total percentage and used           *
  *                 percentage for the AREA.                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: New action  has been added to AREA      *
  *                      OSTARTACTION parameter.                 *
  *                      It has been added in addition to        *
  *                      NONE, ABEND, WTO, STOP, WAIT.           *
  *                      The new action is JTSTP                 *
  *                       OSTARTACTION=JTSTP                     *
  ****************************************************************
  * RECOMMENDATION: Install the APAR.                            *
  ****************************************************************
  New action  has been added to AREA OSTARTACTION
  parameter.
  It has been added in addition to actions NONE, ABEND,
  WTO, STOP, WAIT.
  The new action is JTSTP ---> OSTARTACTION=JTSTP
  
  The JTSTP action results in an A7 status code being
  returned to an IMS process when the Queue Manager
  resources allocated to adestination have exceeded the
  AREA  statement specifications and this process tryes
  to issue message to the exceeded destination.
  The following IMS messages are sent to the different IMS input
  devices:
  VTAM = DFS074 message
  APPC = DFS0777 message
  OTMA = DFS1289 message
  BTAM = DFS074 message
  MSC = DFS1945 message
  Sample:
  AREA=(ID=AREA0005,
        PERCENT=(TOTAL=90,USED=10),
        TYPE=(ALL),
        CSTOPACTION=NONE,
        CSTARTACTION=NONE,
        OSTOPACTION=NONE,
        OSTARTACTION=JTSTP)
  In the following example, the queue threshold is assumed to be
  90 * 10 = 9 percents of the message queue. Lets assume that
  there are 9% messages to some destination issed by  one or
  different sources.
  Each time any source process places a message on a queue
  that has already reached the 9% buffer limit, the A7 status
  code is returned to the IMS application, or one of the DFS
  messages listed above is returned to the appropriate IMS
  terminal source.
  
  Using OSTARTACTION=JTSTP
  ------------------------
  The OSTARTACTION=JTSTP option functions in the same manner as
  the STOP option.
  However, JTSTP does not default to the WTO action. When a queue
  has   reached or exceeded the specified AREA Statement
  threshold, the JTSTP option causes either an A7 status code to
  be returned to the IMS application, or following IMS DFS
  one of the
  messages to be returned to the input device:
  - VTAM  = DFS074 message
  - APPC = DFS0777 message
  - OTMA = DFS1289 message
  - BTAM = DFS074 message
  - MSC = DFS1945 message
  A PCB status code A7 message call indicates that the number of
  output segments inserted has exceeded the limit by one.
  Any further queue manager calls are  prohibited to prevent
  message queue overflow.
  

Problem conclusion

• Install the APAR and use the new JTSTP action in the
  customization member.
  

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:

  UK66611

Modules/Macros

• IQCCCPRM IQCCIN0A IQCCIN0B IQCCIN0C IQCCIN0X
  IQCCIN08 IQCCIN09 IQCCQAL  IQCCQAT  IQCCQATA IQCCQATB IQCCQATC
  IQCCQATX IQCCQAT8 IQCCQAT9 IQCCQCI  IQCC1ENU IQCF21   IQCH91J
  IQCH91JS IQCIMSII IQCI00   IQCP91JS IQCP91JX IQCQMRGA IQCQMRGB
  IQCQMRGC IQCQMRGX IQCQMRG8 IQCQMRG9 IQCSBMPS IQCSIN10
  

Fix information

• Fixed component name

  IMS QUEUE CNTL

• Fixed component ID

  5697E9900

Applicable component levels

• R310 PSY UK66611

     UP11/04/13 P F104 Ø

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.