PM82938: ENABLE THE SPECIFICATION OF PADDING CHARACTER TO USE WHEN THE SEGMENT LENGTH IS INCREASED DUE TO DBD DEFINITION CHANGE.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Enable the specification of padding character to use when the
  segment length is increased due to DBD definition change.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Database Reorganization     *
  *                 Expert for z/OS Version 4 Release 1          *
  *                 (FMID=H25N410).                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Enable the specification of padding     *
  *                      character to use when the segment       *
  *                      length is increased due to DBD          *
  *                      definition change.                      *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR enables the specification of padding character to use
  when the segment length is increased due to DBD definition
  change by IPR Reload utility or the reload task of Smart Reorg
  Driver.
  
  To use the new function, the following maintenance is required:
   - APAR PM82937 for IMS High Performance Load (FMID=H1IM210)
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS Database Reorganization Expert for z/OS Version 4 Release 1
  User's Guide SC19-1137-02 ( SC19113702 ) should be changed as
  follows:
  ================================================================
    3.5.2   Control statements for Smart Reorg
    3.5.2.5 Control statements for Reload task
    :
      Table-17.-Control statements for Reload task
    +----------+-------------------+---------+---
    | Keyword  | Acceptable values | Default |
    +----------+-------------------+---------+---
    | :        | :                 | :       |
    +----------+-------------------+---------+---
  | | PAD      |  X'00'-X'FF'      | X'00'   |
    +----------+-------------------+---------+---
    | :        | :                 | :       |
  
  
    5.3      IPR Reload JCL statements
    5.3.2    Control statements
  
    5.3.2.7  COMPRESS control statement
     :
    Notes:
      :
    2.An unloaded data set created by IPR Unload utility with the
      DECOMPRESS=NO option cannot be used if you want to change
  |   the size of the segment by reorganization.
  DELETE:
  |   that is to be compressed.
  DELETE:
  
  | 5.3.2.x  PAD control statement
  |
  | Specify the padding character to use when the segment length
  | is increased due to DBD definition change.
  | This control statement is optional. If you do not explicitly
  | specify this control statement, PAD=X'00' is used.
  |    _________________________________________________________
  |   |                                                         |
  |   |                                                         |
  |   | >>__PAD=__padding-character__________________________>< |
  |   |                                                         |
  |   |_________________________________________________________|
  |
  | padding-character
  |   Code the value as two hexadecimal digits, for example X'nn'.
  |
  | Note:
  |   When the length of compressed segment is increased due to
  |   DBD definition change, you must create unload data set in
  |   decompressed format regardless of using PAD statement.
  |   Otherwise, the bytes in the extended area is unpredictable.
  |
  7.0   Reference
  7.1   Setting installation default options
  7.1.4 How to code HPSCOPT macro statements
      :
     ____________________________________________________________
    |                                                            |
    | DRIVRL:                                                    |
    |          <_,_____________________________________________  |
    | |__DRIVRL_______________________________________________ |_|
    |            |_ ____________ __________________ __________|  |
    |            | |_ILEDATAC=__|_data_class_name__|          |  |
                       :
                       :
  | |            |_ __________________________________________|  |
  | |            | |_PAD=__padding-character_|                |  |
    |            |_ ________________________________________ _|  |
    |            | |             _NO______________________  | |  |
    |            | |            |          _,PINITON_     | | |  |
    |            | |_PARTINIT=__|_(__YES__|__________|__)_|_| |  |
    |            |                        |_,UNLOAD__|        |  |
                       :
                       :
     :
     ____________________________________________________________
    |                                                            |
    | RELOAD:                                                    |
    |            <_,__________________________________           |
    | |__RELOAD__ ____________________________________________ | |
    |            |_ ________________________________ _________|  |
    |            | |             _YES,WARN________  |         |  |
    |            | |            |       _,WARN__  | |         |  |
    |            | |_CHKTRAIL=__|_YES__|_,ERROR_|_|_|         |  |
    |            |              |_NO______________|           |  |
                      :
                      :
  | |            |_ __________________________________________|  |
  | |            | |_PAD=__padding-character_|                |  |
    |            |_ ________________________________________ _|  |
    |            | |             _NO______________________  | |  |
    |            | |            |          _,PINITON_     | | |  |
    |            | |_PARTINIT=__|_(__YES__|__________|__)_|_| |  |
    |            |                        |_,UNLOAD__|        |  |
    |            |                        |_,LPART___|        |  |
                       :
                       :
      :
    DRIVRL
       This parameter identifies the Reload task under the Smart
       Reorg Driver. This parameter supports the following values:
  
          - ILEDATAC
          - ILESTORC
          - OADSPR
  |       - PAD
          - PARTINIT
          - REPAIRILK
          - SORT
          - WF1REC
  
       The specification of PARTINIT is valid only when
       REORGINPT=ULDS is used.
  :
  :
    RELOAD
       This parameter identifies the IPR Reload utility. This
       parameter supports the following values:
  
          - DECODEDBD
          - PARTINFO
          - CHKUPDT
          - HPIO
          - OADSPR
  |       - PAD
          - PARTINIT
          - REPAIRILK
          - SORT
          - ITKBLOAD
          - ITKBSRVR
          - ILDSBLD
          - ILEDATAC
          - ILESTORC
          - GDGBASE
          - GDGLIMIT
          - WF1REC
  
      Note: The Reload task under Smart Reorg uses the option
      table for DRIVRL, not the one for RELOAD.
                     :
                     :
  ======================= 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:

  UK92920

Modules/Macros

•    HPSCOPT  HPSCOPTS HPSGOPTR
  

Fix information

• Fixed component name

  IMS DB REORG EX

• Fixed component ID

  5655F7400

Applicable component levels

• R410 PSY UK92920

     UP13/03/28 P F303

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.