日本-日本語
日本HPホーム 製品 & サービス OpenVMS製品情報
≫  お問い合わせ


OpenVMS マニュアル


 

OpenVMS ドキュメント
ライブラリ

タイトルページ
目次
まえがき
第 1 章:DEC XTPU の概要
第 2 章:DEC XTPU のデータ・タイプ
第 3 章:DEC XTPU 言語のレキシカル要素
第 4 章:DEC XTPU 組込みプロシージャ
第 5 章:DEC XTPU の起動
第 6 章:呼び出し可能なDEC XTPU
付録 A :DEC XTPUにおける端末装置のサポートと制限事項
付録 B :DEC XTPU メッセージ
索引
PDF
OpenVMS ホーム
日本語 HP OpenVMS

日本語 HP OpenVMS
DEC XTPU リファレンス・マニュアル


目次 索引




このルーチンは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』を参照してください。




このルーチンはテキスト処理のために 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-2 使用できるアイテム・コード
アイテム・コード 説明
XTPU$_OPTIONS コマンド修飾子を使用可能にします。バッファ・アドレス・フィールドの14ビットは,いろいろな DEC XTPU コマンド修飾子に対応しています。バッファ・アドレス・フィールドの残りの18ビットは使用されません。
XTPU$_JOURNALFILE /JOURNAL 修飾子に指定されている文字列を渡します。バッファ長フィールドは文字列の長さであり,バッファ・アドレス・フィールドは文字列のアドレスです。これは,GET_INFO (COMMAND_LINE,"JOURNAL_FILE") で使用できる文字列です。この文字列はヌル文字列でもかまいません。
XTPU$_SECTIONFILE マッピングされるバイナリ初期化ファイル(セクション・ファイル)の名前を示す文字列を渡します。バッファ長フィールドは文字列の長さであり,バッファ・アドレス・フィールドは文字列のアドレスです。DEC XTPU の CLD ファイルには,この文字列の省略時の値が含まれています。 XTPU$V_SECTION ビットがセットされている場合には,このアイテム・コードを指定しなければなりません。
XTPU$_OUTPUTFILE /OUTPUT 修飾子に指定されている文字列を渡します。バッファ長フィールドは文字列の長さであり,バッファ・アドレス・フィールドは文字列のアドレスを指定します。これは,GET_INFO (COMMAND_LINE,"OUTPUT_FILE") 組込みプロシージャから戻される文字列です。文字列はヌル文字列でもかまいません。
XTPU$_DISPLAYFILE /DISPLAY 修飾子に指定されている文字列を渡します。バッファ長フィールドは文字列の長さであり,バッファ・アドレス・フィールドは文字列のアドレスを指定します。
XTPU$_COMMANDFILE /COMMAND 修飾子に指定されている文字列を渡します。バッファ長フィールドは文字列の長さであり,バッファ・アドレス・フィールドは文字列のアドレスです。この文字列は,GET_INFO (COMMAND_LINE,"COMMAND_FILE") 組込みプロシージャから戻される文字列です。文字列はヌル文字列でもかまいません。
XTPU$_FILENAME コマンド・ラインに指定されている入力ファイルの名前を示す文字列を渡します。バッファ長フィールドはこの文字列の長さを指定し,バッファ・アドレス・フィールドはアドレスを指定します。これは, GET_INFO (COMMAND_LINE,"FILE_NAME") 組込みプロシージャから戻される文字列です。このファイル名はヌル文字列でもかまいません。
XTPU$_OTHER_FILENAMES コマンド・ラインに指定されている入力ファイルのうち一番目を除くものの名前を示す文字列を渡します。バッファ長フィールドはこの文字列の長さを指定し,バッファ・アドレス・フィールドはアドレスを指定します。 2番目以降の入力ファイルはそれぞれ XTPU$_OTHER_FILENAMES のエントリが必要です。これは,GET_INFO (COMMAND_LINE,"NEXT_FILE_NAME") 組込みプロシージャから戻される文字列です。
XTPU$_FILEIO ファイル操作を処理するために使用されるルーチンのバウンド・プロシージャ値を渡します。自分で作成したファイル入出力ルーチンを使用することもファイル操作を処理するためにDEC XTPU が提供するユーティリティ・ルーチンである XTPU$FILEIO を呼び出すこともできます。ファイル入出力ルーチンのアドレスは,バッファ・アドレス・フィールドに指定します。
XTPU$_CALLUSER CALL_USER 組込みプロシージャが呼び出すユーザ作成ルーチンのバウンド・プロシージャ値を渡します。このルーチンのアドレスはバッファ・アドレス・フィールドに指定します。
XTPU$_INIT_FILE /INITIALIZATION 修飾子に指定されている文字列を渡します。バッファ長フィールドは文字列の長さであり,バッファ・アドレス・フィールドは文字列のアドレスです。この文字列は,GET_INFO (COMMAND_LINE, "INIT_FILE") 組込みプロシージャから戻される文字列です。
XTPU$_KANJI_DICFILE /KANJI_DICTIONARY 修飾子に指定されている文字列を渡します。バッファ長フィールドはこの文字列の長さを指定し,バッファ・アドレス・フィールドはアドレスを指定します。これは,GET_INFO (COMMAND_LINE, "KANJI_DICTIONARY_FILE") 組込みプロシージャから戻される文字列です。
XTPU$_START_LINE その編集セッションの開始行番号を渡します。バッファ・アドレス・フィールドは /START_POSITION 修飾子で指定した2つの整数値の最初の値です。この値は GET_INFO (COMMAND_LINE,"LINE") 組込みプロシージャから戻される値です。通常,初期化プロシージャがこの情報を用いて,編集するバッファの先頭位置を設定します。バッファの先頭行は line 1 です。
XTPU$_START_CHAR その編集セッションの開始カラム位置を渡します。バッファ・アドレス・フィールドは /START_POSITION 修飾子で指定した2つの整数値の2番目の値です。この値は GET_INFO (COMMAND_LINE,"CHARACTER") 組込みプロシージャから戻される値です。通常,初期化プロシージャがこの情報を用いて,編集するバッファの先頭位置をを設定します。バッファの先頭カラムは character 1 です。
XTPU$_WORKFILE /WORK 修飾子で指定される文字列を渡します。バッファ長フィールドはこの文字列の長さを指定し,バッファ・アドレス・フィールドはアドレスを指定します。これは,GET_INFO (COMMAND_LINE, "WORK_FILE") 組込みプロシージャから戻される文字列です。
XTPU$_CHAIN バッファ・アドレス・フィールドに次のアイテム・リストのアドレスを指定します。
XTPU$_ENDLIST アイテム・リストの最後を示します。
XTPU$_CTRL_C_ROUTINE Ctrl/C ASTを処理するためのルーチンのバウンド・プロシージャ値を渡します。DEC XTPU は Ctrl/C AST が発生すると,そのルーチンを呼び出します。そのルーチンが FALSE 値を返すと,DEC XTPU は Ctrl/C が処理されたものと仮定します。TRUE 値が返されると, DEC XTPU は現在実行しているDEC XTPU プロシージャの実行を強制終了させます。バッファ・アドレス・フィールドは,2つのロングワード・ベクタのアドレスを指定しています。最初のロングワードはルーチンのアドレスであり,2番目のロングワードはそのルーチンを呼ぶ前に R1 にDEC XTPU がロードする環境値です。
XTPU$_DEBUGFILE /DEBUG 修飾子で指定された文字列を渡します。バッファ長フィールドは文字列の長さであり,バッファ・アドレス・フィールドは文字列のアドレスです。

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

表 6-3 XTPU$OPTIONS アイテム・コードによって与えられるビットと対応するマスク
マスク フラグ 機能
XTPU$M_RECOVER 1 XTPU$V_RECOVER 2 回復操作を実行します。
XTPU$M_JOURNAL XTPU$V_JOURNAL 編集セッションをジャーナルします。
XTPU$M_READ XTPU$V_READ メイン・バッファに対しては READ_ONLY 編集セッションとします。
XTPU$M_SECTION XTPU$V_SECTION 起動時にバイナリ初期化ファイル( DEC XTPU セクション・ファイル)にマッピングします。
XTPU$M_CREATE XTPU$V_CREATE 指定した入力ファイルが存在しない場合,入力ファイルを作成します。
XTPU$M_OUTPUT XTPU$V_OUTPUT セッションを終了するときに,変更された入力ファイルを書き出します。
XTPU$M_COMMAND XTPU$V_COMMAND 起動時にコマンド・ファイルを実行します。
XTPU$M_DISPLAY XTPU$V_DISPLAY スクリーンを使用する編集と表示のために,ターミナルを使用します。
XTPU$M_INIT XTPU$V_INIT イニシャライゼーション・ファイルがあります。
XTPU$M_COMMAND
_DFLTED
XTPU$V_COMMAND
_DFLTED
コマンド・ラインのユーザが指定した省略値の名前があるかどうかを指示します。これが TRUE である場合には,ユーザがコマンド・ファイルを指定しなかったことを意味します。このビットが FALSE にセットされていて,かつファイルが指定されていなかったら,XTPU$INITIALIZE は失敗します。
XTPU$M_WRITE XTPU$V_WRITE /WRITE がコマンド・ラインで指定されたかどうかを示します。
XTPU$M_MODIFY XTPU$V_MODIFY /MODIFY がコマンド・ラインで指定されたかどうかを示します。
XTPU$M_NOMODIFY XTPU$V_NOMODIFY /NOMODIFY がコマンド・ラインで指定されたかどうかを示します。
XTPU$M_NOKANJI_DIC XTPU$V_NOKANJI_DIC /NOKANJI_DICTIONARY がコマンド・ラインで指定されたかどうかを示します。
XTPU$M_SEC_LNM_MODE XTPU$V_SEC_LNM_MODE イメージが特権付きでインストールされ,このビットがセットされていると,セクション・ファイルを開けるときに信用のある論理名のみが使用されます。

1XTPU$M...マスクを示します。
2XTPU$V...ビット・アイテムを示します。

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

user_arg

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


ユーザ引数。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 初期化を実行しているときに発生した他のすべてのエラーを示す汎用コードです。


目次 索引

© 2012 Hewlett-Packard Development Company, L.P.