Changes to Gen runtime function SUBSTRDBCS in Gen r7.6 GA and subsequent PTFs.

Document ID : KB000051685
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

There have been some changes to the way that the Gen runtime function SUBSTRDBCS works in Gen r7.6 GA and subsequent PTFs. This document describes the impact of those changes.

Solution:

SUBSTRDBCS for all runtime except for Blockmode and Server Runtime on z/OS was changed in Gen r7.6 GA to count using "character" instead of "byte" for the arguments of starting position and substring length.

SUBSTRDBCS for Blockmode and Server Runtime on z/OS is still counting using "byte" in Gen r7.6 GA, but PTF RTM76011 (QO93484) has changed this to count using "character" (the PTF also changes runtime function SUBSTRMIXED to work in the same way, but currently there is no plan to change SUBSTRMIXED for other platforms).

Effects of changing to "character" instead of "byte"

Before applying the PTF (Bold character is DBCS):

E.g. substrdbcs("1 2 3 4 5 6 7 8 9 A B C D E",9,4) will return "5 6"

After applying the PTF (Bold character is DBCS):

E.g. substrdbcs("1 2 3 4 5 6 7 8 9 A B C D E",9,4) will return "9 A B C"

The following table summarizes the SUBSTRDBCS functionality for Gen r7.6 before and after the PTF installation. The new Gen r8 release also has the same functionality as Gen r7.6 with the PTF installed.

Packaging.NETJavaWindows/Cooperative ClientOnline/Cooperative Server
GUIz/OSWindowsUnix
Before apply PTFcharactercharactercharacterBytecharactercharacter
PTFNoneNoneNoneRTM760111NoneNone
After apply PTFcharactercharactercharactercharacter2charactercharacter

1 RTM76011 is superseded by Runtime Consolidation PTF - RTM76035 (RO17214).

2 This is also the new functionality for SUBSTRMIXED (z/OS only). For distributed platforms SUBSTRMIXED counts in bytes for Gen r7.6 and continues to do so in Gen r8.

Please contact CA Support, if you have any questions or require further advice on this topic.