ISO2002ENTMF 

The DISPLAY-OF Function

The DISPLAY-OF function returns a character string containing the alphanumeric character representation - the external format representation - of a national or UTF-8 character string.

The type of the function is alphanumeric.

General Format


Syntax for General Format for the DISPLAY-OF function

Arguments

  1. Argument-1 identifies the source string to be converted, and must be of class national

    ENTMF , or UTF-8

    .
  2. ISO2002MF 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.
  3. ENTMF 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

  1. 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

    ENTMF or UTF-8

    character set depends on the native environment.
  2. ISO2002MF 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.
  3. ISO2002MF 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.
  4. 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

    ENTMF or UTF-8

    character set.