SI43876 - WDS-CBLLE-CMPL-INCORROUT DEBUGGER APPEARS TO SKIP BREAKPOINT

PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

WDS-CBLLE-CMPL-INCORROUT DEBUGGER APPEARS TO SKIP BREAKPOINT


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED      PTF/FIX  LEVEL

TYPE PROGRAM  REL  NUMBER   MIN/MAX  OPTION
---- -------- ---  -------  -------  ------
NONE



NOTICE:
-------
Application of this PTF may disable or render ineffective programs that
use system memory addresses not generated by the IBM translator,
including programs that circumvent control technology designed to limit
interactive capacity to purchased levels.  This PTF may be a prerequisite
for future PTFs.  By applying this PTF you authorize and agree to the
foregoing.

This PTF is subject to the terms of the license agreement which
accompanied, or was contained in, the Program for which you are obtaining
the PTF.  You are not authorized to install or use the PTF except as part
of a Program for which you have a valid Proof of Entitlement.

SUBJECT TO ANY WARRANTIES WHICH CAN NOT BE EXCLUDED OR EXCEPT AS EXPLICITLY
AGREED TO IN THE APPLICABLE LICENSE AGREEMENT OR AN APPLICABLE SUPPORT
AGREEMENT, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON INFRINGEMENT,
REGARDING THE PTF.

The applicable license agreement may have been provided to you in printed
form and/or may be viewed using the Work with Software Agreements (WRKSFWAGR)
CL command.





APAR Error Description / Circumvention

-----------------------------------------------
When using the system debugger to set breakpoints from the
SOURCE view of a COBOL program, a breakpoint may appear one or
more lines after the line where the user attempted to add the
breakpoint if the source code contains one or more COPY
REPLACING statements.

CORRECTION FOR APAR SE48006 :
-----------------------------
A PTF will be issued in V6R1 and other releases as needed.
The PTF will allow the user to specify new environment variable
QIBM_COBOL_SOURCE_DEBUG_VIEW_FIX to correct the problem so that
the breakpoint will be assigned to the correct line from the
debugger source view of the code.

An environment variable is being used because the number of
lines in the compiler listing may be reduced by this fix, as
data in columns 73 to 80 on a COPY REPLACING statement line
will no longer cause the line to be split into two lines in
the listing in most cases.

It should be noted that the environment variable will not be
supported in any releases after V7R1, and this fix will
become the default behavior.

This PTF requires that the environment variable be enabled where
the code will be compiled.  To enable the environment variable
just go to an IBM i command line and enter:
ADDENVVAR ENVVAR(QIBM_COBOL_SOURCE_DEBUG_VIEW_FIX) VALUE(Y)
LEVEL(*SYS)
Then sign off and back on so that it takes effect, or use
LEVEL(*JOB) so that it takes effect immediately but only for
your current job.  Then recompile your COBOL source.

To temporarily turn off this feature, you can use CHGENVVAR
or WRKENVVAR to change the value of the environment variable
to a value other than 'Y', or you can remove the environment
variable.

CIRCUMVENTION FOR APAR SE48006 :
--------------------------------
Compile with option DBGVIEW(*LIST) or
DBGVIEW(*ALL) and set breakpoints from the
listing view rather than the source view.
Alternatively, remove any data from columns
73 to 80 on the lines where COPY REPLACING
is specified in the source code and
recompile before setting breakpoints from
the source view.


Activation Instructions


None.


Special Instructions


This PTF requires that an environment variable be enabled where the
code will be compiled.  The fix will not take effect until this has
been done.  To enable the environment variable just go to an IBM i
command line and enter:
ADDENVVAR ENVVAR(QIBM_COBOL_SOURCE_DEBUG_VIEW_FIX) VALUE(Y) LEVEL(*SYS)
Then sign off and back on so that it takes effect, or use LEVEL(*JOB)
so that it takes effect immediately but only for your current job. Then
recompile your COBOL source.

To temporarily turn off this feature, you can use CHGENVVAR or
WRKENVVAR to change the value of the environment variable to a value
other than 'Y', or you can remove the environment variable.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI43769      WDS-CBLLE-CMPL-INCORROUT COBOL PROGRAM  USING "FILLER" LINKA
   SI40624      WDS-CBLLE-ROUNDING MODE OF RESULT OF FLOATING-POINT
   SI32295      CBLLE-CMPL-MSGMCH3601 COMPILING VERY LARGE ILE COBOL SOURCE
   SI31673      GENERATED PCML ENTRYPOINT NAME SHOULD MATCH PROGRAM-ID NAME.
   SI31673      NON-COMPLEX OCCURS DEPENDING ON (ODO) CAN FAIL WITH CPF955E
   SI31673      WDS-CBLLE PCML GENERATED BY COBOL COMPILER HAS NO OFFSET DAT
   SI31673      WDS-CBLLE-CMPL-F/VOXERROR-T/QBNCRTMD-MSGMCH4227 MCH4227

Summary Information

System..............................................   i
Models..............................................  
Release.............................................   V6R1M0
Recompile...........................................   Y
Library.............................................   QCBLLE
MRI Feature ........................................   NONE
Cum Level...........................................   C2122610

System i Support

IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright © 1996,1997,1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult the Terms of use link for trademark information.

Document information


More support for:

i family

Software version:

V6R1M0

Operating system(s):

OS/400

Reference #:

SI43876

Modified date:

2014-06-17

Translate my page

Content navigation