Open System Services Shell and Utilities Reference Manual (G06.25+, H06.03+)

gencat(1) OSS Shell and Utilities Reference Manual
\f Inserts a formfeed character.
\\ Inserts a \ (backslash) character.
\ddd Inserts the single-byte character associated with the octal value represented by the
octal digits ddd. You can specify 1, 2, or 3 octal digits; however, you must include
leading zeros if the characters following the octal digits are also valid octal digits. For
example, the octal value for $ (dollar sign) is 44. To insert $5.00 into a message, use
\0445.00, not \445.00, or the 5 will be parsed as part of the octal value.
\xdddd Inserts the single-byte or double-byte character associated with the hexadecimal value
represented by the four valid hexadecimal digits dddd. You can specify either two or
four digits. See the explanation of \ddd for a way to avoid parsing errors when the hex-
adecimal value precedes an actual digit. This escape sequence is an Open System Ser-
vices extension to the XPG4 specification.
You can also include printf( ) conversion specifications in messages that are printed by the
printf() family of calls in C code. If you display a message from a shell script with the dspmsg
command, the only conversion specifications that can be used in the message are %s and %n$s.
When you enter a number followed by a message, gencat removes the first space or tab character
immediately following the number. Any spaces or tabs that follow the first space or tab are con-
sidered part of the message.
Environment Variables
The following environment variables affect the execution of the gencat utility: LANG,
LC_ALL, LC_TYPE, LC_MESSAGES, NLSPATH.
EXAMPLES
1. To use the $set command in a source file to give a group of messages a set number, enter:
$set 10 Communication Error Messages
The message set number is 10. All messages following the $set command are assigned
that set number, up until the next occurrence of a $set command. (Set numbers must be
assigned in ascending order, but need not be contiguous. Large gaps in the number
sequence are discouraged in order to increase efficiency and performance. There is no
performance advantage to using more than one set number in a catalog.)
You can include a comment in the $set command, but it is not required.
2. To use the $delset command to remove all messages belonging to the specified set from a
catalog, enter:
$delset 10 Communication Error Messages
The command set affected by the $delset command is specified by the number argument.
$delset must be placed in the proper set number order with respect to any $set com-
mands in the same message source file. You can include a comment in the $delset com-
mand.
3. To enter message text and assign message ID numbers, enter:
12 file removed
This assigns the message ID number 12 to the text that follows it.
You must specify a single space or tab character between the message ID number and the
message text, but you can include more spaces or tabs if you prefer. Any extra spaces or
tabs included are treated as part of the message itself. Message numbers must be in
ascending order within a single message set, but need not be contiguous.
All text following the message number is included as message text, up to the end of the
4−4 Hewlett-Packard Company 527188-003