PQ59024: NEW HARDWARE DATA COMPRESSION EXIT DRIVER FOR FASTPATH DATABASES.

APAR status

• Closed as new function.

Error description

• A new hardware data compression exit will be provided to add pad
  characters to compressed IMS Fastpath database variable length
  segments.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: ALL IMS USERS OF IMS HARDWARE DATA           *
  *                 COMPRESSION EXTENDED FOR Z/OS VERSION 2      *
  *                 RELEASE 2, USING FAST PATH DEDB DATABASES    *
  *                 WITH VARIABLE LENGTH SEGMENTS.               *
  ****************************************************************
  * PROBLEM DESCRIPTION: ADD SEGMENT PADDING SUPPORT FOR         *
  *                      FASTPATH VARIABLE LENGTH SEGMENT.       *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  ADD NEW IMS HD COMPRESSION EXTENDED PROGRAM DICTIONARY DRIVER,
  HCOZLDXV, TO SUPPORT PADDING OF VARIABLE LENGTH FAST PATH DEDB
  SEGMENTS.
  

Problem conclusion

Temporary fix

Comments

• A NEW IMS HD COMPRESSION EXTENDED PROGRAM DICTIONARY DRIVER,
  HCOZLDXV, HAS BEEN ADDED TO SUPPORT PADDING OF VARIABLE LENGTH
  FAST PATH DEDB SEGMENTS. WHEN THIS EXIT IS USED, FAST PATH
  VARIABLE LENGTH SEGMENTS, WHEN COMPRESSED, WILL ALWAYS BE
  PADDED TO THE MINIMUM SEGMENT LENGTH SPECIFIED IN THE DBD.
  
  INCLUDE RECOMPILED COPY OF HCOZLDX0 FOR NEW SMP/E JCLIN MEMBER.
  
  ================================================================
  
  USER GUIDE DOCUMENTATION CHANGES:
  CHANGE PAGE V IN CONTENTS AS FOLLOWS:
   CHAPTER 11 ...
      ABENDS FOR HCOZLDX0 AND HCOZLDXV ................
  
  ADD TO CHAPTER 1. INTRODUCTION, SECTION: IMS HD COMPRESSION
  EXTENDED PROGRAMS. BOTTOM OF PAGE 8, CHANGE THE FOLLOWING
  SENTENCE. "IMS HD COMPRESSION EXTENDED CONSISTS OF ... "
  TO "IMS HD COMPRESSION EXTENDED CONSISTS OF EIGHT PROGRAMS AND
  TWO DICTIONARY DRIVER MODULES:"
  
  AT THE TOP OF PAGE 9, CHANGE BULLET ITEM HCOZLDX0 TO READ AS
  FOLLOWS: HCOZLDX0 AND HCOZLDXV ARE THE DICTIONARY DRIVERS.
  USE HCOZLDXV FOR VARIABLE LENGTH FAST PATH DEDB SEGMENTS
  WHEN PADDING IS NEEDED TO FORCE SEGMENTS TO THE MINIMUM
  SEGMENT LENGTH AFTER COMPRESSION IS DONE.
  
  AT THE TOP OF PAGE 9, BELOW BULLET ITEM HCOZLDX0
  THE LAST SENTENCE SHOULD READ AS FOLLOWS: "THE DICTIONARY
  DRIVER RUNS WHEN ... "
  
  BELOW IS AN EXAMPLE OF WHAT THE COMPRESSION EXIT ROUTINE
  PANEL ON PAGE 47 WILL CONTAIN WITH NEW DRIVER NAME FIELD
  
   ---- IBM IMS HD Compression ----- Function = BUILD ----------
  
   COMMAND ===>
  
  
   COMP NAME    ==>           COMPRESSION DICTIONARY NAME.
  
   DRIVER NAME  ==>           COMPRESSION DRIVER NAME. (HCOZLDX0/
                                                        HCOZLDXV)
   EXIT NAME    ==>           COMPRESSION EXIT NAME.
  
   USER RESLIB WHERE COMPRESSION EXIT MUST BE PLACED
                ==>
  
  
   Press END to exit.
  
  
  ON PAGE 48 IN DESCRIPTION OF COMP NAME, CHANGE '...TO THE
  HCOZLDX0 DICTIONARY DRIVER' TEXT TO '..TO THE DICTIONARY DRIVER.
  
  ON PAGE 48 AFTER DESCRIPTION OF COMP NAME ADD THE FOLLOWING NEW
  PANEL TITLE AND DESCRIPTION.
   DRIVER NAME
    THE NAME OF COMPRESSION DICTIONARY DRIVER.
  
  ON PAGE 49 IN DESCRIPTION OF HDCDOUT DD STATEMENT CHANGE TEXT TO
  READ AS FOLLOWS: 'THIS DICTIONARY IS LINKED WITH THE DICTIONARY
  DRIVER WHEN ... '
  
  ON PAGE 52 IN DESCRIPTION OF CREATING A COMPRESSION EXIT ROUTINE
  CHANGE TEXT TO READ AS FOLLOWS: '... BY LINKING HCOZLDX0
  OR HCOZLDXV AND THE IMS HD COMPRESSION ...'
  
  ON PAGE 52 IN DESCRIPTION OF RELINKING A COMPRESSION EXIT
  ROUTINE, CHANGE ALL REFERENCES TO HCOZLDX0 TO THE FOLLOWING:
  'HCOZLDX0 OR HCOZLDXV'.
  
  CHANGE THE SECTION HEADING ON PAGE 82 AS FOLLOWS:
  
  "ABENDS FOR HCOZLDX0 AND HCOZLDXV"
  
  ADD THE FOLLOW REASON CODE AND ITS DESCRIPTION TO PAGE 83 AFTER
  REASON CODE F AND ITS TEXT DESCRIPTION.
  
  REASON CODE 10
  
  EXPLANATION: MINIMUM SEGMENT SIZE FOR FAST PATH DATABASE IS
  INVALID.
  SYSTEM ACTION: THE UTILITY TERMINATES ABNORMALLY.
  OPERATOR RESPONSE: NOTIFY THE SYSTEM PROGRAMMER.
  SYSTEM PROGRAMMER RESPONSE: NOTIFY THE DATABASE
  ADMINISTRATOR.
  PROBLEM DETERMINATION: AN INVALID SEGMENT LENGTH WAS PASSED TO
  THE DATA COMPRESSION PROCESS.  CHECK THAT THE DBD IS CORRECT
  FOR THE DATABASE MINIMUM AND MAXIMUM SEGMENT LENGTHS.
  

APAR Information

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

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

  006PC1Ÿ UQ69716

Modules/Macros

•    HCOP20   HCOS24   HCOZLDXV HCOZLDX0 H22D220J
  

Fix information

• Fixed component name

  IMS HDCE

• Fixed component ID

  5655E0200

Applicable component levels

• R220 PSY UQ69716

     UP02/09/13 P F209