セクション 1 - コマンド

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > Tuxedo > Tuxedo コマンド・リファレンス > セクション 1 - コマンド

Tuxedo コマンド・リファレンス

gencat(1)

名前

gencat－フォーマットされたメッセージ・カタログを生成

形式

gencat [-m] catfile msgfile  . . .

機能説明

gencat ユーティリティは、メッセージ・テキストのソース・ファイル msgfile をフォーマットされたメッセージ・データベース catfile にマージします。このデータベースがなければ、データベース catfile が作成されます。catfile が存在する場合には、そのメッセージが新しい catfile に組み込まれます。セット番号とメッセージ番号が矛盾する場合には、msgfile に定義されている新しいメッセージ・テキストが catfile に現在格納されている古いメッセージ・テキストと置き換わります。gencat に入力されるメッセージ・テキストのソース・ファイルには、セット番号とメッセージ番号、あるいはメッセージ番号のみ (この場合、セット NL_SETD (nl_types(5) 参照) が想定されます) のいずれかを収めることができます。

メッセージ・テキストのソース・ファイルの形式は、次のように定義されています。ただし、メッセージ・テキストのソース行のフィールドは 1 つの ASCII の空白またはタブ文字で区切ります。その他の ASCII の空白やタブは、次のフィールドの一部とみなされます。

$set n comment

ここで、n は次の $set、$delset またはファイル終わりまで下記メッセージのセット識別子を指定します。n は範囲 (1-{NL_SETMAX}) 内の数字でなければなりません。1 つのソース・ファイル内のセット識別子は連続している必要はありません。セット識別子に続く文字列はすべて、注釈として扱われます。$set ディレクティブの指定がメッセージ・テキスト・ソース・ファイルにない場合、すべてのメッセージはデフォルトのメッセージ・セット NL_SETD に格納されます。

$delset n comment

既存のメッセージ・カタログからメッセージ・セット n を削除します。セット番号に続く文字列はすべて、注釈として扱われます(注：n が有効なセットでない場合は無視されます)。

$ comment

ドル記号 ($) に続いて ASCII の空白またはタブ文字がある行は、注釈として扱われます。

m message_text

m はメッセージ識別子で、これは範囲 (1-{NL_MSGMAX}) 内の番号ですこのメッセージ・テキストの構文と、「注記」で説明する -m コマンド行オプションの構文とを混同しないようにしてください。メッセージ・テキストは、セット識別子が最後の $set ディレクティブによって指定され、かつメッセージ識別子が m である状態でメッセージ・カタログに格納されます。メッセージ・テキストが空で、ASCII の空白またはタブ・フィールド区切り文字があると、空の文字列がメッセージ・カタログに格納されます。メッセージ・ソース行にメッセージ番号があっても、フィールド区切り文字もメッセージ・テキストもない場合は、その番号を持つメッセージ (ある場合) がカタログから削除されます。メッセージ識別子は必ずしも連続している必要はありません。メッセージ・テキストの長さは、範囲 (0-{NL_TEXTMAX}) 内とします。

$quote c

この行は任意の引用文字 c を指定します。この文字は、後置きスペースやヌル (空) メッセージをメッセージ・ソース行で見分けやすいようにメッセージ・テキストを囲むときに使用できます。デフォルトの設定の場合、あるいは空の $quote ディレクティブが指定されている場合には、メッセージ・テキストに引用符を付けても認識されません。メッセージ・テキスト・ソース・ファイル内では、空の行は無視されます。テキスト文字列には、次の表に定義されている特殊な文字とエスケープ文字を含めることができます。

説明	記号	エスケープ・シーケンス
改行	NL(LF)	¥n
水平タブ	HT	¥t
垂直タブ	VT	¥v
バックスペース	BS	¥b
復帰	CR	¥r
用紙送り	FF	¥f
バックスラッシュ	¥	¥¥
ビット・パターン	ddd	¥ddd

エスケープ・シーケンス ¥ddd は、バックスラッシュとそれに続く 1、2 または 3 桁の 8 進数からなり、目的の文字の値を指定します。バックスラッシュに続く文字が指定されたものの 1 つでない場合には、バックスラッシュは無視されます。

バックスラッシュの次に ASCII の改行文字を使用して、文字列を次の行に継続させることもできます。たとえば、次の 2 行は 1 つのメッセージ文字列を表しています。

1 This line continues ¥ 
to the next line

上記のメッセージは下のメッセージと同じです。

1 This line continues to the next line

移植性

gencat は、BEA Tuxedo サーバ環境がサポートされるプラットフォームで実行できます。

注意事項

このバージョンの gencat は、実行時に、malloc によって割り当てられた領域に読み取られるカタログを生成します。gencat のいくつかのバージョンで利用できる共用カタログはこのバージョンでは利用できません。一部のシステムでは、malloc で割り当てられたカタログの生成には -m オプションの指定が必要とされます。このオプションはコマンド行で指定することもできますが、その場合は何も機能しません。malloc で割り当てられたカタログがデフォルトの設定です。-m オプションは互換性を保持する目的でのみサポートされています。

このコマンドで生成されるカタログ・ファイルのサイズは 64K までに限定されています。それ以上のサイズになるような場合には、このコマンドからエラーが報告され、カタログ・ファイルは生成されません。