HP 3000 Manuals

GENCAT MAKECAT Comparison [ Message Catalogs:Programmer's Guide ] MPE/iX 5.0 Documentation


Message Catalogs:Programmer's Guide

GENCAT MAKECAT Comparison 

To allow you to compare the GENCAT and the MAKECAT utilities, the
differences between GENCAT and MAKECAT are listed in tabular form below.

          Table B-1.  MAKECAT/GENCAT Comparison

--------------------------------------------------------------------------------
| FEATURES       | MAKECAT                             | GENCAT                |
--------------------------------------------------------------------------------
| Access Methods | The FOPEN, GENMESSAGE, and FCLOSE   | CATOPEN, CATREAD, and |
|                | intrinsics open, access, and close  | CATCLOSE intrinsics   |
|                | formatted MAKECAT catalogs.         | open, access and      |
|                |                                     | close formatted       |
|                |                                     | GENCAT catalogs.      |
| Formatting     | Places an internal directory in the | A source message file |
|                | file's user labels.  The file is    | is formatted into     |
|                | formatted in place without creating | another file, leaving |
|                | a new file.                         | the original source   |
|                |                                     | intact.  The          |
|                |                                     | application uses the  |
|                |                                     | formatted file.  The  |
|                |                                     | original source file  |
|                |                                     | can be purged.  The   |
|                |                                     | formatted file can be |
|                |                                     | expanded to restore   |
|                |                                     | the original source   |
|                |                                     | file.                 |
| Function       | Converts or formats HELP and        | Formats application   |
|                | message files into catalogs.        | message catalogs.     |
|                | Installs system message catalog,    | Provides maintenance  |
|                | using the BUILD entry point.        | facility to modify    |
|                |                                     | existing source       |
|                |                                     | catalogs.  Provides   |
|                |                                     | capability of         |
|                |                                     | expanding a formatted |
|                |                                     | file back into the    |
|                |                                     | original source file. |
| Input          | The name of a file must be entered  | GENCAT prompts the    |
|                | in a file equation.  :FILE          | user for the name of  |
|                | INPUT=<your file>.                  | a file.               |
| Literal        | Not supported.                      | The tilde "~" serves  |
| Character      |                                     | as a literal          |
|                |                                     | character, causing    |
|                |                                     | the character which   |
|                |                                     | immediately follows   |
|                |                                     | it to be treated as   |
|                |                                     | text.                 |
| Messages       | The message number range per set is | The message number    |
|                | 1-32,766.                           | range per set is      |
|                |                                     | 1-32,766.             |
| Numerical      | Not supported.                      | Up to 5 numerical     |
| Parameters     |                                     | parameters can be     |
|                |                                     | contained in a        |
|                |                                     | message.              |
--------------------------------------------------------------------------------

          Table B-1.  MAKECAT/GENCAT Comparison (Cont.)

--------------------------------------------------------------------------------
| FEATURES       | MAKECAT                             | GENCAT                |

--------------------------------------------------------------------------------
| Output         | Saves the formatted file as a       | GENCAT prompts the    |
|                | temporary file with the name        | user for the name of  |
|                | CATALOG.                            | the formatted file.   |
|                |                                     | The file is saved as  |
|                |                                     | a permanent file.     |
| Processing     | Formats more quickly than GENCAT.   | GENCAT verifies each  |
|                |                                     | message for correct   |
|                |                                     | parameter             |
|                |                                     | substitution          |
|                |                                     | characters.           |
|                |                                     | Manipulates two       |
|                |                                     | temporary files while |
|                |                                     | formatting the source |
|                |                                     | file.                 |
| Record Format  | Accepts source files of any size,   | Accepts source        |
|                | but the file it saves has a record  | catalog files with    |
|                | size of 80 bytes.  The system       | record sizes from 40  |
|                | message catalog is fixed binary.    | to 256 bytes.  The    |
|                | An application catalog is fixed     | formatted file has a  |
|                | ASCII.                              | record size of 128    |
|                |                                     | words, and is fixed   |
|                |                                     | binary.  When a       |
|                |                                     | formatted catalog is  |
|                |                                     | expanded into a       |
|                |                                     | source catalog, the   |
|                |                                     | new source catalog is |
|                |                                     | fixed ASCII with a    |
|                |                                     | record size identical |
|                |                                     | to the original       |
|                |                                     | source catalog.       |
|                |                                     | When maintenance is   |
|                |                                     | being performed, both |
|                |                                     | the source file and   |
|                |                                     | the maintenance file  |
|                |                                     | must be of equal      |
|                |                                     | lengths in fixed      |
|                |                                     | ASCII. The resulting  |
|                |                                     | source file, and      |
|                |                                     | collision file, if    |
|                |                                     | specified will be     |
|                |                                     | fixed ASCII, and      |
|                |                                     | their record sizes    |
|                |                                     | will equal the record |
|                |                                     | size of the original  |
|                |                                     | source file.          |
| Sets           | The set directive is $SET. The set  | The set directive can |
|                | number range for a catalog is 1-63. | be $SET or $set.  The |
|                |                                     | set number range for  |
|                |                                     | a source catalog is   |
|                |                                     | 1-255.                |
| User Interface | The user must know which entry      | GENCAT is             |
|                | points to use and when to use them. | menu-driven.  The     |
|                | Files are input via file equations. | menus originate from  |
|                | Error messages require user         | a catalog.  Each      |
|                | interpretation.                     | prompt has HELP text  |
|                |                                     | associated with it.   |
|                |                                     | Error messages are    |
|                |                                     | self-explanatory.     |
--------------------------------------------------------------------------------


MPE/iX 5.0 Documentation