PI11626: ENABLE USING XTIOT FOR HALDB DATA SET ALLOCATION, REQUESTING UPDATE OF REORG NUMBER OF HALDB PARTITIONS IN RECON

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR enables the following functions of the Smart Reorg
  utility:
  1. Using XTIOT for HALDB data set allocation
  2. Requesting the update of the reorganization number of HALDB
  partitions in RECON if REORG NUMBER VERIFICATION=YES
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Database Reorganization     *
  *                 Expert for z/OS Version 4 Release 1          *
  *                 (FMID=H25N410)                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides the following        *
  *                      enhancements of the smart reorg         *
  *                      utility:                                *
  *                                                              *
  *                      1. Using XTIOT for allocation of        *
  *                      HALDB data sets                         *
  *                      2. Requesting the update of the         *
  *                      reorganization number of each HALDB     *
  *                      partition in RECON                      *
  *                                                              *
  *                      And this APAR fixes the following       *
  *                      problems::                              *
  *                      - GETMAIN failure incorrectly:          *
  *                         HPSG0100E GETMAIN ERROR (RC=04)      *
  *                         IN MODULE HPSGRS10                   *
  *                      - ABENDS0C4 at HPSGRS20+19A in          *
  *                       the HPSGRMGR load module               *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  1.  Using XTIOT for allocation of HALDB data sets to avoid
    an error of reaching the full of the TIOT space.
    If all of the following conditions are met, XTIOT (extended
    task input/output tables) used to allocate each HALDB data
    set dynamically
    - z/OS V1.12 or later
    - 'DBALLABOVE' is coded if DFSVSAMP DD is specified in JCL.
    - NON_VSAM_XTIOT option is coded in the DEVSUPxx member of
      PARMLIB if one or more OSAM data sets are included.
    - APAR PM75257 is applied for IMS High Performance Unload
    - APAR PM75254 is applied for IMS High Performance Load
    - APAR Pxxxxxx is applied for IMS High Performance Image
      Copy if HPIC=YES is specified.
  
    If the DFSVSAMP DD statement is not provided in JCL,
    it is allocated dynamically. If the other conditions are
    met, 'DBALLABOVE' is specified automatically.
  
    When XTIOT is used, MSGHPSG0105I is issued:
      HPSG0105I XTIOT IS USED FOR DATABASE DATA SETS
  
  2. If 'REORG NUMBER VERIFICATION= YES' is defined in RECON,
    the Smart Reorg utility requests the update of the
    reorganization number of each HALDB partition to DBRC
    after issuing the NOTIFY.REORG command.
    IMS DBRC issues MSGDSP1108I;
     DSP1108I  REORG# CHANGED FROM xxxxx TO yyyyy
                For DATABASE partname
  
  And this APAR fixes the following problems:
  - GETMAIN failure incorrectly
      HPSG0100E GETMAIN ERROR (RC=04) IN
    MODULE HPSGRS10
  - ABENDS0C4 at HPSGRS20+19A in the HPSGRMGR load module.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS Database Reorganization Expert for z/OS User's
  Guide Version 4 Release 1 Suffix 3 (SC19-1137-03) should be
  changed as follows:
  ---------------------------------------------------------------
  > Reorganizing a database in one job step
  >> JCL requirements for Smart Reorg
  >>> DD statements
  >>>> DD names common to all processing options
  
   DFSVSAMP DD
    Describes the data set that contains the buffer pool
    information required by the IMS DL/I buffer handler. This
    data set, when not specified, is created dynamically
    by IMS Database Reorganization Expert. Therefore, normally,
    do not specify this data set.
    :
    :
  | For the 'DBALLABOVE' statement, see 'DYNALLOC control
  | statement'.
  ---------------------------------------------------------------
  > Reorganizing a database in one job step
  >> Smart Reorg JCL statements
  >>> Control statements for the Smart Reorg utility
  >>>> Control statements for the Smart Reorg Driver
  >>>>> DYNALLOC control statement
   :
   Notes:
   :
  |5. If all of the following conditions are met, XTIOT
  |   (extended task input/output tables) is used to allocate
  |   each HALDB data set dynamically:
  |   - z/OS is V1.12 or later.
  |   - NON_VSAM_XTIOT option is coded in the DEVSUPxx member of
  |     PARMLIB if one or more OSAM data sets are included.
  |   - 'DBALLABOVE' is specified in the DFSVSAMP data set.
  |      If the DFSVSAMP data set is allocated dynamically,
  |     'DBALLABOVE' is coded in it automatically if the other
  |     conditions are met.
  ---------------------------------------------------------------
  > Troubleshooting
  >> Messages and codes
  >>> Messages
  >>>> HPSG messages
  
   HPSG0102E DYNAMIC ALLOCATION FAILED FOR DDNAME= ddname RC=rc,
             RSN=rsn
  
   Explanation: An attempt of dynamic allocation for the data set
   that is identified by the DD name ddname failed. The values rc
   and rsn are the decimal return code and the hexadecimal reason
   code of the DYNALLOC macro. When RC=04 and RSN=1708, this
   message indicates that the data set does not exist.
  |When RC=04 and RSN=0238, this message indicates that the TIOT
  |space reached full.
   System Action: The Smart Reorg utility task or the subtask
   that issued the dynalloc request abends with a completion
   code of U0102, and the Smart Reorg utility job step ends with
   a return code of 16.
   User Response: Correct the error and rerun the job. If the
   error cannot be resolved, keep the dump produced at the time
   of error and contact IBM Software Support.
   Problem Determination: For the return code and the reason
   code from the DYNALLOC macro, refer to MVS Authorized
   Assembler Services Guide.
  --------------------------------------------------------------
  | HPSG0105I XTIOT IS USED FOR DATABASE DATA SETS
  |
  | Explanation: XTIOT (extended task input/output tables) is
  | used to allocate each HALDB data set dynamically,
  | instead of TIOT.
  | System Action: The Smart Reorg utility continues processing.
  | User Response:  none.
  --------------------------------------------------------------
  | HPSG0115I DFSBRLSC FUNC=funcname RETURNED CONDITION CODE cc
  |
  | Explanation: IMS DBRC interface macro DFSBRLCS returns
  | hexadecimal condition code cc. Keyword funcname is one of
  | INIT0,INIT1,SIGNON,SIGNOFF,REORG or SETREORG.
  | System Action: The IPR Driver continues processing.
  | Programmer Response: If the condition code is not zero,
  | see DFSxxxx messages.
  ---------------------------------------------------------------
  | HPSG0118E LOAD FAILED FOR modname CC=xxxx, RSN=yy
  |
  | Explanation: A LOAD macro to load the indicated module
  | returns an error.
  | System Action: The Smart Reorg utility ends with a return
  | code of 8.
  | Programmer Response: Check the system completion code and
  | the error reason code. See the explanation of MVS system
  | completion code 806 to determine the meaning of the reason
  | code. Correct the error and rerun the job.
  ---------------------------------------------------------------
  | HPSG0453E REORG# UPDATE FAILED FOR PARTITION partition
  |
  | Explanation: An error occurred in updating the HALDB
  | partition reorganization number stored in the RECON data set.
  | System Action: The Smart Reorg utility ends with a return
  | code of 8.
  | Programmer Response: This is likely an internal system error.
  | Contact IBM Software Support.
  ---------------------------------------------------------------
    HPSG2211W THE ACCESS TO OUTPUT REPOSITORY WAS CANCELED.
              REASON: reason
    Explanation: The Smart Reorg utility canceled its access in
    the IMS Tools KB Output repository because its initialization
    process failed. The reason is one of the following:
    Reason          Meaning
    ITKBLOAD DYNALLOC FAILUR     Dynamic allocation for the
                                 library specified in the ITKBLOAD
                                 control statement failed.
    HKTXXLI LOAD FAILURE         Loading of the HKTXXLI module
                                 failed.
    ITKBLOAD OPEN FAILURE        Opening of the library specified
                                 in the ITKBLOAD control statement
                                 failed.
    ITKBLOAD NOT AUTHORIZED      Library specified in the ITKBLOAD
                                 control statement is not
                                 APF-authorized.
   |ITKB KEY AREA GETMAIN ERR    Obtaining of a key area failed.
   |LOG D/S DCB GETMAIN ERR      Obtaining of DCB for a log data
   |                             set failed.
    System action: Processing continues, but no reports are
    stored in the IMS Tools KB Output repository.
    User response: If you want to store reports in the IMS Tools
    KB Output repository, specify the IMS Tools KB product load
    module library correctly. For more information, see
    "ITKBLOAD control statement". If the reason is "ITKBLOAD NOT
    AUTHORIZED", the library must be APF-authorized.
  ================= End of Documentation Change ==================
  

APAR Information

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

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

  UI15968

Modules/Macros

• HPSGBBLA HPSGBBLB HPSGBBLC HPSGBBLD HPSGBBL9 HPSGCM20 HPSGDI00
  HPSGGIO0 HPSGGIT0 HPSGGRG0 HPSGGVM0 HPSGIDA0 HPSGIT10 HPSGIT20
  HPSGLINK HPSGMPE0 HPSGMSGT HPSGRA00 HPSGRA40 HPSGRA50 HPSGRA70
  HPSGRI00 HPSGRP00 HPSGRR00 HPSGRS00 HPSGRS10 HPSGRS20 HPSGRS40
  HPSGRS6B HPSGRS6C HPSGRS6D HPSGTJ00 HPSGTM00 HPSGTU10 HPSGTU2A
  HPSGTU2B HPSGTU2C HPSGTU2D HPSGTU29 HPSGTU3A HPSGTU3B HPSGTU3C
  HPSGTU3D HPSGTU39 H25N410J
  

Fix information

• Fixed component name

  IMS DB REORG EX

• Fixed component ID

  5655F7400

Applicable component levels

• R410 PSY UI15968

     UP14/03/15 P F403

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.