U@GETCOLPHRXLT

U@GETCOLPHRXLT 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 U@GETCOLPHRXLT 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 U@GETLOCCLPHRX.

Module DATABASE

Required Fields

Field Type and length Definition
E@COLPHRROWCNT N 4 Maximum number of rows in the translation.
E@COLPHRCOLWDT N 4 Maximum number of characters in a row.
E@COLPHRROW 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.
E@COLPHRXLTROW 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 E@COLPHRXLT 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.

     EVAL      E@COLPHRROWCNT = 3
     EVAL      E@COLPHRCOLWDT = 8
     EVAL      E@COLPHRROW(1) = first-row 
     EVAL      E@COLPHRROW(2) = second-row 
     EVAL      E@COLPHRROW(3) = third-row 
     CALLP     U@GETCOLPHRXLT