HP 3000 Manuals

Operation [ MPE/iX System Utilities Reference Manual ] MPE/iX 5.0 Documentation


MPE/iX System Utilities Reference Manual

Operation 

The system manager initiates the LANGINST utility by entering:

     LANGINST 

When the LANGINST main menu appears, you choose one of the following
functions:

     0.  EXIT
     1.  ADD LANGUAGE TO LANGDEF
     2.  DELETE LANGUAGE FROM LANGDEF
     3.  MODIFY NATIVE FORMATS
     4.  LIST HP SUPPORTED LANGUAGES
     5.  MODIFY THE SYSTEM DEFAULT LANGUAGE
     6.  LIST LANGUAGES CURRENTLY CONFIGURED
     7.  DISPLAY TRANSLATION TABLES

Listing Supported Languages 

To list languages that are configurable on the system, select option 4
from the LANGINST main menu.  You'll see a display like the one below.

     HP SUPPORTED LANGUAGES:

      0 NATIVE-3000          using          USASCII
      1 AMERICAN             using          ROMAN8
      2 CANADIAN-FRENCH      using          ROMAN8
      3 DANISH               using          ROMAN8
      4 DUTCH                using          ROMAN8
      5 ENGLISH              using          ROMAN8
      6 FINNISH              using          ROMAN8
      7 FRENCH               using          ROMAN8
      8 GERMAN               using          ROMAN8
      9 ITALIAN              using          ROMAN8
     10 NORWEGIAN            using          ROMAN8
     11     .                  .              .
     12     .                  .              .
     13     .                  .              .

     press any key to continue ...

Adding a Language 

To add a language, select option 1 from the LANGINST main menu.  When the
Add Language to LANGDEF menu is displayed, enter:

   1.  The language name or language ID number.

          *   The addition is aborted if one of the following conditions
              is met:
                 *   Entering a language that is already configured on
                     the system.
                 *   Entering a language not supported by NLS.
                 *   Pressing Return.

          *   The addition continues if a language is requested that is
              supported but has not been previously configured.  LANGINST
              configures the language and displays a message.

   2.  When the addition is completed, the LANGINST main menu is
       displayed.

Deleting a Language 

LANGINST allows the system manager to delete any configured language
except NATIVE-3000 (which is hard-coded and therefore always configured)
and the system default language.

To delete a language, select option 2 from the LANGINST main menu.  When
the Delete Language from LANGDEF menu is displayed, enter:

   1.  The language name or language ID number.

          *   The deletion is aborted if one of the following conditions
              is met:
                 *   Entering a language that is not configured on the
                     system.
                 *   Entering the system default langauge.
                 *   Pressing Return.

          *   The deletion continues if the language requested is
              configured but is not the system default language.

   2.  When the deletion is completed, the main menu is displayed.

Modifying Local Formats 

As the system manager, you can modify the following local formats for any
configured language:

   *   Date format (dateline format).

   *   Custom date format (short).

   *   Time format.

   *   Currency sign/name.

   *   Decimal and thousands indicator.

   *   Month names.

   *   Abbreviated month names.

   *   Weekday names.

   *   Abbreviated weekday names.

   *   Yes/no indicators.

   *   Direction of text.

   *   ASCII/EBCDIC translation tables.

   *   National date table.

If the language supports a special national table containing date
information ( such as KATAKANA), the last option lets the user modify the
date information.

To modify local language formats, select option 3 from the LANGINST main
menu.  When the Modufy Native Formats menu is displayed, enter:

   1.  The language name or language ID number.

          *   The modification is aborted if one of the following
              conditions is met:
                 *   Entering a language that is not configured on the
                     system.
                 *   Entering NATIVE-3000.
                 *   Pressing Return.

          *   The modification continues if the language requested is
              configured.

   2.  If a configured language is entered, the user dialog is displayed:

      1.  Long calendar format
      2.  Date format         (Calendar format)
      3.  Custom date format  (Short)
      4.  Time format         (Clock format)
      5.  Currency sign
      6.  Currency name
      7.  Decimal and thousands separator
      8.  Alternate numeric format
      9.  YES and NO equivalents
     10.  Month names.
     11.  Month name abbreviations
     12.  Weekday names
     13.  Weekday name abbreviations
     14.  Direction of text
     15.  ASCII/EBCDIC translation tables
     16.  Handle truncation in date format
     17. Process the national date table
     18. 16-bit Asian ASCII to EBCDIC translation table
     19. 16-bit Asian EBCDIC to ASCII translation table

     Enter selection number        : 5
     Business Currency sign        : F
     Enter the new value           : Return 
     Fully qualified Currency sign : FF
     Enter the new value           : Return 
     The currency sign currently follows the number, 100DM.

     The following currency codes are available:

     <CR> to retain the existing value.
     0 - The currency symbol precedes the number, $100.00.
     1 - The currency symbol succeeds the number, 100.00DM.
     2 - The currency symbol replaces the decimal point, 100$00.

     Enter the required currency codes (0, 1, or 2) :Return 

     There are to be no blanks before or after the currency symbol.
     The following blank-control codes are available:

     <CR> to retain the existing value.
     0 - No blanks before or after the currency symbol.
     1 - A blank is to precede the currency symbol.
     2 - A blank is to succeed the currency symbol.
     3 - A blank is to precede and succeed the currency symbol.

     Enter the required code (0, 1, 2, or 3):Return 

After you make a selection, the current value is displayed and you are
prompted for a new value.  If you enter a new value, LANGINST validates
and replaces the old value with the current one.

After you have made changes to the file, a new copy of it is saved under
the name LANGDEF and the old (unchanged) version of the file is saved
under the name LANGDxxx.  The number xxx increases by one each time a new
copy of LANGDEF is saved.  This allows the user to return to a
configuration that existed before LANGDEF was changed.  To return to the
previous configuration, PURGE or RENAME the current LANGDEF then RENAME
the LANGDxxx with the highest number LANGDEF.

Modifying ASCII/EBCDIC Translation Tables 

To modify the ASCII/EBCDIC translation tables for any language other than
NATIVE-3000, select option 3 from the LANGINST main menu.  When the
Modify Native Formats menu is displayed, enter:

   1.  The language name or language ID number.

          *   The modification is aborted if one of the following
              conditions is met:
                 *   Entering a language that is not configured on the
                     system.
                 *   Entering NATIVE-3000.
                 *   Pressing Return.

          *   The modification continues if the language requested is
              configured.

   2.  If a configured language is entered, the following user dialog is
       displayed:

      1.  Long calendar format
      2.  Date format         (Calendar format)
      3.  Custom date format  (Short)
      4.  Time format         (Clock format)
      5.  Currency sign
      6.  Currency name
      7.  Decimal and thousands separator
      8.  Alternate numeric format
      9.  YES and NO equivalents
     10.  Month names.
     11.  Month name abbreviations
     12.  Weekday names
     13.  Weekday name abbreviations
     14.  Direction of text
     15.  ASCII/EBCDIC translation tables
     16.  Handle truncation in date format
     17. Process the national date table
     18. 16-bit Asian ASCII to EBCDIC translation table
     19. 16-bit Asian EBCDIC to ASCII translation table

     Enter selection number        : 15

     Input ROMAN8 character to be changed (HEX please) : 04
     The current EBCDIC value is : 37
     Enter the new EBCDIC value : 44
     The ROMAN8 to EBCDIC table was updated
     The EBCDIC to ROMAN8 table will be updated too
     ASCII/EBCDIC table inconsistent for 44 <== 04,C8   (*)
     The tables are inconsistent for ROMAN8 character C8   (**)
     The current EBCDIC value is : 44
     Enter the new EBCDIC value : 37
     The ROMAN8 to EBCDIC table was updated
     The EBCDIC to ROMAN8 table will be updated too

     Input ROMAN8 character to be changed (HEX please): Return 
     Do you want to save the changes (Y/N) : Y

Notes: 

*     There are two ASCII characters mapping to the same EBCDIC
      character.

**    Change the mapping of C8 to its new EBCDIC value.

To display the translation tables, return to the main menu and enter
option 7.  Then enter the language ID number and the table you want to
display.

Modifying 16-Bit Asian ASCII/EBCDIC Translation Tables 

To modify the 16-bit Asian ASCII/EBCDIC translation tables for any
language other than NATIVE-3000, select option 3 from the LANGINST main
menu.  When the Modify Native Formats menu is displayed, enter:

   1.  The language name or language ID number.

          *   The modification is aborted if one of the following
              conditions is met:
                 *   Entering a language that is not configured on the
                     system.
                 *   Entering NATIVE-3000.
                 *   Pressing Return.

          *   The modification continues if the language requested is
              configured.

   2.  If a configured language is entered, the following user dialog is
       displayed:

      1.  Long calendar format
      2.  Date format         (Calendar format)
      3.  Custom date format  (Short)
      4.  Time format         (Clock format)
      5.  Currency sign
      6.  Currency name
      7.  Decimal and thousands separator
      8.  Alternate numeric format
      9.  YES and NO equivalents
     10.  Month names.
     11.  Month name abbreviations
     12.  Weekday names
     13.  Weekday name abbreviations
     14.  Direction of text
     15.  ASCII/EBCDIC translation tables
     16.  Handle truncation in date format
     17. Process the national date table
     18. 16-bit Asian ASCII to EBCDIC translation table
     19. 16-bit Asian EBCDIC to ASCII translation table

     Enter selection number        : 18

     The current default translation value is  0000

     Enter the new value (HEX please)        : 0000

     Input Asian character (HEX please)      : c1c4   (*)
     Current translation value is (in HEX)   : 0000   (*)
     Input new translation value (HEX please): a1a1

     Input Asian character (HEX please)      : a1b2   (*)
     Current translation value is (in HEX)   : 4FE3   (**)
     Input new translation value (HEX please): 4fe3   (***)

     Input Asian chracater (HEX please)      : 00a5   (****)

     *** The character (00a5) is not defined.         (****)

     Input Asian chracater (HEX please)      : RETURN 

      1.  Long calendar format
      2.  Date format         (Calendar format)
      3.  Custom date format  (Short)
      4.  Time format         (Clock format)
      5.  Currency sign
      6.  Currency name
      7.  Decimal and thousands separator
      8.  Alternate numeric format
      9.  YES and NO equivalents
      .        .
      .        .
      .        .

Notes: 

*                     If adding a new character, the current translation
                      value is 0000 (in HEX).

**                    What is currently being mapped.

***                   Change to indicated new value.

****                  Invalid input was entered.

To display the translation tables, return to the main menu and enter
option 7.  Then enter the language ID number and the table you want to
display.

          Table 11-1.  LANGINST Error Messages 

----------------------------------------------------------------------------------------------
|                              |                              |                              |
|           Message            |            Cause             |            Action            |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| A NONNUMERIC GRAPHIC         | An alphabetic or special     | Enter a valid character.     |
| CHARACTER IS EXPECTED...     | character (not numeric) is   |                              |
|                              | expected.                    |                              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| ATTEMPTING TO ADD TOO MANY   | Adding this language would   | Do not configure languages   |
| CHARACTER SETS.              | exceed the maximum           | from so many character sets. |
|                              | configurable character sets. |                              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| BUILDING AN EMPTY LANGDEF... | There was no existing        | None.  If you have already   |
|                              | LANGDEF file; a new, empty   | configured languages, find   |
|                              | one is being built.          | LANGDEF.PUB.SYS on a backup  |
|                              |                              | and restore it; or else,     |
|                              |                              | reconfigure the languages    |
|                              |                              | with this program.           |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| DELETION                     | The language NATIVE-3000     | None.                        |
| TERMINATED...ATTEMPTING TO   | cannot be deleted from the   |                              |
| DELETE NATIVE-3000.          | list of configured           |                              |
|                              | languages.                   |                              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| ERRONEOUS STARTING YEAR      | The year number entered is   | Enter the year number again. |
| NUMBER. EXPECTED A NUMBER    | not valid.                   | It must be a number between  |
| BETWEEN 0 AND 99.            |                              | 0 and 99.                    |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| INPUT TOO LONG...PLEASE      | The program does not expect  | Re-enter the data correctly. |
| REENTER:                     | this much input in this      |                              |
|                              | context.                     |                              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| INTERNAL ERROR...PLEASE      | Internal error.              | Contact your Hewlett-Packard |
| REPORT.                      |                              | representative.              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| INVALID DATE FORMAT.         | The entered date is not      | Enter the date again in the  |
| EXPECTED MM/DD/YY.           | valid.                       | from MM/DD/YY.               |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| langname IS ALREADY          | The language selected has    | None.                        |
| CONFIGURED.                  | already been configured.     |                              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| langname IS AN ILLEGAL       | The language name or number  | Enter the language again.    |
| LANGUAGE NAME (OR NUMBER).   | entered is not valid.        |                              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| langname IS AN INVALID       | The language selected is not | Add the language to the list |
| SYSTEM DEFAULT LANGUAGE.     | configured on the system.    | of currently configured      |
|                              |                              | languages with this program. |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| langname IS NOT A CONFIGURED | The language selected is not | Add the language to the list |
| LANGUAGE.                    | configured on the system.    | of currently configured      |
|                              |                              | languages with this program. |
|                              |                              |                              |
----------------------------------------------------------------------------------------------

          Table 11-1.  LANGINST Error Messages (cont.) 

----------------------------------------------------------------------------------------------
|                              |                              |                              |
|           Message            |            Cause             |            Action            |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| langname IS NOT CONFIGURED.  | The language selected is not | Add the language to the list |
|                              | configured on the system.    | of currently configured      |
|                              |                              | languages with this program. |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| langname IS NOT IN THE       | One of the CHRDEFxx files is | Restore all CHRDEFxx files   |
| CHRDEF FILE.                 | not consistent with the      | and NLSDEF from your master  |
|                              | NLSDEF file.                 | backup.                      |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| NATIVE-3000 IS ALWAYS        | NATIVE-3000 cannot be added  | None.                        |
| CONFIGURED.                  | to the list of configured    |                              |
|                              | languages; it is always      |                              |
|                              | configured.                  |                              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| NATIVE-3000 MAY NOT BE       | The language definition of   | None.                        |
| MODIFIED.                    | NATIVE-3000 cannot be        |                              |
|                              | modified.                    |                              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| THE CHRDEFxx FILE IS         | The character definition     | Restore the missing file     |
| MISSING.  THE ADDITION HAS   | file for the selected        | from your master backup.     |
| BEEN CANCELLED.              | language is missing.         |                              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| THE DECIMAL SEPARATOR AND    | The decimals and thousands   | Change the decimal and/or    |
| THOUSANDS SEPARATOR SHOULD   | separators have been defined | thousands indicator.         |
| BE DIFFERENT.                | the same.                    |                              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| THE EXPECTED NAME SHOULD     | Only alphabetic characters   | Please re-enter the value,   |
| CONTAIN ALPHABETIC           | are allowed in this context. | restricting the input to     |
| CHARACTERS ONLY.             |                              | alphabetic characters.       |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| THE FILECODE FOR             | The character definition     | Restore the missing CHRDEFxx |
| CHRDEFxx.PUB.SYS IS          | file for the selected        | file from the master backup. |
| INCORRECT.                   | language has a bad file      |                              |
|                              | code.                        |                              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| THE FILECODE FOR             | The current language         | Restore LANGDEF.PUB.SYS from |
| LANGDEF.PUB.SYS IS           | definition file has a bad    | a backup copy.  Or purge it, |
| INCORRECT.                   | file code.                   | and re-create it by          |
|                              |                              | reconfiguring the desired    |
|                              |                              | languages with this program. |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| THE FILECODE FOR             | The master NLS definition    | Restore NLSDEF.PUB.SYS from  |
| NLSDEF.PUB.SYS IS INCORRECT. | file has a bad file code.    | the master backup.           |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| THE LANGUAGE YOU ARE         | The system default language  | To delete this language,     |
| ATTEMPTING TO DELETE IS THE  | cannot be deleted from the   | first change the system      |
| SYSTEM DEFAULT LANGUAGE.     | list of configured           | default language to another  |
|                              | languages.                   | language.                    |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| THE USER SHOULD BE           | The user is not              | Log on as MANAGER.PUB.SYS    |
| MANAGER.SYS, RUNNING IN THE  | MANAGER.PUB.SYS.             | and run the program again.   |
| PUB GROUP.                   |                              |                              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------

          Table 11-1.  LANGINST Error Messages (cont.) 

----------------------------------------------------------------------------------------------
|                              |                              |                              |
|           Message            |            Cause             |            Action            |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| THERE IS NO MORE ROOM FOR    | There is no room for         | Contact your Hewlett-Packard |
| ADDITIONAL DATE PERIODS.     | additional entries in the    | representative.              |
| PLEASE REPORT.               | national date table.         |                              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| TOO MANY LANGUAGES HAVE BEEN | Adding another language      | Don't configure so many      |
| CONFIGURED.                  | would exceed the maximum     | languages on one system.     |
|                              | configurable languages.      |                              |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| UNABLE TO RENAME LANGDEF TO  | The old LANGDEF file cannot  | Purge some or all of the     |
| LANGDnnn.  THE EXISTING      | be renamed; all files        | files LANGD000 to LANGD999   |
| LANGDEF WILL BE PURGED.      | LANGD000 through LANGD999    | so the most recent changes   |
|                              | already exist.               | to LANGDEF can be saved in   |
|                              |                              | the future.                  |
|                              |                              |                              |
----------------------------------------------------------------------------------------------
|                              |                              |                              |
| UNKNOWN OPTION....  PLEASE   | The option selected is not   | Enter the number             |
| REENTER.                     | valid.                       | corresponding to one of the  |
|                              |                              | valid options.               |
|                              |                              |                              |
----------------------------------------------------------------------------------------------



MPE/iX 5.0 Documentation