PH69556: SUPPORT UTF-8 SENDERS IN MOVES TO NUMERIC RECEIVERS AND IN COMPARISONS WITH OTHER NUMERIC DATA ITEMS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• To expand our UTF-8 support to more closely match our NATIONAL
  support,  Enterprise COBOL will both support moving UTF-8
  senders and  comparisons between UTF-8 items and all of  the
  following receivers:
  1) zoned decimal (incl national decimal)
  2) packed decimal (usage comp-3)
  3) binary (usage comp, comp-4, binary, comp-5)
  4) numeric-edited (incl national numeric edited)
  5) external float (incl national ext float)
  6) internal float (usage comp-1, comp-2)
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of Enterprise COBOL 6.5 compiling and  *
  *                 running programs that 1) perform moves from  *
  *                 a UTF-8 sender to a category numeric,        *
  *                 numeric-edited, external float, or internal  *
  *                 float receiver; or 2) perform comparisons    *
  *                 between a UTF-8 operand and an operand of    *
  *                 category numeric or external float.          *
  ****************************************************************
  * PROBLEM DESCRIPTION: New function: 1) Moves from a UTF-8     *
  *                      sender to a category numeric,           *
  *                      numeric-edited, external float, or      *
  *                      internal float receiver are now         *
  *                      supported. 2) Comparisons between a     *
  *                      UTF-8 operand and an operand of         *
  *                      category numeric or external float      *
  *                      operand are now supported.              *
  ****************************************************************
  * RECOMMENDATION: Apply the IBM-provided PTF.                  *
  ****************************************************************
  1) Performing moves from UTF-8 sender to category numeric,
  numeric-edited, external float, or internal float receiver were
  resulting in compilation error IGYPA3005 (move not supported).
  2) Performaing comparisons between UTF-8 operand and an operand
  of category numeric or external float were resulting in
  compilation error IGYPA3022 (comparison not supported).
  

Problem conclusion

Temporary fix

Comments

• The compiler was updated so that 1) user can perform moves from
  UTF-8 sender to category numeric, numeric-edited, external
  float, or internal float receiver. 2) user can perform
  comparisons between UTF-8 operand and an operand of category
  numeric or external float.
  
  For a description of changes related to the support of 1) Move
  of UTF-8 sender to category numeric, numeric-edited, external
  float, or internal float receiver; or 2) Comparison of UTF-8
  operand with an operand of category numeric or external float,
  please refer to the following sections in the Enterprise COBOL
  for z/OS 6.5 IBM Documentation online:
  
  1) Programming Guide -> Coding your program
       -> Processing data in an international environment
       -> Using UTF-8 data (Unicode) in COBOL -> Converting to or
       from UTF-8 (Unicode) representation
  
  2) Programming Guide -> Coding your program
       -> Processing data in an international environment
       -> Using UTF-8 data (Unicode) in COBOL -> COBOL statements
       and UTF-8 data items
  
  3) Language reference -> PROCEDURE DIVISION -> PROCEDURE
       DIVISION statements -> MOVE statement -> Elementary move
       rules
  
  4) Language reference -> PROCEDURE DIVISION -> PROCEDURE
       DIVISION statements -> MOVE statement -> Valid and invalid
       elementary moves
  
  5) Programming Guide -> Coding your program
       -> Processing data in an international environment
       -> Using UTF-8 data (Unicode) in COBOL -> Comparing UTF-8
       data
  
  6) Language reference -> PROCEDURE DIVISION -> Procedure
       division structure -> Conditional expressions -> General
       relation conditions -> UTF-8 comparisons
  

APAR Information

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

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

Modules/Macros

• IGY8RWTU IGYCASMB IGYCCBE  IGYCCCRT IGYCCICS IGYCCSRV IGYCDGEN
  IGYCDIAG IGYCDMAP IGYCEN$0 IGYCEN$1 IGYCEN$2 IGYCEN$3 IGYCEN$4
  IGYCEN$5 IGYCEN$8 IGYCEN$D IGYCEN$R IGYCFGEN IGYCFREE IGYCINIT
  IGYCJA$0 IGYCJA$1 IGYCJA$2 IGYCJA$3 IGYCJA$4 IGYCJA$5 IGYCJA$8
  IGYCJA$D IGYCJA$R IGYCJGEN IGYCLIBR IGYCLSTR IGYCLVL0 IGYCLVL1
  IGYCLVL2 IGYCLVL3 IGYCLVL8 IGYCMALL IGYCOSCN IGYCPGEN IGYCRCTL
  IGYCRDPR IGYCRDSC IGYCREAL IGYCRWT  IGYCSCAN IGYCSIMD IGYCUE$0
  IGYCUE$1 IGYCUE$2 IGYCUE$3 IGYCUE$4 IGYCUE$5 IGYCUE$8 IGYCUE$D
  IGYCUE$R IGYCXREF IGYDRV   IGYEQCWI IGYMSGE  IGYMSGK  IGYMSGT
  IGYQCBE  IGYQSPLT IGYZQEN6 IGYZQENU IGYZQJP6 IGYZQJPN
  

Fix information

• Fixed component name

  ENT COBOL FOR Z

• Fixed component ID

  5655EC600

Applicable component levels

• R650 PSY UO06512

     UP26/01/27 P F601  

• R651 PSY UO06513

     UP26/01/27 P F601  

• R652 PSY UO06514

     UP26/01/27 P F601  

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.