PM57126: ENABLE THE SPECIFICATION OF THE SORT STATEMENT WITH USERHDR OR USERHDRX STATEMENT.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Enable the specification of the SORT statement with USERHDR or
  USERHDRX statement.
  

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: Enable the specification of the SORT    *
  *                      statement with USERHDR or USERHDRX      *
  *                      statement.                              *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR enables the specification of the SORT statement with
  USERHDR or USERHDRX statement.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = Documentation Change =
  ========================
  IMS High Performance Load for z/OS Version 2 Release 1 User's
  Guide SC18-9222-04 ( SC18922204 ) should be changed as follows:
  ================================================================
    2.2      Operating instructions
    2.2.3    Control statements
    2.2.3.26 SORT control statement
       :
       :
     Restrictions:
  
      - This statement is used exclusively with the USERHDR= and
  |     the USERHDRX= control statements for HALDB.
      - The key value that is sorted by SORT=YES or SORT=COND
        cannot be changed by the user exit routine.
          :
          :
    2.2.3.27 SORTHIDAM control statement
  
       :
       :
     Restrictions:
  
       - This control statement cannot be used for the Load API.
  DELETE:
  |    - This control statement is used exclusively with the
  |      USERHDR= and the USERHDRX= control statements.
  DELETE:
       - The key value that is sorted by SORTHIDAM=YES cannot be
         changed by the user exit routine that is specified in the
         reload step.
           :
           :
  
    2.5   Reloading a user header record
    2.5.2 Restrictions
  
  DELETE:
  | - You cannot specify control statements, USERHDR, USERHDRX,
  |   and SORT at the same time. They are mutually exclusive.
  DELETE:
  
  | - If you specify USERHDRX and SORT at the same time, the exit
  |   routine name that is specified to USERHDRX must be any one
  |   of the following list.
  |   +----------------------------------------------------------+
  |   | Table x. Exit routine names and the formats of the       |
  |   | unloaded file                                            |
  |   +----------------------------+-----------------------------+
  |   | Exit routine name          | Format of the unloaded file |
  |   +----------------------------+-----------------------------+
  |   | HPSRCVA3                   | *A3                         |
  |   +----------------------------+-----------------------------+
  |   | HPSRCVA4                   | *A4                         |
  |   +----------------------------+-----------------------------+
  |   | HPSRCVF1                   | *F1                         |
  |   +----------------------------+-----------------------------+
  |   | HPSRCVF2                   | *F2                         |
  |   +----------------------------+-----------------------------+
  |   | HPSRCVF3                   | *F3                         |
  |   +----------------------------+-----------------------------+
  |   | HPSRCVF6                   | *F6                         |
  |   +----------------------------------------------------------+
  
    - If the segment data of unloaded file is in a compressed
      form, you must specify COMPRESS=NO.
    - HALDB is not supported.
    - Logical relationships are not supported.
  | - Load API is not supported.
  
    7.2     Messages and codes
    7.2.3   Messages
    7.2.3.1 IMS HP Load messages
    7.2.3.1.44 HPSR0111E
  
    HPSR0111E USERHDR=, USERHDRX=, AND SORT= KEYWORDS ARE
    MUTUALLY EXCLUSIVE
  
    Explanation: All USERHDR, USERHDRX, and SORT= keywords are
    specified in the FRRIN or HPSIN data set. These keywords are
  | mutually exclusive for HALDB.
      :
  
    7.2.3.1.49 HPSR0119I
  
    HPSR0119I PHYSICAL SEQUENTIAL SORTING PROCESSED (rrrr)
      :
      :
    Reason (rrrr) Description
      :
    UNLOADED
      VIA SECONDARY INDEX The input unloaded data set was created
      by referring to the secondary index database.
  | USER HEADER
  |   USERHDR= or USERHDRX= is specified.
        :
  
    7.2.3.1.50 HPSR0120I
  
    HPSR0120I SORT PROCESS IS NOT APPLICABLE (rrrr)
  
    Explanation: SORT=COND is specified. However, physical
    sequential sorting is not processed by one of following
    reasons:
  
    Reason (rrrr) Description
    DB ORGANIZATION
      DB organization is not (P)HDAM.
    USERHDR=
      Both SORT= and USERHDR= are specified
  |   for HALDB.
    USERHDRX=
      Both SORT= and USERHDRX= are specified
  |   for HALDB.
        :
  
    7.2.3.1.57 HPSR0127E
  
    HPSR0127E USERHDR=, USERHDRX=, AND SORTHIDAM=YES KEYWORDS ARE
    MUTUALLY EXCLUSIVE
  
    Explanation: All USERHDR, USERHDRX, and SORTHIDAM=YES keywords
    are specified in the FRRIN or the HPSIN data set, but these
    keywords are mutually exclusive
  | for HALDB.
      :
  
  | 7.2.3.1.xx HPSR0133E
  |
  |  HPSR0133E THE EXIT NAME FOR USERHDRX= CANNOT BE USED WITH
  |  SORT OR SORTHIDAM
  |
  |  Explanation: The exit routine name that is specified to
  |  USERHDRX= statement cannot be specified with SORT or
  |  SORTHIDAM statement. The exit routine name must be any one of
  |  the exit names that is listed in table x. Exit routine names
  |  and the formats of the unloaded file.
  |
  |  System Action: Processing stops.
  |
  |  User Response: Correct the error and rerun the job.
  |
  |  Problem Determination: None.
  

APAR Information

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

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

  UK76588

Modules/Macros

• HPSRCVA3 HPSRCVA4 HPSRCVF1 HPSRCVF6 HPSRCVUH
  HPSRE15A HPSRFCA0 HPSRHDLA HPSRHDLB HPSRHDL2 HPSRHDL7 HPSRHDL8
  HPSRHDL9 HPSRMSGT HPSRRRI0 HPSRRRI9
  

Fix information

• Fixed component name

  IMS HIGH PERF L

• Fixed component ID

  5655E0700

Applicable component levels

• R210 PSY UK76588

     UP12/03/01 P F202

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.