PK31156: SUPPORT FOR NEW UTILITY FABCUR8

APAR status

• Closed as new function.

Error description

• Support for new utility FABCUR8.
  This is based off of a request through FITS MR0920051620.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All DEDB Unload/Reload users of High         *
  *                 Performance Fast Path Utilities FP Basic     *
  *                 Tools Version 2 Release 2 (FMID: H31A220).   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides solutions for the    *
  *                      following requirement for FPB DEDB      *
  *                      Unload/Reload (requirement number:      *
  *                      MR0920051620):                          *
  *                                                              *
  *                      FPB provides a new utility that         *
  *                      converts from HD unloaded flat file to  *
  *                      DEDB unloaded file.                     *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  FPB provides a new utility that converts from HD unloaded flat
  file to DEDB unloaded file.
  
  As the utility calls FABCUR6 internally, any control parameters
  of the FABCUR6 can be selected to produce appropriate format of
  the DEDB unloaded file, for example, FORMAT=TFMT, LRECL=SEGTFMT,
  AREA_INFORMATION_RECORD=NO and so forth.
  

Problem conclusion

Temporary fix

Comments

• FPB DEDB Unload/Reload new utility FABCUR8 has been enhanced to
  convert HD unloaded flat file to DEDB format.
  
  FABCUR8 internally calls FABCUR6 to produce DEDB unloaded
  segment records file.
  
  All DD statements and UR6CTL control options of FABCUR6 are
  applicable to FABCUR8 to produce the DEDB unloaded
  segment records file.
  
  In addition to them, following EXEC parameters and DD statements
  are necessary to run FABCUR8:
  
  EXEC statement
    This statement must be in the form:
    //    EXEC PGM=FABCUR8,PARM='aaaaaaaa,bbbbbbbb',REGION=rrrK
  
    aaaaaaaa
      is the name of the DEDB DMB in ACBLIB.
    bbbbbbbb
      is the name of the full-function DBD in DBDLIB(Optional).
    rrrK
      indicates the size of the region.
  
    FABCUR8 has the alias name FABEUR8. You can invoke FABCUR8
    using the alias as follows:
  
    //    EXEC PGM=FABEUR8,PARM='aaaaaaaa,bbbbbbbb',REGION=rrrK
  
  DD statements
  
  DURINPT DD
   Defines the input data set containing the HD unloaded segment
   records. This is the output file produced by the IMS HD
   Reorganization Unload Utility (DFSURGU0), IMS High
   Performance Unload (FABHURG1), or created by any other
   programs that conform the format of the IMS standard HD
   unload record. A HD unload file of PSINDEX is not allowed.
   This DD statement must be required.
  
   Note: For HALDB database, it is recommended to concatenate
   HD unloaded files of all partitions if either a single HALDB
   partition or a range of HALDB partitions was unloaded.
  
  DBDLIB DD
   Defines the DBD library containing the DBD for the HD database.
   This DD statement is optional.
   This DD statement is required when HD DBD name is specified in
   the EXEC parameter.
   When this DD statement is not specified, DBD segment definition
   information will be obtained from the header record of the HD
   unloaded segment records file, but it is strictly recommended
   to specify HD DBD name in the EXEC parameter and the DD
   statement in order to make sure that the input HD unload file
   and the target DEDB DMB are correct.
  
  "IMS High Performance Fast Path Utilities for z/OS User's Guide
  Volume 2: Fast Path Basic Tools Version 2 Release 2
  (SC18-9238-01)" is changed to support new utility FABCUR8 to
  convert HD unloaded flat file to DEDB unloaded segment records
  file.
  To access the documentation change for this new function, go to
  the IMS Tools Library page at:
  http://www-306.ibm.com/software/data/db2imstools/imstools-librar
  y.html
  

APAR Information

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

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

  UK18958

Modules/Macros

•    FABALINK FABALIST FABCMDDT FABCUR6X FABCUR8
  FABC6BLK FABC6EOF FABC8BLK FABC8DDT FABC8HDD FABC8HDR FABC8MGT
  FABC8VAL FABUALIS H31A220J
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R220 PSY UK18958

     UP06/10/20 P F610