PK16267: HPFPU ENHANCEMENT TO SIMPLIFY FPO ONLINE AREA EXTENDER (OAE) USAGE.

APAR status

• Closed as new function.

Error description

• Online Area Extender enhancement to simplify usage (Phase 2).
  FPO V2R1(5666-F78) has provided APAR PQ90898 as Phase 1 of this
  enhancement.
  This phase (2) eliminates the need for the following OAE
  preperation steps:
  1) Allocate a larger data set.
  2) Create a new ADS with a different DDN and define the data set
  created to DBRC.
  
  This APAR is also part of FITS requirement MR0220036842
  (Phase 2).
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Online Area Extender users of HP Fast    *
  *                 Path Utilities; FP Online Tools Version      *
  *                 2 Release 2 (FMID: H31A220).                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: Provides a single step method to        *
  *                      extend IOVF and/or SDEP of the original *
  *                      ADS without any preparatory steps.      *
  *                      (requirement number: MR0220036842)      *
  *                      This is a phase2 enhancement that took  *
  *                      over a phase1 PQ90898 enhancement.      *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Before this APAR, you needed to take complicated preparatory
  steps, as follows, which takes a considerable amount of time
  before running the OAE utility.
  1. Allocate a larger area data set.
  2. Register a new area data set to DBRC.
  3. Change the ROOT= parameter of the AREA statement on the DBD.
  4. Generate the new DBD member in ACBLIB library.
     (DBDGEN and ACBGEN)
  5. Run the OAE utility.
  

Problem conclusion

Temporary fix

Comments

• With this APAR, OAE provides the extension of the original ADS
  with a single JOB step.
  
  APAR PQ90898 has removed Steps 3 and 4 that were needed to
  install the new control keyword ROOT=. Now, OAE extends IOVF
  and/or SDEP with the ROOT= parameter instead of the ACBLIB
  library.
  And now, this APAR PK16267 removes Steps 1 and 2 that were
  needed to install a new FPXIN DD statement.
  Therefore, you only need to run one job step. This is a sample
  JCL that can be used to expand DB DEDBJN21, AREA DB21AR1.
  //*************************************************************
  //*----------------------------------------------
  //* OAE STEP
  //*----------------------------------------------
  //*************************************************************
  //EXTEND   EXEC FPUTIL,DBD=DEDBJN21
  //STEPLIB  DD DISP=SHR,DSN=IMSESA.PGMLIB
  //SYSOUT   DD SYSOUT=*,FREE=END
  //SYSPRINT DD SYSOUT=*,FREE=END
  //ACBLIB   DD DSN=IMSESA.ACBLIBB(DEDBJN21),DISP=SHR
  //FPXIN DD *
  *
  * EXTEND parameter
  *
  EXTEND
     AREA=DB21AR1
     IOVF_ROOT=(10,5)
     DDNAME=DBOAETMP
     DSNAME=IMSVS.USER.DB21AR1
  /*
  You only need to provide the temporary ADS information for OAE
  to define or delete, and register or unregister it with DBRC
  dynamically. OAE calculates the extended ADS size by using the
  user specified keywords.
  When a new DD statement FPXIN is specified, do not specify
  SYSIN DD.
  "High Performance Fast Online Tool for z/OS User's Guide
  Version 2 Release 2 SC18-9239-01 (SC18923901)" is updated to
  describe the support for a single step JCL that is used to
  extend IOVF and/or SDEP of the original ADS without any
  preparatory steps.
  For detasils, see "Chapter 9. Using Online Area Extender, Online
  area FPXIN statements".
  For the new function, see the IMS Tools Library page at:
  http://www-306.ibm.com/software/data/db2imstools/imstools-librar
  y.html
  This function needs the following IMS APARs.
  IMS Version 8 (5655-C56): PK15110
  IMS Version 9 (5655-J38): PK15111
  

APAR Information

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

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

  UK11253

Modules/Macros

•    FPXBACB0 FPXBACB7 FPXBACB8 FPXBACB9 FPXBAMS0
  FPXBASI0 FPXBASO0 FPXBCSO0 FPXBDBR0 FPXBDNA0 FPXBDRV0 FPXBDRV7
  FPXBDRV8 FPXBDRV9 FPXBINT0 FPXBLSB0 FPXBLSB7 FPXBLSB8 FPXBLSB9
  FPXBMAN0 FPXBMBLK FPXBMBL0 FPXBPAR0 FPXBPAR1 FPXBPEX0 FPXBPEX7
  FPXBPEX8 FPXBPEX9 FPXBPSZ0 FPXBPS40 FPXBPS50 FPXBRPT0 FPXBRST0
  FPXBSPA0 FPXBSPA7 FPXBSPA8 FPXBSPA9 FPXBTRM0 FPXBVFY0 FPXBVIP0
  FPXBXOV0 FPXBXOV7 FPXBXOV8 FPXBXOV9 FPXB0000 FPXB1000 FPXB1007
  FPXB1008 FPXB1009 FPXCALST FPXMSG00 FPXTOOL0 FPXUACM0 FPXUACM7
  FPXUACM8 FPXUACM9 FPXUPPE0 FPXUTDW7 FPXUTDW8 FPXUTDW9 FPXUTPA8
  FPXUTPA9 H31A220J
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R220 PSY UK11253

     UP06/01/31 P F601