PK66592: ENHANCE FPB RELOAD ERROR MESSAGE

APAR status

• Closed as new function.

Error description

• Enhance FPB Reload error message. Diagnosis can be difficult
  when there is an incorrect RAPRBA value in USR. This APAR
  will alter MSGFABC3798E to make the message clearer and ease
  diagnosis.
  
  Keyword: FABC3798E
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All DEDB Unload/Reload users of High         *
  *                 Performance Fast Path Utilities FP Basic     *
  *                 Tools Version 3 Release 1 (FMID: H31A310).   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides the following new    *
  *                      functions for FPB DEDB FABCUR3.         *
  *                      1. FABCUR3 supports the validity check  *
  *                         for the unloaded segment records     *
  *                         file before reloading segments to    *
  *                         the database.                        *
  *                      2. FABCUR3 is allowed to specify ACBLIB *
  *                         library instead of DURDBDFN file.    *
  *                      3. FABCUR3 supports the validity check  *
  *                         for DBDNAME of DURDBDFN file.        *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  1. FABCUR3 supports the RAP check for the unloaded segment
     records file using randomizer before reloading segments to
     the database when a new keword RAPERROR= is specified. See
     the keyword explanation about details of RAPERROR= keyword.
     FABCUR3 also validates the some data in the prefix part of
     the unloaded segment record (USR) against the DEDB
     definition data.
  
  2. FABCUR3 is allowed to specify ACBLIB library instead of
     DURDBDFN file.
     Both ACBLIB library and new keyword DBDNAME= in SYSIN are
     required for using ACBLIB library instead of DURDBDFN file.
     Member of ACBLIB library is specified by DBDNAME= keyword
     parameter. See the keyword explanation about details of
     DBDNAME= keyword.
  
  3. FABCUR3 supports the validity check for DBDNAME of DURDBDFN
     file.
     When both DURDBDFN file and DBDNAME= keyword are specified
     without ACBLIB library, FABCUR3 compares DBD name of
     DURDBDFN file and DBD name specified by DBDNAME= keyword
     in SYSIN. If they are not same, FABCUR3 ends with ABEND3834.
     If DBDNAME= keyword is not specified with DURDBDFN file,
     FABCUR3 does not perform this check.
  

Problem conclusion

Temporary fix

Comments

• The module FABCUR3 has been modified to extract USR read
  process to a new module.
  The module FABC3END has been modified for reassembling.
  The module FABC3EOJ has been modified for randomizer init call.
  The module FABC3EXT has been modified for reassembling.
  The module FABC3INI has been modified to do init process for
  RAPERROR= keyword and DBDNAME= keyword options.
  The module FABC3SB0 has been modified to check IMS version of
  ACBLIB library.
  The module FABC3UOW has been modified to change the FABC3945E
  message format.
  The module FABC3ACB has been newly created to build DDT from
  ACBLIB library.
  The module FABC3RM0 has been newly created to support randomizer
  calls.
  The module FABCRMIL has been newly created to support XCI
  randomizer calls.
  The module FABC3UCK has been newly created to check USR
  validity.
  The module FABC3URD has been newly created to separate USR
  read process from FABCUR3.
  The module FABCGDD has been included to support DDT build from
  ACBLIB library.
  The macro FABCOP3J has been modified to add a new RAPERROR=
  keyword. This macro is a sample JCL for generation of the
  site default table for Reload processing (FABCUR3).
  The macro FABCOP3M  has been modified to add a new RAPERROR=
  keyword.
  The macro FABC3SBM has been modified to check IMS version of
  ACBLIB library.
  The macro UR3WRK10 has been modified to add new fields for
  RAPERROR= keyword and DBDNAME= keyword.
  The macro UR3WRK20 has been modified to add new fields to DSIT.
  The macro FABALINK has been modified to include the module
  FABC3URD, FABC3ACB, FABC3UCK, FABC3RM0, FABC3RMIL and FABCGDD
  for FABCUR3 LINAKGE/EDIT.
  The JCLIN H31A310J has been modified to include the module
  FABC3URD, FABC3ACB, FABC3UCK, FABC3RM0, FABC3RMIL and FABCGDD
  for FABCUR3 LINAKGE/EDIT.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS High Performance Fast Path Utilities for z/OS User's
  Guide Volume 2: Fast Path Basic Tools Version 3 Release 1
  (SC18-9870-01) should be added and changed as follows:
  
  Chapter 14. Using the DEDB Reload utility FABCUR3
  Job control language (JCL)
  
  4.2.3.2 DD statements
  
  The ACBLIB DD statement is newly added, and the description of
  the RMODLIB DD and DURDBDFN DD are modified.
  
    RMODLIB DD
  |  This statement defines the library where the randomizer
  |  and/or segment edit/compression routines reside.
     The DD statement is not needed when the COMPRESS=Y parameter
     is used even if the DBD contains
     a segment edit/compression routine except if the USEREXIT
     option is specified.
     If the compression routine is changed,
     then the old compression routine should reside
     in the FABCUR3 step RMODLIB DD library
     (with the FABCUR3 COMPRESS=N parameter specified).
     Make sure that the new compression routine resides
     in the FABCUR3 step RMODLIB DD library before attempting
     the DEDB reload.
  |  RMODLIB in the FABCUR3 step is required when a randomizer
  |  is to be used for the RAPERROR=ABEND option.
  |  If this DD statement is not provided, an attempt is made to
  |  load the randomizer and/or edit/compression routine from
  |  JOBLIB/STEPLIB.
  
    DURDBDFN DD
     This statement defines the data set that contains a formatted
     copy of the DMB. It is the DURDBDFN data set from FABCUR1.
  |  Instead of the DURDBDFN DD, you can specify ACBLIB DD
  |  which defines the ACB library containing the DMB for the
  |  databse.
  
  | ACBLIB DD
  |  This statement defines the library containing the DMB for
  |  the database.
  |  Instead of the DURDBDFN DD, you can specify the ACBLIB DD.
  |  DBDNAME= keyword is required to specify the member of ACBLIB
  |  library.
  
  Input
  4.3.5.1.4 Control statement keywords
  
  | DBDNAME=
  |
  |  Optional keyword to specify the DBD name of the DEDB
  |  for the unloaded segment records file.
  |  This keyword is required if ACBLIB DD is specified
  |  instead of DURDBDFN DD to obtain the DEDB definition.
  |  If DURDBDFN DD is specified, this keyword is not
  |  necessary. If this keyword is specified, the DURDBDFN file
  |  is validated to make sure that the correct DURDBDFN file is
  |  provided.
  |  If both ACBLIB library and DURDBDFN file are specified
  |  with the keyword, ACBLIB library is used.
  |
  |   dbdname
  |      Specifies the name of the DBD that is to be used.
  
  | RAPERROR=
  |
  |   This optional keyword specifies whether FABCUR3 checks the
  |   validity of RAP data in the prefix part of the unloaded
  |   segment record
  |   using the result of the randomizer call.
  |
  |
  |  NOCHECK
  |      Specifies that FABCUR3 does not perform the validity
  |      check of the RAP data in the prefix part of the unloaded
  |      segment record by using a randomizer.
  |      This is the default.
  |
  |  ABEND
  |      Specifies that FABCUR3 perform the validity check of
  |      the RAP data in the prefix part of the unloaded segment
  |      record by using a randomizer.
  |      FABCUR3 ends abnormally with an error message
  |      if it found a error.
  |      The DBDNAME= keyword and the ACBLIB DD are required for
  |      the ABEND option.
  |
  
  About FPB.Messages and codes, See Http://www-1.ibm.com/support/
  docview.wss?rs=434&context=SSZJXP&q1=SC18-9870-01&uid=
  swg27011218&loc=en_US&cs=utf-8&lang=en
  

APAR Information

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

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

  UK38019

Modules/Macros

•    FABALINK FABCGDD  FABCOP3J FABCOP3M FABCRMIL
  FABCUR3  FABC3ACB FABC3END FABC3EOJ FABC3EXT FABC3INI FABC3RM0
  FABC3SBM FABC3SB0 FABC3UCK FABC3UOW FABC3URD H31A310J UR3WRK10
  UR3WRK20
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R310 PSY UK38019

     UP08/07/15 P F807