CBL_NLS_READ_MSG

国別言語サポート(NLS)のメッセージファイルをからメッセージを読み込む。

構文:
call "CBL_NLS_READ_MSG" using     msg-file-handle
                                  full-msg-number
                                  msg-ins-struct
                                  msg-buffer
                        returning status-code
パラメタ:
呼び出しプロトタイプ使用時 ( 説明の読み方) PIC (32bitシステム)
msg-file-handle cblt-x4-compx. pic x(4).
full-msg-number Group predefined as cblt-nls-msg-number-pair containing: 以下を含む集団項目:
  cblte-nmnp-set-number   cblt-x2-compx.   pic x(2) comp-x.
  cblte-nmnp-number   cblt-x2-compx.   pic x(2) comp-x.
msg-ins-struct Group predefined as cblt-nls-msg-ins-struct containing: 以下を含む集団項目:
  cblte-nmis-ins-count   cblt-x2-compx.   pic x(2) comp-x.
  cblte-nmis-ins-pointer   cblt-pointer. Occurs depending on cblte-nmis-ins-count.   usage pointer occurs n times.
msg-buffer Group predefined as cblt-nls-msg-buffer containing: 以下を含む集団項目:
  cblte-nmb-buff-len   cblt-x2-compx.   pic x(2) comp-x.
  cblte-nmb-buff-text   cblt-x2-compx. Occurs depending on cblte-nmb-buff-len   pic x(n).
status-code 説明の読み方.
入力パラメタ:

msg-file-handle メッセージを取り出すメッセージファイルの識別ハンドル
cblte-nmnp-set-number メッセージを取り出すメッセージファイルにおけるセット
cblte-nmnp-number メッセージを取り出すメッセージセットにおけるメッセージ番号
cblte-nmis-ins-count メッセージに挿入するテキスト部分の数
cblte-nmis-ins-pointer メッセージに挿入するNULLで終わるテキスト部分へのポインタ
cblte-nmb-buff-len メッセージバッファテキストの長さ
出力パラメタ:
cblte-nmb-buff-text 返されたテキスト(ナル終了)
status-code ルーチンが成功したか否かを次のように示す。
0 成功
40 NLSモジュールが初期化されていない
401 メッセージセットが見つからない
402 メッセージがセットにない
403 メッセージが長すぎてメッセージテキストバッファに入らない
404 msg-file-handleが無効

status-codeが上記以外の場合、それは実行時エラーメッセージ番号である。

説明:

各メッセージファイルにおいて、メッセージはセットに分けられる。これにより、必要であればユーザ固有のメッセージセットを省略時のメッセージファイルに定義できる。また、本ルーチンによってテキスト部分をメッセージファイルから取り出されたメッセージに挿入できる。順番は、国別言語の文法に従う。

他参照:

関連項目