Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Tools : LOWER_EBCDIC

LOWER_EBCDIC
Converts a string to lowercase EBCDIC characters. (F)
Invocation
lower_string = LOWER_EBCDIC(string)
 
If string is not Unicode, or if it is Unicode and entirely convertible to EBCDIC, lower_string’s syntax is V (variable-length character string).
If string is Unicode and not entirely convertible to EBCDIC, lower_string’s syntax is UN (Unicode). In string, characters that can be converted are cased and then reverted to Unicode before being added to lower_string. Characters that cannot be converted are added to lower_string unchanged.
The string to convert to lowercase letters. Its syntax is C (fixed-length character), RD (raw data), UN (Unicode), V, or W (double-byte character).
Usage Note
LOWER_EBCDIC lowercases strings using the TIBCO Object Service Broker EBCDIC casing rules.
Example
This rule lowercases a string and prints the result to the message log:

 
LOWERCASE_SAMPLE;
_ LOCAL A;
_ ---------------------------------------------------------------------------
_ ------------------------------------------------------------+--------------
_ A = U'AÇaç'; ¦ 1
_ CALL MSGLOG('CASING OF UNICODE STRING ' || A); ¦ 2
_ CALL MSGLOG(' '); ¦ 3
_ CALL MSGLOG('LOWER_EBCDIC GIVES ' || LOWER_EBCDIC(A)); ¦ 4
_ CALL MSGLOG('SYNTAX IS ' || $GET_SYNTAX(LOWER_EBCDIC(A)); ¦ 5
_ A = $TYPECAST('S', 'V', 4, 0, A); ¦ 6
_ CALL MSGLOG(' '); ¦ 7
_ CALL MSGLOG('CASING OF EBCDIC STRING ' || A); ¦ 8
_ CALL MSGLOG(' '); ¦ 9
_ CALL MSGLOG('LOWER_EBCDIC GIVES ' || LOWER_EBCDIC(A)); ¦ A
_ CALL MSGLOG('SYNTAX IS ' || $GET_SYNTAX(LOWER_EBCDIC(A)); ¦ B

 
Line 1 sets local variable A as a Unicode string. Line 6 changes it to an EBCDIC V string.
Displayed Output for the Rule
Pressing PF2 after executing this rule displays the following:

 
COMMAND ===> SCROLL ===> P
CASING OF UNICODE STRING AÇaç
LOWER_EBCDIC GIVES aÇaç
SYNTAX IS V
 
CASING OF EBCDIC STRING AÇaç
LOWER_EBCDIC GIVES aÇaç
SYNTAX IS V

 
See Also
Related tools: LOWER_UNICODE, LOWERCASE, UPPER_EBCDIC, UPPER_UNICODE, and UPPERCASE.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved