PK88173: ALLOW LANG=PL/I IN PSB OF HDTA AND DBSR

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• The APAR allows HD Tuning Aid(HDTA) and DB Segment
  Restructure(DBSR) to support a PSB that is generated with
  LANG=PL/I. This APAR addresses FITS REQ MR0529096113.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS High Performance Pointer Checker for *
  *                 z/OS Version 3 Release 1 (FMID=HPC2310)      *
  *                 users who use HD Tuning Aid (HDTA) or DB     *
  *                 Segment Restructure (DBSR).                  *
  ****************************************************************
  * PROBLEM DESCRIPTION: HDTA and DBSR support PSB created with  *
  *                      LANG=PL/I option.                       *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  After applying APAR PK73036, HDTA and DBSR issue MSGFABT3642E or
  MSGFABR3642E and end with ABENDU3642 in case of the PSB created
  with LANG=PL/I option.
  By this APAR, HDTA and DBSR are enhanced to run with the PSB
  created with LANG=PL/I option.
  

Problem conclusion

Temporary fix

Comments

• Documentation Changes:
  Note: The section numbers are those of the BookManager (BKMGR)
  book.
  The documentation is modified as follows:
  ==============================================================
    IMS High Performance Pointer Checker for z/OS, V3R1,
    User's Guide (SC19240100)
  ==============================================================
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2.0        HD Pointer Checker
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  --------------------------------------------------------------
  2.2        Operating instructions for the HD Pointer Checker
             processor
  2.2.1      JCL control language
  2.2.1.1    FABPMAIN JCL
  2.2.1.1.1  EXEC statement
  --------------------------------------------------------------
  The following description is modified:
  
    psbname
      Specifies the PSB name that contains the PCB of the
      processing databases. The PSB name must be defined as a PSB
  |   with LANG=ASSEM, LANG=COBOL, or LANG=PL/I. It must refer
      directly or indirectly to all input databases. The PSB, in
      which less than 2,500 of database data sets are referred to,
      can be used in the HD Pointer Checker run.
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  3.0        HD Tuning Aid
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  --------------------------------------------------------------
  3.2        Operating instructions for HD Tuning Aid
  3.2.1      JCL control language
  3.2.1.1    FABTROOT JCL
  --------------------------------------------------------------
  The following description is modified:
  
    EXEC
    :
    :
      The PARM parameter has the same format as that used in the
      DLIBATCH procedure. The parameters shown need to be coded.
  |   The psbname must be defined as a PSB with LANG=ASSEM,
  |   LANG=COBOL, or LANG=PL/I. It must refer (either directly or
      indirectly) to all input databases. If HALDB is processing,
      dbrc must be Y.
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  6.0        DB Segment Restructure
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  --------------------------------------------------------------
  6.2        Operating instructions for DB Segment Restructure
  6.2.2      JCL control language
  6.2.2.1    FARUNLD JCL
  --------------------------------------------------------------
  The following description is modified:
  
    EXEC
    :
    :
          The PSB must have these characteristics:
      - It is sensitive only to the segments to be unloaded.
      - It contains PROCOPT=G on the PCB statement.
  |   - It contains LANG=ASSEM, LANG=COBOL, or LANG=PL/I on the
        PSBGEN statement.
  --------------------------------------------------------------
  6.2.2.2    FARRELD JCL
  --------------------------------------------------------------
  The following description is modified:
  
    EXEC
    :
    :
      The PSB must have these characteristics:
      - It contains PROCOPT=L or PROCOPT=LS (on the PCB statement)
        if you are using FABRRELD as an initial load program.
      - It contains PROCOPT=A (on the PCB statement) if you are
        using FABRRELD as an update program.
  |   - It contains LANG=ASSEM, LANG=COBOL, or LANG=PL/I on the
        PSBGEN statement.
  --------------------------------------------------------------
  6.5        Conversion to DEDB
  6.5.2      FABRRELD JCL
  --------------------------------------------------------------
  The following description is modified:
  
    EXEC
    :
    :
      The PSB must have these characteristics:
      - It contains PROCOPT=I or PROCOPT=A (on the PCB statement)
        if you are using FABRRELD as an initial load program.
      - It contains PROCOPT=A (on the PCB statement) if you are
        using FABRRELD as an update program.
  |   - It contains LANG=ASSEM, LANG=COBOL, or LANG=PL/I on the
        PSBGEN statement.
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  7.0        Troubleshooting
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  --------------------------------------------------------------
  7.1        Messages and codes
  7.1.2      HD Tuning Aid
  7.1.2.3    Messages
  7.1.2.3.32 FABT3642E
  --------------------------------------------------------------
  The following descriptions are modified:
  
  | FABT3642E PSB MUST BE GENERATED WITH LANG=ASSEM, LANG=COBOL,
  | OR LANG=PL/I
  
    Explanation: The specified PSB is not generated with
  | LANG=ASSEM, LANG=COBOL, or LANG=PL/I.
  
    System Action: HD Tuning Aid ends with a USER 3642 abend.
  
    Programmer Response: Specify the correct PSB and rerun the
    job.
  
    Problem Determination: Check the PSB source of the PSB and
  | make sure that the PSBGEN statement has LANG=ASSEM,
  | LANG=COBOL, or LANG=PL/I.
  --------------------------------------------------------------
  7.1.5      DB Segment Restructure
  7.1.5.3    Messages
  7.1.5.3.38 FABR3642E
  --------------------------------------------------------------
  The following descriptions are modified:
  
  | FABR3642E PSB MUST BE GENERATED WITH LANG=ASSEM, LANG=COBOL,
  | OR LANG=PL/I
  
    Explanation: The specified PSB is not generated with
  | LANG=ASSEM, LANG=COBOL, or LANG=PL/I.
  
    System Action: The program ends with a USER 3642 abend.
  
    Programmer Response: Specify the correct PSB and rerun the
    job.
  
    Problem Determination: Check the PSB source of the PSB and
  | make sure that the PSBGEN statement has LANG=ASSEM,
  | LANG=COBOL, or LANG=PL/I.
  

APAR Information

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

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

  UK47541

Modules/Macros

•    FABRRELD FABRUNLD FABTMSGS FABTROOT
  

Fix information

• Fixed component name

  IMS POINTER CHE

• Fixed component ID

  5655E0900

Applicable component levels

• R310 PSY UK47541

     UP09/06/19 P F906

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.