IBM Support

PM55891: ENABLE THE SPECIFICATION OF THE BLDLPCK STATEMENT AS AN INSTALLATION DEFAULT OPTION

A fix is available

Obtain the fix for this APAR.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • Enable the specification of the BLDLPCK statement as an
installation default option.

Local fix

  • 



Problem summary


    

  • ****************************************************************
* USERS AFFECTED: All users of IMS Database Reorganization     *
*                 Expert for z/OS Version 4 Release 1          *
*                 (FMID=H25N410), who use the IPR Unload       *
*                 utility.                                     *
****************************************************************
* PROBLEM DESCRIPTION: This APAR enables the specification of  *
*                      the BLDLPCK statement as an             *
*                      installation default option for IPR.    *
****************************************************************
* RECOMMENDATION: Apply the maintenance for this APAR.         *
****************************************************************
This APAR enables the specification of the BLDLPCK statement as
an installation default option for IPR.

To use the new function, the following maintenance is required:
 - APAR PM55889 for IMS High Performance Unload (FMID=H1IN120)

    



Problem conclusion


    

  • 



Temporary fix


    

  • 



Comments


    

  • ========================
= Documentation Change =
========================
The IBM IMS Database Reorganization Expert for z/OS User's Guide
Version 4 Release 1 (SC19-1137-02) should be changed as follows:
================================================================
 4.0 Unloading a database
 4.3 IPR Unload JCL statements
 4.3.2 Control statements for IPR Unload
 4.3.2.4 Control statements for HSSR Engine
 4.3.2.4.1 BLDLPCK control statement
  Specifies whether to retrieve logical parent's concatenated
  keys (LPCKs) or not.
  :
  This control statement is optional. If you do not explicitly
  specify this control statement, BLDLPCK=NO is used.

  +------------------------------------------------------------+
  |                  __NO___                                   |
  | >>____BLDLPCK=__|__YES__|_______________________________>< |
  +------------------------------------------------------------+

  NO   Bypass LPCK retrieval.
  YES  Retrieve logical parent's concatenated keys (LPCKs).
  Note:
|   1. The default value of the BLDLPCK control statement can
|      be changed. For details, see "Setting installation
|      default options" in topic 7.1.
    2. If the LPCK is defined as "physical"?that is, the ...
       :
    6. BLDLPCK statement is ignored for PHDAM or PHIDAM
       databases.
|   7. BLDLPCK statement is ignored if either MIGRATE=YES or
|      FALLBACK=YES control statement is specified.
    8. If APISET=3 is specified, the BLDLPCK statement is
       ignored and BLDLPCK=YES is always assumed.

 7.0 Reference
 7.1 Setting installation default options
 7.1.4 How to code HPSCOPT macro statements
  The installation default options are specified by coding a set
  of HPSCOPT macro statements.
  ------Product-Sensitive Programming Interface------
  These statements are assembler language macro instructions and
  therefore are subject to the rules contained in the High Level
  Assembler Programmer's Guide. The general syntax of the
  HPSCOPT macro statement is as follows:

  +------------------------------------------------------------+
  | >>__HPSCOPT__ _START______ _____________________________>< |
  |              |_END________|                                |
  |              |_| DRIVER |_|                                |
| |              |_| DRIVUL |_|                                |
  |              |_| DRIVRL |_|                                |
  |              |_| UNLOAD |_|                                |
  |              |_| RELOAD |_|                                |
  +------------------------------------------------------------+
    :
| +------------------------------------------------------------+
| |DRIVUL:                                                     |
| |                                                            |
| | |__DRIVUL___ _________________________ __________________| |
| |             |_ ___________________ ___|                    |
| |               |            _NO__  |                        |
| |               |_BLDLPCK=__|_YES_|_|                        |
| |                                                            |
| +------------------------------------------------------------+
    :
  +------------------------------------------------------------+
  |UNLOAD:                                                     |
  |                                                            |
  |            <_,_______________________________              |
  | |__UNLOAD___ _______________________________ |___________| |
| |             |_ ___________________ _________|              |
| |             | |            _NO__  |         |              |
| |             | |_BLDLPCK=__|_YES_|_|         |              |
  |             |_ ____________________ ________|              |
  |             | |             _NO__  |        |              |
  |             | |_CHECKREC=__|_YES_|_|        |              |
  |             |_ _____________________ _______|              |
  |             | |              _NO__  |       |              |
  |             | |_DECODEDBD=__|_YES_|_|       |              |
  |             |_ ______________________ ______|              |
  |             | |               _NO__  |      |              |
  |             | |_DECOMPRESS=__|_YES_|_|      |              |
  |             |_ ________________________ ____|              |
  |             | |             _*NO_____  |    |              |
  |             | |_ITKBLOAD=__|_LIBNAME_|_|    |              |
  |             |_ ___________________________ _|              |
  |             | |             _*NO________  | |              |
  |             | |_ITKBSRVR=__|_SERVERNAME_|_| |              |
  |             |_ ___________________ _________|              |
  |             | |_JCLTYPE=____DFS___|         |              |
  |             |_ ____________________ ________|              |
  |             | |             _YES_  |        |              |
  |             | |_PARTINFO=__|_NO__|_|        |              |
  |             |_ ___________________ _________|              |
  |               |            _YES_  |                        |
  |               |_STATREP=__|_NO__|_|                        |
  |                                                            |
  +------------------------------------------------------------+
    :
  DRIVER
    This parameter identifies the Smart Reorg Driver (HPSGMAIN).
    This parameter supports the following values:
        - CONDREORG
        - DECODEDBD
        - DECODESXD
        - DISPOLDDS
        - SINDEXSUF
        - HPIO
        - ITKBLOAD
        - ITKBSRVR
        - ILDSBLD
| DRIVUL
|   This parameter identifies the Unload task under the Smart
|   Reorg Driver. This parameter supports the following value:
|       - BLDLPCK
  DRIVRL
    This parameter identifies the Reload task under the Smart
    Reorg Driver. This parameter supports the following values:
        - OADSPR
        - PARTINIT
        - WF1REC
    The specification of PARTINIT is valid only when
    REORGINPT=ULDS is used.
  UNLOAD
    This parameter identifies the IPR Unload utility. This
    parameter supports the following values:
      For the Unload utility:
|       - BLDLPCK
        - DECODEDBD
        - PARTINFO
        - STATREP
        - CHECKREC
        - ITKBLOAD
        - ITKBSRVR
        - DECOMPRESS
        - JCLTYPE
        For details about the JCLTYPE option, see "Steps to run
        the JCL for IMS HD Reorganization Unload" in topic
        4.3.1.3.1.
      For API function:
        - APISET
        - PCBLIST
  RELOAD
    This parameter identifies the IPR Reload utility. This
    parameter supports the following values:
        - DECODEDBD
        - PARTINFO
        - CHKUPDT
        - HPIO
        - OADSPR
        - PARTINIT
        - ITKBLOAD
        - ITKBSRVR
        - ILDSBLD
        - WF1REC
  Note:
|   1. The Unload task under Smart Reorg uses the option table
|      for DRIVUL, not the one for UNLOAD.
    2. The Reload task under Smart Reorg uses the option table
       for DRIVRL, not the one for RELOAD.
===================  END OF DOC-CHANGE  =======================

    



APAR Information




    

  • APAR number
    PM55891
    • 

  • Reported component name
    IMS DB REORG EX
    • 

  • Reported component ID
    5655F7400
    • 

  • Reported release
    410
    • 

  • Status
    CLOSED  UR1
    • 

  • PE
    NoPE
    • 

  • HIPER
    NoHIPER
    • 

  • Special Attention
    YesSpecatt / New Function / Xsystem
    • 

  • Submitted date
    2012-01-12
    • 

  • Closed date
    2012-02-13
    • 

  • Last modified date
    2012-03-01
    • 





    

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

    • 

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

    
UK76175
    

    • 



Modules/Macros


    

  • HPSCMAIN HPSCOPT  HPSCOPTS HPSGCSC0 HPSGOPTU
HPSGSTMT

    




Publications Referenced


SC19113702    





Fix information


    

  • Fixed component name
    IMS DB REORG EX
    • 

  • Fixed component ID
    5655F7400
    • 



Applicable component levels


    

  • R410  PSY  UK76175
       UP12/02/15  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.
    








      
              
                            

              

              [{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSVL5Q","label":"IMS Database Reorganization Expert for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1.0","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
              

                          

          
 
        

      

    

      

        

          

            
Document Information


            

            


                        

            Modified date:
            

            06 January 2023
            

            
                      

        


        

        


      

    

  



    

  

  
    
            

          
Page Feedback