900-GET-COL-PHRASE-XLT

900-GET-COL-PHRASE-XLT finds the translation for a specified phrase and returns it to the caller in columns. If the user has only one base language defined, the routine returns the input phrase as the result.

The 900-GET-COL-PHRASE-XLT routine retrieves a phrase by using the locale set in the user's profile. To retrieve phrases in columns using a specified locale, use the routine 900-GET-LOCALE-COL-PHRASE-XLT.

Library DATABASE

Required Fields

Field Type and length Definition
WS-COL-PHRASE-ROW-COUNT N 4 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 25 One row of the English phrase used to retrieve the translated phrase. Occurs up to five times. Number of characters in all occurrences cannot exceed 50.
CRT-COL-PHRASE-XTL-ROWS A 25

One row of the translated phrase. Occurs up to five times. Number of characters in all occurrences cannot 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.

Programming Example

This example translates a column phrase to the target language.

      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).
      PERFORM 900-GET-COL-PHRASE-XLT.