The DISPLAY-OF Function
The type of the function is alphanumeric.
General Format
Arguments
- Argument-1 identifies the source string to be converted, and must be of class national
. , or UTF-8
-
If argument-1 is of class national or UTF-8, argument-2 must be of class alphabetic or alphanumeric and must be one character
position in length. Argument-2 specifies an alphanumeric substitution character for use in conversion of national or UTF-8
characters for which there is no corresponding alphanumeric character.
- If argument-1 is of class national or UTF-8, argument-2 must be an integer value representing a CCSID conversion table, which
identifies the source code page for the conversion.
Full support for a CCSID value other than 1208 (UTF-8) requires the installation of the appropriate IBM CCSID conversion table; see Installing CCSID Tables for more information. The table name required for a CCSID of nnn is IBM-nnn. For example, to support a CCSID value of 37, you should install table IBM-37. If the required table is not installed or argument-2 is not specified, the conversion is carried out using the default EBCDIC or ASCII code page (according to whether the given CCSID is EBCDIC or not).
Returned Values
- A character string is returned with each national or UTF-8 character of argument-1 converted to its corresponding alphanumeric
character representation, if any. The correspondence of characters between the alphanumeric character set and the national
character set depends on the native environment. or UTF-8
-
If argument-2 is specified, the alphanumeric substitution character is returned for each national character in argument-1
that has no corresponding alphanumeric character representation.
-
If argument-2 is unspecified, each national or UTF-8 character in argument-1 that has no corresponding alphanumeric character
representation is returned as the '?' character.
- The length of the returned value is the number of character positions of usage display required to hold the returned value;
it is dependent on the characters in the argument and on the attributes of the national
character set. or UTF-8