PM36714: SUPPORT SDEP SPACE EXPANSION IN FPA UNLOAD AND CHANGE PROCESSINGMR061110170 AND MR0611105723

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR enables the FPA UNLOAD and CHANGE function to support
  SDEP space expansion.
  This enhancement is being implemented as a result of FITS
  requirement MR061110170 and MR0611105723.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of HPFPU FPA Unload/Reload and     *
  *                 Change in Fast Path Solution Pack Version 1  *
  *                 Release 1 (FMID: HAHQ110).                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1. FPA provides an enhancement to       *
  *                      relocate SDEP segments in physical      *
  *                      order at unload/reload and change       *
  *                      functions including the restructure     *
  *                      mode.                                   *
  *                      2. FPA Unload and Change with           *
  *                      SDEP=PHYSICAL run successfully against  *
  *                      an area has a SDEP segment that is      *
  *                      stored in over 2G. But Analyze detects  *
  *                      pointer errors.                         *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  *                 INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  1. FPA provides an enhancement to relocate SDEP segments in
  physical order at unload/Reload and change functions including
  the restructure mode.
  All SDEP data between the SDEP logical beginning and the logical
  end are extracted at unload. The SDEP data will be
  reloaded from the first SDEP CI even if the the SDEP part is
  "wrapped".
  The reloaded SDEP data will be in the same physical order
  between the SDEP logical beginning and the logical end,
  as prior to the unloading.
  
  The SDEP marker concept at unload can be kept to reload.
  Absolute RBA value at unload to identify the SDEP marker is no
  longer be effective but root segment and the field value of the
  SDEP marker at unload remain effective to identify the marker
  SDEP for SDEP Scan/Delete Utilities.
  
  The following restrictions apply:
  * If unload/change functions run with the restructure mode, the
  database records have to be stored into the original area..
  * The CI size must be the same in the old and new databases..
  * The definition of SDEP segment must be the same in the old and
  new databases..
  * Compressed segments will not be expanded even if COMPRESS=YES
  is specified..
  * Unload segment records of the SDEP CIs are unloaded as
  512-byte blocks of CI data, not as discrete segments..
  
  This function is equivalent to SDEPRELOCATE= option that is
  specified in FP Basic Tools Reload..
  
  This enhancement is being implemented as a result of FITS
  requirement MR061110170 and MR0611105723.
  
  2. FPA Unload and Change with SDEP=PHYSICAL run successfully
  against an area has a SDEP segment that is stored in over 2G.
  But Analyze detects pointer errors against a new area.
  0309 and 0313 messages are shown in the "Resolve Pointers
  report".
  
  Process SDEP Segment Physical Record Routine(HFPKSDP0) should
  calculate the SDEP segment RBA with AL instruction.
  (LA was used.)
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS Fast Path Solution Pack for z/OS Version 1 Release 1
  IMS High Performance Fast Path Utilities User's Guide
  (SC19-2914-01).
  
  2.3.6 Utility control statements for the Unload process
  UNLOAD command keywords
  RELOCATE_SDEP keyword is added in Table 4. UNLOAD command
  keywords
  RELOCATE_SDEP: An optional keyword that specifies to relocate
  the SDEP information.
  
  2.5.6 Utility control statements for the Change process
  CHANGE command keywords
  RELOCATE_SDEP keyword is added in Table 18. CHANGE command
  keywords
  RELOCATE_SDEP: An optional keyword that specifies to relocate
  the SDEP information.
  
  2.10.4 Commands, subcommands, and keywords
  2.10.4.x RELOCATE_SDEP is added
  Use the RELOCATE_SDEP keyword to relocate the SDEP information.
  SDEP relocation performs the following processing:
  * Adjust the SDEP Logical begin to the first SDEP CI, and
  reduce the size of SDEP part.
  * Dissolve the wrap around state of the SDEP parts of input
  ADS/IC, and reduce the size of SDEP part.
  .
  If you do not specify SDEP=PHYSICAL, this keyword is ignored.
  .
  RELOCATE_SDEP is an optional keyword for UNLOAD and CHANGE
  commands.
  Related keyword: SDEP
  Format: RELOCATE_SDEP=parameter
  parameter can be one of the following values:
    YES  Relocate the SDEP information
    NO   Do not relocate the SDEP information
  Default: RELOCATE_SDEP=NO
  Site default support: Yes
  
  7.1.3 Messages
  New messages HFPJ3113E and HFPM0004E are added.
  The message text of the current HFPC0062E is changed.
  

APAR Information

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

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

  UK68813

Modules/Macros

• HAHQ110J HFPCCCT0 HFPCCDT0 HFPCDEF0 HFPCTSK0
  HFPJAIR0 HFPJDMC0 HFPJINI0 HFPJOMN0 HFPJRND0 HFPJSDF0 HFPJSDP0
  HFPJSDS0 HFPJSDX0 HFPJUSR0 HFPKSDP0 HFPLCC30 HFPMCCC0 HFPSCDF0
  HFPUMVT0 HFPUROB0 HFPWMTC0 HFPWMTJ0 HFPWMTM0 HFPY1420 HFPZCCT
  HFPZMVT  HFPZROB  HFPZTTT
  

Fix information

• Fixed component name

  IMS FP SOLUTION

• Fixed component ID

  5655W1400

Applicable component levels

• R110 PSY UK68813

     UP11/06/17 P F106

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.