PM60149: LIU UTILITIES SUPPORT FOR (/CK,START_VALUE,LENGTH_VALUE) IN SRCH= AND SUBSEQ= PARM OF FPSI XDFLD STATEMENT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• When using DBDs or ACBs which have indexed DEDB and
  (/CK,start_value,length_value) in SRCH= or SUBSEQ= parameter of
  XDFLD statement, some of LIU utilities cannot work correctly:
  
  1. Consistency Checker cannot obtain generated date and
  generated IMS version of DBD.
  
  2. DBD/ACB Compare utility
   - The utility cannot compare (/CK,start_value,length_value)
  in SRCH= and SUBSEQ= parameter of XDFLD statement.
  The case of REPORT=SOURCE is specified in SYSIN DD:
   - When processing DBDs, generated date of DBDs cannot be
  obtained.
   - When processing ACBs, ABENDS0C4 or ABENDS16E can occur.
  
  3. DBD/ACB Mapper utility
   - When processing DBDs, generated date and
  (/CK,start_value,length_value) in SRCH= and SUBSEQ= parameter of
  XDFLD statement cannot be obtained.
   - When processing ACBs, ABENDS0C4 can occur.
  
  4. DBD/ACB Reversal utility
   - When processing DBDs, generated date and
  (/CK,start_value,length_value) in SRCH= and SUBSEQ= parameter of
  XDFLD statement cannot be obtained.
   - When processing ACBs, ABENDS0C4 or ABENDS16E can occur.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS Library Integrity Utilities for z/OS,    *
  *                 Version 2 Release 1 (FMID=H27P210) users.    *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables Library Integrity     *
  *                      Utilities to support a new Fast Path    *
  *                      Secondary Index (FPSI) function,        *
  *                      a new value format                      *
  *                      (/CK,start_value,length_value) in SRCH= *
  *                      and SUBSEQ= parameters of XDFLD         *
  *                      statement for indexed DEDB.             *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR includes the following enhancements to support a new
  Fast Path Secondary Index function, a new value format
  (/CK,start_value,length_value) in SRCH= and SUBSEQ= parameters
  of XDFLD statement for indexed DEDB:
  
  - Consistency Checker utility can obtain correct generated date
    and generated IMS version of DBD which includes values in the
    new format.
  - DBD/PSB/ACB Compare utility can compare values in the format
    (/CK,start_value,length_value) in SRCH= and SUBSEQ= parameter
    of XDFLD statement.
  - DBD/PSB/ACB Reversal utility can decode values in the format
    (/CK,start_value,length_value) in SRCH= and SUBSEQ= parameter
    of XDFLD statement and obtain correct generated date of DBD
    which includes values in the new format.
  - DBD/PSB/ACB Mapper utility can report values in the format
    (/CK,start_value,length_value) in SRCH= and SUBSEQ= parameter
    of XDFLD statement and obtain correct generated date of DBD
    which includes values in the new format.
  
  Also, this APAR fixes the following error of DBD/PSB/ACB Mapper:
  
  - Start values for SRCH=, SUBSEQ= and DDATA= are extended from 3
    to 5 digits in DBD report, PSB report, ACB(PSB) report and
    ACB(DBD) report in the SYSPRINT data set.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS Library Integrity Utilities for z/OS Version 2 Release 1
  User's Guide (Document Number: SC19-2479-01) should be changed
  as follows.
  ================================================================
  --------------------------------------------------------------
  5.0           DBD/PSB/ACB Compare utility
  5.7.2         SYSPRINT data set
  5.7.2.1       Block level compare reports
  --------------------------------------------------------------
  The following columns are added to Table 7:
  
   +-------+---------------------------------------------+
   |Section|Description                                  |
   +-------+---------------------------------------------+
   |  ...  |...                                          |
   +-------+---------------------------------------------+
  ||CKTBL1 |Contains the /CK search field information    |
  ||       |about DEDB DBD.                              |
  |+-------+---------------------------------------------+
  ||CKTBL2 |Contains the /CK subsequence field           |
  ||       |information about DEDB DBD.                  |
  |+-------+---------------------------------------------+
  --------------------------------------------------------------
  6.0           DBD/PSB/ACB Mapper utility
  6.7.2         SYSPRINT data set
  6.7.2.2       DBD report
  --------------------------------------------------------------
  The following description is added:
  
   - For other index field types, the following is printed:
  
     - **SERARCH**
     - **SUBSEQ**
     - **SOURCE**
  
   - The field name,length, and the start values.
  |  The field name for the value in the format (/CK,start_value,
  |  length_value) specified in SRCH= or SUBSEQ= parameter of the
  |  XDFLD statement always starts and ends with "*".
  

APAR Information

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

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

  UK78631

Modules/Macros

• FABLACBC FABLADPL FABLADP0 FABLCOMP FABLDBDT
  FABLDBD0 FABLECHK FABLEDBD FABLLOAD FABMAMAP FABMBMAP FABMDBLC
  FABMDCVC FABMDMAP FABMPMAP FABNACB0 FABNDBLC FABNDCOD FABNDCVC
  FABNLCH0 FABNPDBD
  

Fix information

• Fixed component name

  IMS LIBR INTEG

• Fixed component ID

  5655I4200

Applicable component levels

• R210 PSY UK78631

     UP12/05/11 P F205

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.