z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

gencat
Description Sequence
Vertical tab \v
These sequences must be encoded as singlebyte characters.
The escape sequence \ddd consists of backslash followed by one, two, or three
octal digits, which are taken to specify the value of the desired character. If the
character following a backslash is not one of those specified, the backslash is
ignored.
A backslash (\) followed by a newline character is also used to continue a string on
the following line. Thus the following two lines describe a single message string:
1 This line continues \
to the next line
which is equivalent to:
1 This line continues to the next line
Portability of Message Catalogs
gencat works with the z/OS C runtime library function catgets() to correctly display
message text in the locale that the C program using catgets() is running in. gencat
adds information to the CatalogFile about the codeset that was in effect when
gencat processed the CatalogFile. gencat should be run with the same locale that
the recipients of the messages will be using. This should be the same locale that
was used to create the message text in MessageFile.
Example
Localization
Exit Values
Portability
Message catalogs produced by gencat are binary-encoded, meaning that their
portability cannot be guaranteed between systems. Thus, just as C programs need
to be recompiled, so message catalogs must be re-created via gencat when moved
to another system.
To generate a test.cat catalog from the source file test.msg, enter:
gencat test.cat test.msg
gencat uses the following localization environment variables:
v LANG
v LC_ALL
v LC_CTYPE
v LC_MESSAGES
v LC_SYNTAX
v NLSPATH
0 Successful completion
1 An error occurred
X/Open Portability Guide.
294 z/OS V1R9.0 UNIX System Services Command Reference