Translating Application Phrases

Use this procedure to translate application phrases if you want to use ASCII text files.

Note: To ensure all phrases and column phrases are loaded, perform both ldappphr and ldappclmphr utility procedures.

For more information, see these sections Application Phrases, The Text File Translation Process, and Application Phrase and Column Phrase Translation Files.

To translate application phrases

  1. Create an ASCII text file of the application phrases to translate.
    1. At the command line, type:

      dmpappphr [-l language [-t]] [-n] [-x] dumpfile productline [systemcode]

    2. Type the following selections.
      Program Option Description
      -l language Dump phrases in this language.
      -t Dump only those phrases that do not have translations for the indicated language.
      -x Dump only phrases that contain at least one alpha character.
      -n Do not dump extended phrase translations. If you do not specify this option, the application phrase dump will have an additional fifth line for every entry that has an extended phrase translation. The line will be prefixed with #$.
      Field Description
      dumpfile File in which to store the application phrases.
      productline Product line for which to dump phrases.
      systemcode System code for which to dump phrases.
    3. Press Enter.

      The program runs and displays a message when it finishes.

    4. Transfer the file to your word processing or translation program.

    Example: Dump Application Phrase

    The output of dmpappphr is in alpha order. It indicates the minimum and maximum sizes of the space available on different screen forms for a phrase. The last line includes a short translation if one is defined for the language. Otherwise, the last line is a blank line available for creating a short translation. The following example shows sample output from dmpappphr.

    ~$ Currency
    ~# Minimum Output Size = 08, Maximum Translation Size = 50
    Currency
    ~$Currency Accounts
    ~# Minimum Output Size = 19, Maximum Translation Size = 19
    Currency Accounts
    ~$Currency Code
    ~# Minimum Output Size = 14, Maximum Translation Size = 30
    Currency Code
  2. Translate the application phrases in the ASCII text file using your word processing or translation program.
    Note: The ASCII text file must have been created by dmpappphr so that it contains the ~$ lines that indicate the address for each phrase. Do not change any line that begins with ~$ or ~#. These lines are address lines and size information lines that enable the translations to load to the proper location in the Environment. Type the translated text below the address and size information lines.
  3. Load the application phrase file into the Environment.
    1. In your word processing or translation program, save the file of translated phrases as an ASCII (text only) file.
    2. Transfer the file from your PC to the server.
    3. At the command line, type:

      ldappphr [-n] dumpfile language

    4. Type the following selections.
      Field Description
      dumpfile File containing the translated phrases.
      language Language the phrases have been translated into.
      -n Do not load extended phrase translations. If you do not specify this option, the application phrase load will include the additional fifth line for every entry that has an extended phrase translation.
    5. Press Enter.

      The program overwrites all existing phrases for that product line and language.

      The ldappphr utility uses the comment line produced by the dmappphr utility to check the size of the translated phrase against the maximum size stored in the comment line. If the translated phrase is greater than the maximum size indicated or if there are any other errors, ldappphr puts the offending items into the error file, ldappphr.err. This file can then be edited, renamed, and reloaded using ldappphr.