HP 3000 Manuals

Message Catalogs:Programmer's Guide

Overview 

This chapter tells you how to use system error messages as output from
your applications.  It explains:

 *  Message Catalog Format

 *  Accessing CATALOG.PUB.SYS, the CM error message catalog, using:

      - HPFOPEN to open the catalog

      - GENMESSAGE to read and output message

      - FCLOSE to close the catalog

 *  Accessing SYSCAT.PUB.SYS, the NM error message catalog using:

      - CATOPEN to open the catalog

      - CATREAD to read and output messages

      - CATCLOSE to close the catalog

CATALOG.PUB.SYS contains the CM error messages.  It was formatted with
the MAKECAT.PUB.SYS program.  The catalog is opened and closed with the
HPFOPEN and FCLOSE intrinsics; messages are read with the GENMESSAGE
intrinsic.  GENMESSAGE allows you to access the message catalog and
substitute parameters in the message.

SYSCAT.PUB.SYS contains the NM error messages.  This message catalog was
formatted with the GENCAT.PUB.SYS program.  You use the catalog
intrinsics to open, read from, and close this catalog.  They are CATOPEN,
CATREAD, and CATCLOSE. CATREAD allows parameter substitution where
applicable.

Both CATALOG.PUB.SYS and SYSCAT.PUB.SYS may be accessed from Native Mode.
Figure 5.1 shows the catalogs and the intrinsics that access them.


          Figure 5.1.  Accessing System Error Messages

MPE/iX 5.0 Documentation