OpenVMS マニュアル

XTPU$HANDLER

このルーチンはDEC XTPU の条件ハンドラです。DEC XTPU 条件ハンドラは， Put Message($PUTMSG) システム・サービスを呼び出し， XTPU$MESSAGE のアドレスを渡します。

形式

XTPU$HANDLER signal_vector, mechanism_vector

戻り値

OpenVMS 用法	条件値
データ型	符号なしロングワード
アクセス	書き込みのみ
受け渡し方	値による

ロングワードの条件値です。

引数

signal_vector

OpenVMS 用法	引数リスト
データ型	符号なしロングワード
アクセス	変更
受け渡し方	参照による

シグナル・ベクタです。条件ハンドラに渡されるシグナル・ベクタについての説明は，『OpenVMS System Services Reference Manual』を参照してください。

mechanism_vector

OpenVMS 用法	引数リスト
データ型	符号なしロングワード
アクセス	読み取りのみ
受け渡し方	参照による

条件ハンドラに渡されるメカニズム・ベクタについての説明は，『OpenVMS System Services Reference Manual』を参照してください。

説明

XTPU$MESSAGE ルーチンは実際のメッセージ出力を実行します。 Put Message ($PUTMSG) システム・サービスはメッセージを書式整形するだけです。このルーチンは， 第 6.1.2 項 で説明した変数からメッセージ・フラグの設定と機能名を入手します。これらの値を変更できるのは，DEC XTPU の SET 組込みプロシージャだけです。

ハンドラが受け取った条件値に FATAL ステータスが含まれている場合や， DEC XTPU のファシリティ・コードが含まれていない場合には，条件が再通知されます。

条件が XTPU$_QUITTING，XTPU$_EXITING，またはXTPU$_RECOVERFAIL の場合には，条件ハンドラを設定したルーチンに対して，UNWIND 要求が与えられます。

メッセージを処理したあと，条件ハンドラは継続ステータスを戻します。 DEC XTPU エラー・メッセージ要求は，どのメッセージを出力しなければならないかを示す条件を通知することによって実行されます。シグナル・アレイに含まれる引数は，正しく書式整形されたメッセージ引数ベクタです。このベクタには，関連するメッセージに対する複数の条件と書式整形された ASCII 出力(FAO) 引数が含まれていることがあります。たとえば，存在しないファイルをエデイタがオープンしようとした場合には，DEC XTPU のメッセージとして XTPU$_NOFILEACCESS が通知されます。このメッセージに対する FAO 引数は，ファイルの名前を示す文字列です。この条件にはエラー・ステータスが含まれており，そのあとに RMS のステータス・フィールド(STS)とステータス値フィールド (STV)が続きます。この条件には回復不可能な重大なエラーは含まれていないので，エラーを処理したあと，エディタは処理を継続できます。

エディタは XTPU$CONTROL から自動的に戻るわけではありません。したがって，XTPU$CONTROL ルーチンを呼び出す場合には，制御をエディタに戻すための方法を設定しておかなければなりません(たとえば，CALL_USER 組込みプロシージャを使用します)。また，ユーザ作成条件ハンドラを設定したものの，特定の条件に対してはDEC XTPU ハンドラを呼び出す場合には，プログラムの中で制御を戻したい場所に，省略時の条件ハンドラを設定しておかなければなりません。また，XTPU$SPECIFY_ASYN_ACTION および XTPU$TRIGGER_ASYNC_ACTION の非同期ルーチンを使って，XTPU$CONTROL を中断することもできます。

『OpenVMS Calling Standard』を参照してください。

XTPU$INITIALIZE

このルーチンはテキスト処理のために DEC XTPU を初期化します。このルーチンはグローバル・データ構造を割り当て，グローバル変数を初期化し，仮想ファイル・マネージャやスクリーン・マネージャ，入出力サブシステムも含めて，エディタの主要コンポーネントのそれぞれに対して，適切なセットアップ・ルーチンを呼び出します。

形式

XTPU$INITIALIZE callback [,user_arg]

戻り値

OpenVMS 用法	条件値
データ型	符号なしロングワード
アクセス	書き込みのみ
受け渡し方	値による

ロングワードの条件値です。ユーティリティ・ルーチンはほとんど，条件値を R0 に戻します。このルーチンから戻される可能性のある条件値は，"戻される条件値" にまとめられています。

引数

callback

OpenVMS 用法	符号なしロングワード・ベクタ
データ型	バウンド・プロシージャ値
アクセス	読み取りのみ
受け渡し方	ディスクリプタによる

コールバック・ルーチンです。引数 callback は，初期化パラメータを含むアイテム・リストのアドレスを返すユーザ作成ルーチンか，またはファイル入出力操作を処理するルーチンのアドレスです。このコールバック・ルーチンは，コマンド・ライン解析ルーチン (XTPU$CLIPARSE か，またはユーザ作成の解析ルーチンのいずれか) を呼び出さなければなりません。

呼び出し可能なDEC XTPU は，初期化パラメータを指定するために使用できるアイテム・コードを定義しています。これらのコードを使用するときには，以下の基準に従ってください。

• XTPU$_OTHER_FILENAMES は，XTPU$_FILENAME の後で使わなければなりません。

• XTPU$_CHAIN または XTPU$_ENDLIST はリストの最後のアイテムでなければなりません。

図 6-3 は，アイテムディスクリプタの一般的な形式を示しています。アイテム・リストの作成方法についての詳しい説明は，使用する各言語のプログラマ・マニュアルを参照してください。

図 6-3 アイテムディスクリプタのフォーマット

アイテムディスクリプタのリターン・アドレスは，通常0です。

使用できるアイテム・コードは 表 6-2 に示すとおりです。

表 6-3 は，XTPU$K_OPTIONS アイテム・コードによって与えられるビットと対応するマスクをまとめたものです。

フラグを作成するには，0という値から開始し，セットしたい各アイテムのマスク (XTPU$M…)に対して，OR 演算子を使用します。また，フラグを作成する別の方法として，32 ビットをビット・ベクタとして取り扱い，希望するアイテムに対応するビット(XTPU$V…)をセットする方法もあります。

user_arg

ユーザ引数。user_arg 引数はユーザによって書かれた初期化ルーチン INITIALIZEに渡されます。

user_arg 引数によって，アプリケーションは XTPU$INITIALIZE を通してユーザによって書かれた初期化ルーチンに情報を渡すことができます。 DEC XTPU はこのデータを解釈しません。

説明

このルーチンは，条件ハンドラを設定したあとで最初に呼び出さなければならないルーチンです。

このルーチンは，コールバック・ルーチンから受け取った情報に応じてエディタを初期化します。初期化ルーチンは，省略時の値として，すべてファイル指定をヌル文字列に設定し，すべてのオプションをオフの状態に設定します。しかし，ファイル入出力ルーチンや USER ルーチンの省略時のアドレスは設定しません。

セクション・ファイルを指定しなかった場合には，エディタのソフトウェア機能は制限されます。

戻される条件値

XTPU$_SUCCESS	初期化が正常終了したことを示します。
XTPU$_SYSERROR	システム・サービスが正しく機能しなかったことを示します。
XTPU$_NONANSICRT	入力装置(SYS$INPUT)がサポートされないターミナルであることを示します。
XTPU$_RESTOREFAIL	復元操作でエラーが発生したことを示します。
XTPU$_NOFILEROUTINE	ファイル操作を実行するためのルーチンが設定されていないことを示します。
XTPU$_OPENDIC	かな漢字変換辞書がオープンできなかったことを示します。
XTPU$_INSVIRMEM	エディタが初期化を実行するのに十分な仮想メモリが存在しないことを示します。
XTPU$_FAILURE	初期化を実行しているときに発生した他のすべてのエラーを示す汎用コードです。