PH42976: SUPPORT FOR IMS BMP PROCESSING OPT/NBA/OBA PARAMETER VALUES

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR introduces an enhancement to IMS data processing,
  in BMP mode, by allowing the user to control certain values
  when starting up the dependent (Optim application) region.
  
  o NBA (Normal Buffer Allocation) and OBA (Overflow Buffer
  Allocation) IMS invocation parameters.
  These values are applicable when processing DEDB databases in
  DELETE and INSERT (with DELETE) scenarios.
  
  NBA = Normal Buffer Allocation, 4-digit number of Fast Path
  database buffers to be made available when the Fast Path region
  is activated.
  OBA = Overflow Buffer Allocation, 4-digit number of additional
  page-fixed buffers to be made available to a Fast Path
  application region if the normal allotment is used.
  
  o OPT (to specify what action to take when the dependent region
  starts, but when no system identifier matches the names given on
  IMSID or ALTID).
  Consult the IMS publications for details.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Optim users processing IMS data.             *
  ****************************************************************
  * PROBLEM DESCRIPTION: Optim does not allow for refined        *
  *                      control of the dependent (Optim         *
  *                      application) IMS region when            *
  *                      using BMP mode.                         *
  ****************************************************************
  Optim will introduce means to control certain IMS BMP options.
  

Problem conclusion

• Optim processing will be enhanced to support certain IMS BMP
  options.
  These options are:
  o NBA (Normal Buffer Allocation) and OBA (Overflow Buffer
  Allocation) IMS invocation parameters.
  These values are applicable when processing DEDB databases in
  DELETE and INSERT (with DELETE) scenarios.
  
  NBA = Normal Buffer Allocation, 4-digit number of Fast Path
  database buffers to be made available when the Fast Path region
  is activated.
  OBA = Overflow Buffer Allocation, 4-digit number of additional
  page-fixed buffers to be made available to a Fast Path
  application region if the normal allotment is used.
  
  o OPT (to specify what action to take when the dependent region
  starts, but when no system identifier matches the names given on
  IMSID or ALTID).
  
  Consult the IMS publications for details.
  
  The options can be set using the ISPF interface, 0.6 Legacy
  Options. With these options set, the following BATCH control
  keywords will be inserted in to the generated JCL:
  o IMS_BMP_OPT
  o IMS_BMP_NBA
  o IMS_BMP_OBA
  Existing JCL can be manually updated with the respective control
  statements.
  
  Please observe the following rules:
  o While IMS allows for NBA and OBA values of 0, Optim will not
  allow for such because of concerns in respect to backward
  compatibility.
  o When the when the Custom Option 86 (Update Unkeyed IMS
  Segments by Delete then Root Insert) has been enabled then the
  NBA/OBA values default to 50/100 and are not affected by the
  NBA/OBA values specified on the Legacy Options panel.
  
  The following Optim publications will be updated by this APAR:
  
  o Batch Utilities: chapter Introduction to Batch Utilities,
  General COntrol Statements:
    Add description of the following new control statements:
    o IMS_BMP_OPT
      Value of the IMP OPT parameter when working with IMS in BMP
      mode. Consult the IMS publications for details.
      Valid values are N, W, and C. The Optim default is C.
    o IMS_BMP_NBA
      Value of the IMS NBA parameter when working with IMS in BMP
      mode. Consult the IMS publications for details.
      Specify a 4-digit number between 1 and 9999.
    o IMS_BMP_OBA
      Value of the IMS OBA parameter when working with IMS in BMP
      mode. Consult the IMS publications for details.
      Specify a 4-digit number between 1 and 9999.
  
  o Optim Common Elements manual, Options, Legacy Options, will be
    updated with the description of the new IMS BMP options.
  

Temporary fix

Comments

APAR Information

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

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

  UI79709

Modules/Macros

• FOP00003 FOP00103 FOP00203 FOP00303 FOP00B   FOP01B   FOP05B
  FOP07B   FOP08B   FOP09B   FOP0AB   FOP0BB   FOP0DAUE FOP0ITKA
  FOP1ODRV FOP1OSFN FOP1XTRN FOP3DTPR FOP4IPMN FOP4PEMN FOP4PMMN
  FOP4TRCE FOP9APIM FOP9GINF FOPCFPMN FOPCXLIB FOPHSTM  FOPIO
  FOPMACAS FOPMADDE FOPMAFCN FOPMAIN  FOPMAMAI FOPMARCN FOPMCBMN
  FOPMCDRT FOPMCENU FOPMCMAI FOPMCMMN FOPMCOFN FOPMCOLA FOPMCOLP
  FOPMDBMN FOPMDDDL FOPMDMAI FOPMDPRC FOPMDXTR FOPMECMN FOPMEMAI
  FOPMIXMM FOPMMCMN FOPMMCMR FOPMMJBS FOPMMUNU FOPMMUTL FOPMSELM
  FOPMSORT FOPMTMDB FOPMUXIM FOPODPP  FOPOMN   FOPRS10  FOPT0P60
  FOPTC710 FOPTC71T FOPTC71U FOPUBMC  FOPUIAUL FOPUMCBT FOPUUNLD
  FOPVOU   FOPZFBMN FOPZFMMN FOPZMAIN FOPZSUB
  

Fix information

• Fixed component name

  OPTIM MOVE FOR

• Fixed component ID

  5655V0700

Applicable component levels

• RB70 PSY UI79709

     UP22/03/19 P F203  

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.