Modifying System Message Catalogs [ Introduction to MPE XL for MPE V System Administrators ] MPE/iX 5.0 Documentation
Introduction to MPE XL for MPE V System Administrators
Modifying System Message Catalogs
System message catalogs are files that contain user interface messages,
such as error messages, HELP messages and other displays.
System message catalogs are provided with the operating system.
Application message catalogs can be created by programmers to output
messages to users from applications programs. Both system and
application message catalogs can be customized to reflect on-site needs
and preferences, or translated into new native languages.
NOTE System message catalogs may have already been translated into some
foreign languages; contact a Hewlett-Packard Sales Office for
further assistance.
System messages on MPE XL are contained in three catalogs: CATALOG,
SYSCAT, and CICAT. These catalogs reside in the PUB.SYS group.
Modification of CICAT is described below, in the section on the HELP
Subsystem.
To modify system message catalogs, System Manager status is required.
Modifying CATALOG.PUB.SYS
To modify CATALOG.PUB.SYS, use the following steps:
1. Enter an editor and text in the catalog.
2. Make the necessary changes.
3. Keep the file under a new name and leave the editor.
4. Enter the file equation
:FILE INPUT=newname
5. Now run the MAKECAT program to build the new catalog. Enter:
:RUN MAKECAT.PUB.SYS,BUILD
6. If no errors are encountered, you will see this message:
NEW CATALOG INSTALLED
7. Purge old catalog CAT nn, where nn is an archival number. For
example, CAT1.
NOTE The System Manager can make modifications to existing error
messages, but if new messages are added, the programmer must make
these messages available to the system by writing error trapping
routines.
Modifying SYSCAT.PUB.SYS
To modify SYSCAT.PUB.SYS, use the following steps:
1. Run the GENCAT message catalog utility program by entering :GENCAT
2. Enter 4 (This option expands the formatted SYSCAT catalog back
into an ASCII file.)
3. Enter SYSCAT.PUB.SYS as the name of the formatted catalog to
expand.
4. Enter any file name not currently used for a permanent file as the
name of the new source file.
5. If no errors are encountered, you will see this message:
EXPANSION SUCCESSFULLY COMPLETED
6. Enter an editor and text in the file name of the new source file.
7. Make the necessary changes.
8. Keep the file and leave the editor.
9. Rerun GENCAT
10. Choose 3 to reformat the source file into a new formatted catalog.
11. Enter the name of the source file and a new name for the formatted
catalog.
12. If no errors are encountered, you will see this message:
FORMATTING SUCCESSFUL
13. Purge the unmodified catalog, SYSCAT.
14. Rename the new formatted catalog SYSCAT.
Creating a New System Message Catalog
To completely rewrite a system message catalog, as might be required to
translate a catalog into a different language, follow the above steps for
CATALOG or SYSCAT with the exception that you will write the message
catalog from scratch rather than modifying the old file.
Creating and Modifying an Application Message Catalog
GENCAT utility is also used to create a new application message catalog.
When messages are needed for users with a different native language or
languages from the program itself, separate message catalogs for each
user language can be written. This allows for localizing without
changing the program code. Data manipulation can be done according to
the rules of the particular language or local customs.
Application message catalogs are most often used for language
localization, as described in this chapter under "Using Native Language
Support."
Refer to Message Catalogs Programmer's Guide (32650-90021) for further
details on message catalogs and how they are built and modified.
MPE/iX 5.0 Documentation