PK83498: FIX ENTERPRISE PL/I NOHOOK COMPILE ENTRY HOOK PLACEMENT PROBLEM

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Fix Enterprise PL/I NOHOOK compile entry hook placement problem
  (the Debug Tool side of this problem is APAR PK79702).
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of the TEST(,,NOHOOK) compile option   *
  *                 in Enterprise PL/I V3R4 and later who are    *
  *                 running with the Debug Tool.                 *
  *                                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: When the TEST(,,NOHOOK) compile option  *
  *                      is used, a single STEP command does     *
  *                      not allow access to the program's       *
  *                      variables or label names.               *
  *                                                              *
  ****************************************************************
  * RECOMMENDATION: Apply the provided PTF.                      *
  *                                                              *
  ****************************************************************
  When a PL/I procedure compiled with the TEST(NOHOOK) option on
  an Enterprise PL/I V3R4 or later compiler is run with
  Debug Tool, the location of the procedure ENTRY break point
  (arrived at after a single STEP statement) is too early in the
  generated code. The pointers required for debugging have not
  been set at that point.
  
  Because the pointers have not been set there is no access to
  variables or labels defined in the procedure. A second STEP
  command must be executed before any program symbols can be
  referenced.
  
  This causes problems for users who need to be able to access
  variables or to set label break points from the Entry Break
  location.
  

Problem conclusion

• The location of the ENTRY breakpoint for a NOHOOK compile has
  been moved slightly farther into the PROLOG code so that the
  variables and label names in the procedure can be accessed
  after a single step.
  
  The ENTRY break point for a TEST(NOHOOK) compile will now
  follow the initialization of the pointers required to access
  the program symbols for debugging, but is still prior to the
  initialization of the procedure variables.
  
  Care must be taken when accessing variables while at the
  Entry break point because the location of the break point
  means that variables may contain unexpected values or data
  that is in a invalid format or have an invalid length in
  the case of a variable length string.
  
  Values can be assigned to variables, but execution of the
  initialization code with the next STEP command may change the
  value.
  
  Session variables can be created and values assigned to them.
  
  Label breakpoints for labels within the current procedure
  can be set while at the ENTRY break point.
  
  Only programs compiled with the Enterprise PL/I V3R4 and later
  compiler using the TEST sub-options:
    BLOCK or PATH or STMT or ALL and SYM and NOHOOK
  are affected by this change.
  
  Procedures compiled using the TEST(HOOK) option will not be
  affected by this APAR.
  
  As a prerequisite for using this support Debug Tool updates
  must also be applied. Without the Debug Tool updates the
  behavior will be unchanged. Apply the PTF associated with the
  following Debug Tool APARs.
  
    APAR PK83511 (For Debug Tool V8R1, FMID HADE810 )
    APAR PK82537 (For Debug Tool V9R1, FMID HADR910 )
  

Temporary fix

Comments

APAR Information

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

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

  UK46554 UK46555 UK46556

Modules/Macros

•    IBMPDAPI IBMPDGNB IBMPDIPE JLE7330Z JLE7340Z
  JLE7350Z
  

Fix information

• Fixed component name

  LE VA PL/I

• Fixed component ID

  568819806

Applicable component levels

• R730 PSY UK46554

     UP09/05/19 P F905

• R740 PSY UK46555

     UP09/05/19 P F905

• R750 PSY UK46556

     UP09/05/19 P F905

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.