PK24576: PROVIDE SITE DEFAULT SUPPORT FOR FABCUR9.

APAR status

• Closed as new function.

Error description

• Provide site default support for FABCUR9.
  This is an enhancement that is derived from requirement
  MR0516052016.
  

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: FABCUR9 supports Site Default options.  *
  *                      This is FITS MR0516052016 requirement.  *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This enhancement is for FITS MR0516052016.
  FABCUR9 (DEDB/HD Unload Conversion utility) supports
  Site Default options.
  

Problem conclusion

Temporary fix

Comments

• A macro FABCOP9M which is to define the Site Default Table
  (FABCOP9D) for FABCUR9 and a sample JCL FABCOP9J which is to
  generate the Site Default table were provided.
  
  FABCUR9 has been modified to set the user default value from
  Site Default Table (FABCOP9D) and reports the values to SYSPRINT
  DD data set.
  FABCUR9M has been modified to add new message  FABC0127I.
  FABCUR9I has been modified from a concatenation expression
  with a variable length string to a concatenation expression
  with a fixed length and move operation in order not to be caused
  a PL/X-390 compile error.
  
  ----------------------------------------------------------------
  Documentation Changes:
  The 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) should be added and changed as follows:
  
  Appendix L. FPB Site Default support
  
    *The following description should be added as follows:
  
      FPB allows you to specify Site Default parameters for
      the following programs:
  
         DEDB Pointer Checker: FABADA1
         DEDB Unload: FABCUR1
         DEDB Reload: FABCUR3
         DEDB Reload Segment Data Set Create utility: FABCUR6
   |     DEDB/HD Unload Conversion utility: FABCUR9
  
      The macros and sample JCL in Table 54 are provided to
      generate the Site Default Table. If you want to change some
      or all keywords by using this function, you must generate
      the Site Default Table by using the following macros.
  
        Table 54. Macros and JCLs for Site Default table
        +------------+-------------+--------------+
        | Program    | Macro       | Sample JCL   |
        +------------+-------------+--------------+
        | FABADA1    | FABAOP1M    | FABAOP1J     |
        +------------+-------------+--------------+
        | FABCUR1    | FABCOP1M    | FABCOP1J     |
        +------------+-------------+--------------+
        | FABCUR3    | FABCOP3M    | FABCOP3J     |
        +------------+-------------+--------------+
        | FABCUR6    | FABCOP6M    | FABCOP6J     |
        +------------+-------------+--------------+
   |    | FABCUR9    | FABCOP9M    | FABCOP9J     |
        +------------+-------------+--------------+
  
      You might specify only the keywords that you want to change.
      This Site Default Table library must be concatenated to
      the FPB load module library in the JOBLIB or STEPLIB DD
      statement .
  
      Note: For details about using these macros, see each macro
            header.
  
  ----------------------------------------------------------------
  Appendix N. FPB.Messages and codes
   FABC messages
  
   *Following messages descriptions should be changed as follows:
  
     FABC0127I - FOLLOWING VALUES ARE DEFINED BY SITE DEFAULT
                 TABLE (FABCOP9D)
                 - keyword=value
                 - keyword=value
  
     Explanation: This message is generated to show the Site
   | Default Table (FABCOP1D/FABCOP3D/FABCOP6D/FABCOP9D) being
     processed.
   | System Action: FABCUR1/FABCUR3/FABCUR6/FABCUR9 uses them
     as Control Statement default values and continues processing.
     Programmer Response: None
  
  ----------------------------------------------------------------
   FABD messages
  
   *Following messages descriptions should be changed as follows:
  
     FABD3672E INVALID keyword= KEYWORD SITE DEFAULT ERROR
               DETECTED
  
     Explanation: An incorrect parameter was specified for
   | the FABAOP1M, FABCOP1M, FABCOP3M, FABCOP6M, or FABCOP9M
     macro keyword.
     System action: The assemble step ends with a return code
     of 8.
     Programmer response: Correct the error, and rerun the job.
  
     ---------------------------------------------------------
     FABD3674E NO KEYWORD IS SPECIFIED FOR SITE DEFAULT TABLE
  
     Explanation: No keyword is specified for the FABAOP1M,
   | FABCOP1M, FABCOP3M, FABCOP6M, or FABCOP9M macro.
     System action: The assemble step ends with a return code
     of 8.
     Programmer response: Correct the error, and rerun the job.
  
     ---------------------------------------------------------
     FABD3675I keyword= PARAMETER IS IGNORED BECAUSE DEFAULT
               VALUE IS SPECIFIED
  
     Explanation: A keyword= parameter was specified that is
     the same as the system default value. The FABAOP1M,
   | FABCOP1M, FABCOP3M, FABCOP6M, or FABCOP9M macro skips
     generating an entry of the Site Default Table for keyword=.
     System action: The assemble step continues normal processing.
     Programmer response: None.
  
     ---------------------------------------------------------
     FABD3676E macro-name MACRO SPECIFIED MORE THAN ONCE
  
   | Explanation: The FABAOP1M, FABCOP1M, FABCOP3M, FABCOP6M,
   | or FABCOP9M  macro was specified more than once.
     This macro must be specified only once when TABLESET=USER
     is specified (default value).
     System action: The assemble step ends with a return code
     of 8.
     Programmer response: Correct the error, and rerun the job.
  
     ---------------------------------------------------------
   *Following messages descriptions should be added as follows:
  
     FABD3677E IMSCOMP=/DLICOMP= KEYWORDS ARE MUTUALLY EXCLUSIVE
     FABD3677E AREA_INFORMATION_RECORD=/AIR= KEYWORDS ARE MUTUALLY
               EXCLUSIVE
   | FABD3677E INPUT=/FORMAT= KEYWORDS ARE MUTUALLY EXCLUSIVE
  
     Explanation: The keyword of an unsuitable combination was
     specified.
     System action: The assemble step ends with a return code
     of 8.
     Programmer response: Correct the error, and rerun the job.
  

APAR Information

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

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

  UK14536

Modules/Macros

•    FABCOP9J FABCOP9M FABCUR9  FABCUR9I FABCUR9M
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R220 PSY UK14536

     UP06/05/17 P F605