900-GET-LOCALE-COL-PHRASE-XLT

900-GET-LOCALE-COL-PHRASE-XLT allows a developer using a specified locale to retrieve a translated phrase in columns. Use this API when the translation has columns whose width requires the text to be split into multiple rows. To retrieve phrases in columns when using the locale set in the user's profile, use 900-GET-COL-PHRASE-XLT.

Library DATABASE

Required Fields

Field Type and length Definition
WS-COL-PHRASE-ROW-COUNT N 4 Indicates the maximum number of rows in the translation.
WS-COL-PHRASE-COL-WIDTH N 4 Maximum number of characters in a row.
CRT-COL-PHRASE-ROW A 50 One row of the English phrase used to retrieve the translated phrase. Occurs up to 5 times. Number of characters in all occurrences can not exceed 50.
CRT-COL-PHRASE-XTL-ROWS A 50

One row of the translated phrase. Occurs up to 5 times. Number of characters in all occurrences can not exceed 50.

If the routine cannot find the locale, the locale's language, or the translated phrase, or it finds incorrect values for rows or width, the English phrase is passed back in the CRT-COL-PHRASE-XLT field instead of a translated phrase. The API never returns an error; it either retrieves the translation, or passes back the English phrase.
CRT-LOCALE A 10 Locale used to retrieve the translated phrase.

Programming Example

This example retrieves a phrase.

      MOVE 3                      TO WS-COL-PHRASE-ROW-COUNT.
      MOVE 8                      TO WS-COL-PHRASE-COL-WIDTH.
      MOVE first-row              TO CRT-COL-PHRASE-ROW(1).
      MOVE second-row             TO CRT-COL-PHRASE-ROW(2).
      MOVE third-row              TO CRT-COL-PHRASE-ROW(3).
      MOVE locale-name            TO CRT-LOCALE.
      PERFORM 900-GET-LOCALE-COL-PHRASE-XLT.