PK78922: SUPPORT TO CHECK QUALIFIERS FOR THE SECOND SSA OR LATER IN USING THE LOAD API. MR0116093512.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Load API inserts a segment at an unexpected position if a
  qualified SSA is specified for the second SSA or later and the
  key value specified in the qualifier is incorrect.  This occurs
  because Load API ignores qualifiers for the second SSA or later.
  This is a restriction of Load API, and this APAR removes the
  restriction.  MR0116093512
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM IMS High Performance Load   *
  *                 for z/OS Version 2 Release 1 (FMID=H1IM210)  *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables to check qualifiers   *
  *                      for the second SSA or later in using    *
  *                      the Load API.                           *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  As a restriction of Load API, qualifiers for the second SSA or
  later are ignored when multiple SSAs are coded. This restriction
  causes a problem of data integrity. If an incorrect key value is
  specified in the 2nd or later qualifier, Load API does not
  detect the error and inserts the segment at an unexpected
  position. This APAR removes the restrictoin and enables to
  detect such an error by checking qualifiers for all SSAs. After
  applying the APAR, Load API will return a status code LD to the
  load applicatoin when an incorrect key value is specified in the
  2nd or later qualifier.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = Documentation Change =
  ========================
  IMS High Performance Load for z/OS Version 2 Release 1 User's
  Guide SC18-9222-03 ( SC18922203 ) should be changed as follows:
  ================================================================
    4.0 Load API
    4.1.3 Restrictions
    :
    If an HDAM database does not define a unique sequence field
    and the insert rules are 'FIRST' or 'HERE', IMS chains the
    duplicate segments in the reverse order, that is last in first
     out.
  DEL:
  | Multiple SSAs can be coded but qualifiers for the second SSA
  | or later are ignored.
  DEL:
    Only the command codes D and Null are supported. The V command
    code can be coded but will be ignored.
   :
  ==================== END OF DOC-CHANGE ========================
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK44931

Modules/Macros

•    HPSRAS00 HPSRAULA HPSRAULB HPSRAUL0 HPSRAUL7
  HPSRAUL8 HPSRAUL9 HPSRDSCT HPSRFCA0 HPSRSTMT
  

Fix information

• Fixed component name

  IMS HIGH PERF L

• Fixed component ID

  5655E0700

Applicable component levels

• R210 PSY UK44931

     UP09/03/18 P F903

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.