JPH037986B2 - - Google Patents

Description

【発明の詳細な説明】 発明の背景 本発明は計算機システムのオン・ライン・ドキ
ユメンテーシヨン施設に関する。オン・ライン・
ドキユメンテーシヨン施設はドキユメンテーシヨ
ン施設はドキユメンテーシヨン・コマンド、即ち
“help”コマンドに応じて種々のシステム情報を
ユーザに与える。例えばユーザがHELP TERM
＝BILLING IDENTIFIERの如きドキユメンテ
ーシヨン・コマンドを発すると、システムは
“billing identifier”なる用語がシステム中にお
いてどのような意味に使用されているか いうド
キユメンテーシヨンを端末に位置するユーザに提
供する。あるいはユーザがHELP COMMAND
＝CALLなるドキユメンテーシヨン・コマンドを
発すると、システムは“call”コマンドをどのよ
うに使用すべきかに関するドキユメンテーシヨン
を提供する。他の例としてHELP ERROR＝Ｅ
NOT FOUNDなるドキユメンテーシヨン・コ
マンドがあげられるが、これに対してシステムは
ニモニツクがＥ NOT FOUNDであるエラーに
関するドキユメンテーシヨンを提供する。

発明の概要 過去においてはこの型のドキユメンテーシヨン
はシステム内で完全に定義されている。（換言す
るとシステム設計者により定義されていたと言う
ことが出来る。）しかし本発明に従い、オン・ラ
イン・ドキユメンテーシヨンを提供する計算機シ
ステムのユーザには特定のドキユメンテーシヨ
ン・コマンドに対しユーザに特有なドキユメンテ
ーシヨンを定義する能力が付与される。これはそ
の特定のドキユメンテーシヨン・コマンドに対す
る“システム・ドキユメンテーシヨン”（本来シ
ステムによつて提供されているドキユメンテーシ
ヨン）に変更を加えることにより実現される。
（ここで“ユーザ”なる用語は単一の個人だけで
なく、ある特定の課金番号の下でシステムにアク
セスする個人の集合をも包含するものとする。） もちろんシステム・ドキユメンテーシヨンはそ
の本来の状態に保つておき、それによつて他のユ
ーザはその本来のドキユメンテーシヨンでも該他
のユーザによつて変更されたドキユメンテーシヨ
ンでも入手出来ることが必要である。好ましき実
施例にあつてはこれは１つまたはそれ以上のシス
テム・ドキユメンテーシヨン・フアイルと、ユー
ザに特有のドキユメンテーシヨン機能を使用した
いと望んでいる各ユーザに対し１つまたはそれ以
上のユーザ・ドキユメンテーシヨン・フアイルを
設けることにより実現される。詳細に述べると、
システム・フアイルはシステム・ドキユメンテー
シヨンを含んでおり、ユーザ・フアイルはユーザ
により提供されたドキユメンテーシヨン・テキス
トと、これらテキストをどのように使用すればシ
ステム・ドキユメンテーシヨンを変更することが
出来るかを示すインストラクシヨンより成つてい
る。換言するとユーザフアイルは１つまたはそれ
以上のドキユメンテーシヨン・コマンドと関連す
るユーザに特有のドキユメンテーシヨンとシステ
ム・ドキユメンテーシヨンの相異を示す情報を含
んでいる。ユーザにより特定のドキユメンテーシ
ヨン・コマンドが発生されると、システムはシス
テム・ドキユメンテーシヨン・フアイルおよび必
要ならユーザ・ドキユメンテーシヨン・フアイル
にアクセスし、ユーザに特有な適当なドキユメン
テーシヨンを提供する。

実施例の説明 表はドキユメンテーシヨン・コマンド
HELPCMMAND＝CALLに応動して第１図の計
算機システムに返送されるシステム・ドキユメン
テーシヨンを示す。

表 ＊＊CALL＊＊ ＊USAGE＊ PACKAGE−SPHP call（nsa＝）／nsa／ （mode＝／mode／） ＊EXPLANATION＊ “callコマンド”は名前を指定されたプログラ
ムを実行させる。

＊ARGUMENTS＊ NSA： 所定のNSAにインストールされたプログラム
が実行される。

MODE： 端末モードはプログラムの走行前に指示された
値に変更される。モードはコモン、トヤランスペ
アレントまたはクラス特有モードのいずれかであ
る。

本発明に従い、システムのユーザにはシステ
ム・ドキユメンテーシヨンに対する変更点を明示
することによりドキユメンテーシヨン・コマンド
に対しユーザに特有のドキユメンテーシヨンを定
義する能力が付与される。ここでシステム・ドキ
ユメンテーシヨンとは対象となつているドキユメ
ンテーシヨン・コマンドに応動して通常システム
が提供するドキユメンテーシヨンのことである。
例えば表は表に示すシステム・ドキユメンテ
ーシヨンをユーザが変更してユーザに特有の
“callコマンド”に対するドキユメンテーシヨン
にしたものを示す。

表 ＊＊CALL＊＊ ＊USAGE＊ call＜Network Standard Address＞（mode＝
＜common or class−specific＞） ＊EXPLANATION＊ プログラムは10桁のネツトワーク標準アドレス
（NSA）により命名される。callコマンドは名前
を指定されたプログラムを実行する。

＊ARGUMENTS＊ NSA 所定のNSAにインストールされたプログラム
が実行される。

MODE： 端末モードはプログラムの走行前に指示された
値に変更される。モードはコモン、トランスペア
レントまたはクラス特有モードのいずれかであ
る。トランスペアレント・モードは現在サポート
されておらず、使用してはならない。

＊EXAMPLE＊ call0451271234 mode＝class−specific “USAGE”セクシヨンが置き換えられ、
“EXPLANATION”セクシヨンの初めに１つの
文が追加されていること、“ARGUMENT”セ
クシヨンの終りに１つの文が追加されているこ
と、新しい“EXAMPLE”セクシヨンが追加さ
れていることに注意されたい。

第１図は本発明が使用されるシステムを示して
いる。該システムは複数の顧客に統合データ処
理／通信サービスを提供するものであり、サービ
ス提供者の建物の中に位置する複数個のノード１
０を含んでいる。各ノードの中心部には１つまた
はそれ以上のデイジタル計算機が以下で述べる如
く設けられている。複数個のデータ端末１０ａお
よびホスト計算機（即ちホスト）１０６が適当な
データ・ラインを介してノード１０に接続されて
いる。殆んどの端末およびホストは顧客のもので
あり、夫々の建物の中に位置している。しかしあ
る端末および計算機はサービス提供者に属し、例
えばシステム・マネージメントに使用される。ノ
ード１０はパケツト交換トランスポート・ネツト
ワーク１５を介して互いに通信する。ノードは
夫々のリンク１１（これはCCITT標準X.25に準
拠したプロトコルを使用する56kB／Ｓのデータ
を伝送する）を介してネツトワークに接続されて
いる。ノードの内のあるものは特定の機能、例え
ば請求書発行、サービス準備、保守等を実行する
ために使用され得る。

通信により顧客は多数のサービスの提供をうけ
る。その中にはノード内に蓄積された顧客および
サービス提供者により提供されたアプリケーシヨ
ン・プログラムの時分割実行；ノード内に保持さ
れているデータ・ベースへの顧客データの蓄積；
編集、コマンド解釈等のサービスを提供する顕客
のプログラムによつて呼び出し可能なソフトウエ
アの“ビルデイング・ブロツク”のサポート；あ
るノードで実行中のプロセスが他のノードで実行
中のプロセスと相互に通信することによつて実現
される分散処理能力；および蓄積−送出メツセー
ジ・サービス等が含まれる。

第２図は１つのノード１０のブロツク図であ
る。このノードは２つのノード・プロセツサ２０
と１つのデータ・ベース・プロセツサ２６を含ん
でいる。これらプロセツサの各々はDECによつ
て供給されているVMSオペレーテイング・シス
テムの下で動作するDEC社のVAX11／780計算
機であるものとしている。該ノードは更にデー
タ・ベース・プロセツサまたはノード・プロセツ
サの一方の代りをし得る予備のVAX11／780プロ
セツサ２８を含んでいる。他のノード１０（第１
図）は予想される処理要求に応じて２台以下また
は２台以上のノード・プロセツサを有することが
可能である。プロセツサ間の通信はバス２５を介
して実行される。このバス２５はDECによつて
提供されるPCL（並列通信リンク）バスである。

大容量記憶ユニツト（例えばデイスク）２１は
各ノード・プロセツサと関連しており、大容量記
憶ユニツト２７はデータ・ベース・プロセツサ２
６と関連している。大容量記憶ユニツト２７はス
ペア・プロセツサ２８とデユアル・ポート構成さ
れており、従つてスペア・プロセツサ２８もアク
セス可能である。４つのプロセツサの各々には汎
用の入出力（Ｉ／Ｏ）（例えばCRT）端末デバイ
ス２９が関連して存在する。

また各ノード・プロセツサには一方でノード・
プロセツサと、他方で関連する端末１０ａおよび
ホスト１０ｂとの間のインタフエースを提供する
少なくとも１つのフロント・エンド・プロセツサ
２２が関連している。フロント・エンド・プロセ
ツサ２２は図示の実施例ではIBMの提供する
RPSオペレーテイング・システムの下で動作す
るIBMシリーズ／１計算機である。各フロン
ト・エンド・プロセツサは夫々のノード・プロセ
ツサとX.25プロトコルを用いて通信を行なう。
DECによつて供給されているマイクロプロセツ
サ２３を制御するDEC提供のフアームウエアは
プロトコルのレベル２（“リンク”レベル）の
DTEの役割を果す。各ノード・プロセツサと関
連する他のマイクロプロセツサ２４はリンク１１
を介してのX.25通信に関し同様な機能を果す。

ノード・プロセツサ２０の機能は顧客およびサ
ービス提供者のためにプログラムを実行すること
である。このため、各プロセツサと関連した大容
量記憶ユニツト２１は主として現在そのプロセツ
サで進行中の処理をサポートするのに使用され
る。顧客およびサービス提供者に夫々属するすべ
てのデータ、プログラムおよび他のフアイルは大
容量記憶デバイス２７内に含まれているデータ・
ベース中に記憶されている。大容量記憶デバイス
２７の機能はデータ・ベースを管理し、該デー
タ・ベースにアクセスするノード・プロセツサを
提供することにある。

メツセージ・アプリケーシヨン・パツケージ
（MAP）と呼ばれるサービス提供者により供給さ
れる典型的なアプリケーシヨン・プログラム・パ
ツケージの構造が第３図に示されている。このプ
ログラム・パツケージはユーザにテキスト編集、
メツセージの生成、送出機能および種々のデー
タ・ベース・サービス等のサービスを提供する。

MAPはメイン・プログラムからサブルーチン
として呼び出される多数のユーテイリテイとリン
クされているメイン・プログラム３１より成る。
これらユーテイリテイはテキスト編集機能を提供
するエデイタ３２；ユーザの端末と関連する種々
のパラメータをユーザが取り出したり、設定した
りすることを許容するセツト／ゲツト・ステーシ
ヨン・パラメータ・ユーテイリテイ３３；ユーザ
からコマンド・ラインを受け入れて、コマンドの
動詞（例えば“call”または“help”）を識別し、
該動詞を内部形態に変換し、コマンドが転送され
るユーテイリテイに適した形に変数をまとめる作
用をするコマンド・パーサ３４；ユーザに種々の
選択メニユーを提供し、ユーザの選択に応じて更
なるメニユーを提供したり、ユーザのために何ら
かの動作を実行するメニユー施設３５；および本
発明の原理を具現するオン・ライン・ドキユメン
テーシヨン施設３６等を含んでいる。

ユーザに提供されている（但し図には示してな
い）他のサービス提供者が供給しているプログラ
ム・パツケージとしてユーザにプログラムおよび
ステーシヨンをエネイブルおよびデイスエイブす
るような機能を実行するメカニズムを提供する標
準顧客制御パツケージ（SCCP）；およびゲツ
ト／セツト・ステーシヨン・パラメータ・ユーテ
イリテイ３３と類似の機能を提供する標準パラメ
ータ取扱いパツケージ（SPHP）が含まれてい
る。これらプログラム・パツケージの各々はオ
ン・ライン・ドキユメンテーシヨン機能３６を含
むユーテイリテイの組とリンクされている。

データ・ベース内の記憶エリアは２つの型、即
ちシステム機憶エリアとユーザ記憶エリアより成
る。第４図に示すように、システム記憶エリア４
０は多数のシステム・ドキユメンテーシヨン・フ
アイル４００を含んでいる。５つのフアイルが図
には明示されている。これらはコマンド・ドキユ
メンテーシヨン・フアイル４０１，４０２および
４０３、語彙フアイル４０４およびエラー・ドキ
ユメンテーシヨン・フアイル４０５である。フア
イル４０１，４０２および４０３はMAP，
SCCPおよびSPHPにより夫々認識された特定の
コマンドと関連するシステム・ドキユメンテーシ
ヨンを含むレコードより成つている。語フアイル
４０４はシステムで使用されている特定の用語の
定義を含むレコードより成る。エラー・フアイル
４０５はシステムにより検出され、プログラム・
パツケージの実行期間中にユーザに返送される特
定のエラーまたは警報状態に関する情報を含むレ
コードより成る。

各ユーザに対するデータ・ベース内に異なる記
憶エリアが形成されており、第４図は１人の特定
のユーザと関連するユーザ記憶エリアを示してい
る。本発明に従い、ユーザ記憶エリア４５はユー
ザ・ドキユメンテーシヨン・フアイル４５０を含
んでおり、そのレコードはユーザにより供給され
たドキユメンテーシヨン・テキストと、１つまた
はそれ以上のドキユメンテーシヨン・コマンドに
対しシステム・ドキユメンテーシヨンを修正する
のにこれらテキストをどのように用いたらよいか
ということに関するインストラクシヨンを含んで
いる。換言すると、ユーザ・ドキユメンテーシヨ
ン・フアイルは１つまたはそれ以上のドキユメン
テーシヨン・コマンドと関連するユーザ特有のド
キユメンテーシヨンとシステム・ドキユメンテー
シヨンがどのように異なるかを示す情報を含んで
いる。ユーザ記憶エリア内のこれらフアイルは例
えばエデイタ３２を用いて形成される。

この例ではユーザはａ）MAPで使用されるコ
マンドおよびｂ）エラーに対するドキユメンテー
シヨン情報を供給するものとしている。このため
２つのユーザ・フアイル、即ちMAPコマンド・
ドキユメンテーシヨン・フアイル４５１とエラ
ー・ドキユメンテーシヨン・フアイル４５２がユ
ーザ記憶エリア中に形成されている。図ではこれ
らフアイルの名称は相応するシステム・ドキユメ
ンテーシヨン・フアイル、即ちフアイル４０１お
よび４０５と同一である。従つてドキユメンテー
シヨン機能施設３６が以下で述べるようにオープ
ンすべき適当なシステム・ドキユメンテーシヨ
ン・フアイルの名称を獲得すると、該施設３６は
またオープンすべき適当なユーザ・ドキユメンテ
ーシヨン・フアイル（もし存在するならば）の名
称も所有することになる。

各プログラム・パツケージは“環境”と呼ばれ
るデータ構造を夫々含んでいる。各パツケージに
対する環境はその特定のプログラム・パツケージ
と関連するシステム・ドキユメンテーシヨン・フ
アイルに対するフアイル名を含んでいる。詳細に
述べると（第３図に示す）MAPと関連する環境
３１０は例えばError.doc，Term.docおよび
MAP.doc（これらは夫々フアイル４０５，４０
４、および４０１のフアイル名である）等のエラ
ー、語彙およびコマンド・フアイル名を含んでい
る。ドキユメンテーシヨン施設３６が例えば
MAPと関連するコマンド・ドキユメンテーシヨ
ンを検索する必要が生じた場合、該施設３６は環
境３１０を調べて、アクセスすべきシステム・ド
キユメンテーシヨン・フアイルの名前を確認す
る。SCCPおよびSPHPと関連する環境はシステ
ム全体を通して同じエラー・ニモニツクの組およ
び同じ用語が使用されているならばMAP環境と
同じエラーおよび語彙フアイル名を含んでいる。
しかし各プログラム・パツケージで使用されるコ
マンドは変化する。従つてSCCPおよびSPHP環
境は夫々のコマンド・ドキユメンテーシヨン・フ
アイル名、即ちSCCP.docおよびSPHP.doc（これ
らはフアイル４０２および４０３の名称である）
を含んでいる。

システムおよびユーザ・ドキユメンテーシヨ
ン・フアイル内の各レコードはその値がコマン
ド、用語またはエラー・ニモニツクである“キ
ー”によつて検索される。従つて、例えば特定の
コマンドに対するドキユメンテーシヨンを含むシ
ステムまたはユーザ・フアイル内のレコードはデ
ータ・ベース読み出し操作においてそのコマンド
をインデツクス・キーとして指定することにより
検索される。

システム・ドキユメンテーシヨン・レコード、
即ちシステム・ドキユメンテーシヨン・フアイル
４００の内の１つのレコードに対するフオーマツ
トが第５図に示されている。。レコードはフイー
ルド・デリミタ（この場合には文字＃＃）で始ま
り、それに続いてオプシヨナルなメイン・レコー
ド・フラグとトレーリング・デリミタ、少なくと
も第１のセクシヨン・ヘツデイングならびにセク
シヨン・テキストより成る。この場合各々はデリ
ミタで分離されている。

メイン・レコード・フラグの値は文字“Ｃ”で
あるとき、これは“継続”を表わし、対象となつ
ているインデツクス・キーと関連するドキユメン
テーシヨンが長すぎて１レコード内に入りきらな
いため、１つまたはそれ以上の付加的なレコード
に続いて入つていることを表わす。（このような
付加的なレコードは第１のレコードがそれによつ
てインデツクス指定されたキーに数字を付加する
ことにより形成されたキー、例えばcall１，call
２等によつてインデツクス指定される。） あるいはメイン・レコード・フラグは“メニユ
ー”を表わす文字“Ｍ”であることがある。この
フラグは対象となつているレコードが実際のドキ
ユメンテーシヨンでなくメニユーの名前を含んで
おり、このレコードがドキユメンテーシヨン施設
３６に加えられると該施設３６はメニユー施設３
５を呼び出し、該メニユーをユーザに表示すべき
メニユーであると指定することになる。この型の
レコードは例えばシステムが“list file”，“list
commands”，“list directiories”等一連のコマ
ンド動詞に対するドキユメンテーシヨンを提供す
る場合に使用され、ユーザが不完全なドキユメン
テーシヨン・コマンドHELP LISTを入力するこ
とを予期している。この場合、コマンド・ドキユ
メンテーシヨン・フアイルは“Ｍ”をそのメイ
ン・レコード・フラグとして含み、ユーザにどの
型の“list”コマンドのドキユメンテーシヨンを
知りたいのか尋ねるメニユーの名称を含むキー
“list”によつてインデツクス指定されるレコード
を含んでいる。

第５図に示すシステム・ドキユメンテーシヨ
ン・レコード中のセクシヨン・ヘツデイングは表
中のヘツデイング（見出し）“USAGE”，
“EXPLANATION”等の文字例である。セクシ
ヨン・テキストは各セクシヨン・ヘツデイングに
続くテキストより成る文字例である。

（第５図に示すフオーマツトに従わないシステ
ム・ドキユメンテーシヨン・フアイルで使用され
る他の種類のレコードは初期デリミタを有さない
インデツクス・キーのみより成る。ドキユメンテ
ーシヨン施設３６はこのようなレコードと出会う
と、そのキーによつてインデツクス指定されるレ
コードに直ちにアクセスすることにより応動す
る。このメカニズムによりシステムがある種の予
想されるユーザ・エラーを自動的に訂正すること
が可能となる。例えば、“run program”という
エントリより成るレコードは正当なコマンドでは
ないキー“run”によつてインデツクス指定出来
る。従つて“run program”コマンドに対する
ドキユメンテーシヨンを望んでいるユーザがドキ
ユメンテーシヨン・コマンドHELP
COMMAND＝RUNを誤つて発生すると、ドキ
ユメンテーシヨン施設はまずキー“run”により
インデツクス指定されたレコードを検索する。そ
のレコードがエントリ“run program”を含む
ことが分ると、“run program”なるインデツク
スを有するレコードを検索し、これによつてユー
ザのエラーが自動的に訂正されることになる。） ユーザ・ドキユメンテーシヨン・レコード、即
ちユーザ・ドキユメンテーシヨン・フアイル４５
０の内の１つのレコードのフオーマツトが第６図
に示されている。これは初期デリミタ、オプシヨ
ナルな１つまたは２つのメイン・レコード・フラ
グ、少なくとも第１のセクシヨン・ヘツデングと
それに続く各セクシヨン・ヘツデイング、オプシ
ヨナルなセクシヨン・フラグおよびセクシヨン・
テキスト（これらはすべてデリミタで分離されて
いる。）より成る。

メイン・レコード・フラグ・フイールドは前と
同様“継続”を意味する文字“Ｃ”であることが
ある。該フイールドは“Ｒ”または“Ｎ”を含む
場合がある。“Ｒ”は“置き換え”を表わし、
“Ｎ”は“新規”を表わす。これらフラグの値は
いずれも同じ機等を有しており、このユーザ・ド
キユメンテーシヨン・レコード全体が相応するシ
ステム・ドキユメンテーシヨン・レコード全体の
代りとして使用されるべきことを指示するインス
トラクシヨンである。

ユーザ・ドキユメンテーシヨン・レコード中の
セクシヨン・ヘツデイングおよびセクシヨン・テ
キストはシステム・ドキユメンテーシヨン・レコ
ード中のセクシヨン・ヘツデイングおよびセクシ
ヨン・テキストと類似のものであり、これ以上議
論しない。

セクシヨン・フラグは４つの値“Ａ”，“Ｐ”，
“Ｒ”または“Ｎ”の内のいずれか１つをとり得
る。“Ａ”および“Ｂ”は“after”および
“before”を表わし、ユーザ・レコード中のセク
シヨン・ヘツデイングが、相応するシステム・ド
キユメンテーシヨン・レコードの相応するヘツデ
イングを有すセクシヨンのセクシヨン・テキスト
の後または前に夫々付加されるべきことを指示す
るインストラクシヨンである“Ｒ”および“Ｎ”
は夫々前述の如く“置き換え”および“新規”を
表わしている。これらはいずれも対象となつてい
るセクシヨン・テキストで相応するシステム・ド
キユメンテーシヨン・レコードの相応するヘツデ
イングを有するセクシヨンのセクシヨン・テキス
トを置き換えることを指示する。セクシヨン・フ
ラグが存在しない場合には該セクシヨンはセクシ
ヨン・フラグの値が“Ａ”であるものとして取扱
われる。そしてユーザ・ドキユメンテーシヨン・
レコードのセクシヨン・ヘツデイングがいずれの
システム・ドキユメンテーシヨン・レコードのセ
クシヨン・ヘツデイングとも同じでない場合には
セクシヨン・フラグの値は以下で分るように無効
となる。

第７〜９図のフローチヤートに進む前に、ドキ
ユメンテーシヨン・コマンドのフオーマツトにつ
いて更に詳細に議論することが適当であると考え
られる。先に指摘した如く、ユーザはHELP
COMMAND＝CALL，HELP TERM＝
BILLING IDENTIFIERおよびHELP ERROR
＝Ｅ NOT FDUND等のコマンドを発すること
が出来るが、これに応動してシステムは対象とな
つているコマンド；用語またはエラーに対して得
られる（もしユーザによつて修正されているなら
ば修正された）ドキユメンテーシヨンをすべて提
供する。オプシヨンとしてユーザはコマンド・ド
キユメンテーシヨンの要求に際し“COMMAN
＝”を除去して例えばHELP CALL SECTION
＝USAGE SECTION＝EXAMPLEとすること
が出来る。更に他のオプシヨンとしてユーザはそ
のフアイル名を知つている場合、ユーザが現在使
用しているプログラム・パツケージ以外のプログ
ラム・パツケージと関連するコマンド・ドキユメ
ンテーシヨン・フアイルからドキユメンテーシヨ
ンを取り出すことが出来る。例えばMAPのユー
ザがHELP CALL FILE＝SCCP.doc
SECTION＝ARGUMENTSというコマンドを発
すると、ユーザはSCCPで使用されている“call”
コマンドの変数に関するドキユメンテーシヨンを
得ることが出来る。

第７〜９図はオン・ライン・ドキユメンテーシ
ヨン施設３６のフローチヤートであつて、これは
前述の如くサブルーチンと呼ばれるが、以下では
“ルーチン”と呼ぶことにする。

第７図は本ルーチンのレコード検索部を詳細に
示している。該ルーチンはステツプ７０１から始
まるが、該ステツプにおいてはコマンド・パーサ
３４によつて加えられた変数を調べどのドキユメ
ンテーシヨンが要求されているかを決定する。ス
テツプ７０３においてユーザが不適当なドキユメ
ンテーシヨン・コマンド、例えばHELP
ERRORを発していたことが分るとドキユメンテ
ーシヨン施設はステツプ７０４においてメニユー
施設３５を呼び出す。メニユー施設はユーザから
の応答を用いてどのドキユメンテーシヨンをユー
ザが望んでいるかを決定する。ユーザの望んでい
るドキユメンテーシヨンが決定されると、メニユ
ー施設はユーザに代つてドキユメンテーシヨン要
求を形成し、該情報を再びドキユメンテーシヨン
施設に加える。

説明の便宜上ユーザはMAPを実行しており、
“call”コマンドに対するドキユメンテーシヨン
を要求するドキユメンテーシヨン・コマンドを発
したものと仮定する。７０６に示すように、この
ユーザによつて要求された最後のドキユメンテー
シヨンが、現在ドキユメンテーシヨンが要求され
ているコマンド、即ち“call”と同じコマンドに
対するものであつたかどうかが決定される。（こ
のドキユメンテーシヨンは以下で議論するように
出力レコード・リスト１０５０中で尚得ることが
出来る。）同じである場合には、制御はルーチン
のマーキング／プリンテイング部（第９図）に直
接渡される。

同じでない場合には、ドキユメンテーシヨン施
設はステツプ７０９において適切なシステムの名
称、従つてユーザ・コマンド・ドキユメンテーシ
ヨン・フアイル（この例ではMAP.doc）を決定
する。７１１に示すように次にルーチンはオープ
ン・ドキユメンテーシヨン・フアイルの名称を保
持している表を調べ、MAP.docと名付けられた
フアイルが既にオープンされているかどうかを決
定する。オープンされていない場合には、７１４
に示すようにシステムおよびユーザ記憶エリアの
両方においてMAP.docなる名称のフアイルのオ
ープンが行なわれる。

ここでシステム・フアイルは常に存在するから
現在対象としている名称のシステム・フアイルは
オーブンしているものと仮定することが出来る。
しかし要求された種類のドキユメンテーシヨンに
対するユーザ・フアイルは存在しないこともあ
る。従つて７１７でMAP.docと名付けられたオ
ープン・ユーザ・フアイルが実際に存在するかど
うかが決定される。もし存在しない場合にはルー
チンは直接ステツプ７３２に進み、そこで対象と
なつているコマンドに対するドキユメンテーシヨ
ンを含むレコードが検索される。

他方MAP.docと名付けられたユーザ・フアイ
ルがオープンされていると、ステツプ７２１にお
いてそこからコマンド“call”のドキユメントを
含むユーザ・レコードが検索される。ステツプ７
２４においてそのようなレコードが無いと判定さ
れると（即ちユーザが“call”コマンドに対し何
らのドキユメンテーシヨンも供給していないと判
定されると）、ルーチンは再びステツプ７３２に
進む。しかしユーザ・レコードが存在すると、そ
のメイン・レコード・フラグ・フイールド（第６
図）が“Ｒ”または“Ｎ”であるかどうかがチエ
ツクされる。“Ｒ”または“Ｎ”の場合、“call”
コマンドに対するユーザ・ドキユメンテーシヨン
がシステム・ドキユメンテーシヨンと入れ替わ
り、それによつてこの場合にはステツプ７３２は
スキツプされる。何故ならば“call”コマンドに
対するドキユメンテーシヨンを含むシステム・レ
コードは必要ないからである。他方、ユーザ・レ
コードが置き換えレコードであいと、システム・
レコードは検索されねばならず、前と同様ステツ
プ７３２が実行される。

ここで制御は７３４に示すようにドキユメンテ
ーシヨン施設のレコード処理部に渡される。第８
図に示すルーチンのこの部分はステツプ８０１か
ら始まり、そこで先に検索されたシステム・ドキ
ユメンテーシヨン・レコード（もし存在するな
ら）が検査され分解される。この操作には第１０
図に示すいわゆるシステム・レコード・リスト１
０１０のエントリを形成することを含んでいる。
システム・レコード・リストは予め規定されたデ
ータ構造アレイ（システム・ブロツク１０２０で
あり、その各々はシステム・レコードの夫々のセ
クシヨンに関する以下で述べる情報を保持する記
憶ロケーシヨンを含んでいる。その情報とはロケ
ーシヨン１０２１に記憶されているセクシヨン・
ヘツデイングと、ロケーシヨン１０２２に記憶さ
れているセクシヨン・テキストのロケーシヨンに
対するポインタと、ロケーシヨン１０２３に記憶
されているテキスト中の文字数である。

再び第８図を参照すると、ルーチンはステツプ
８０３にすすみ、そこで先に検索されたユーザ・
ドキユメンテーシヨン・レコード（もし存在する
なら）が同様に調べられ、第１０図に示すように
ユーザ・レコーβ・リスト１０３０に分解され
る。ユーザ・レコード・リストはユーザ・ブロツ
ク１０４０より成る。各ユーザ・ブロツクはセク
シヨン・ヘツデイング、テキスト・ポインタおよ
び文字数（これらは夫々ロケーシヨン１０４１，
１０４２および１０４３に記憶されている）に対
する記憶ロケーシヨンを有していることに加え
て、前述のセクシヨン・フラグの値（Ａ，Ｂ，Ｒ
又はＮ）に対する記憶ロケーシヨンを有してい
る。

システムおよびユーザ・レコード・リストは以
下で簡単に述べるようにいわゆる出力レコード・
リスト１０５０を生成するのに使用される。この
リストは出力ブロツクのアレイ１０６０より成
り、その各々は以下の情報に対する記憶ロケーシ
ヨンを有している。その情報とはセクシヨン・ヘ
ツデイング、第１のテキストに対するポインタ、
第１のテキストに対する文字数、第２のテキスト
に対するポインタ、第２のテキストおよびプリン
ト・フラグに対する文字数であり、これらは１０
６１〜１０６６に夫々示されている。

詳細に述べると、本ルーチンは第８図の８０８
に示すようにループを実行するとによつて出力レ
コード・リスト１０５０をうめる。ループを通る
毎に、本ルーチンは相続くシステム・ブロツク１
０２０を調べ、ステツプ８１１においてユーザ・
ブロツク１０４０中に整合したセクシヨン・ヘツ
デイングが存在するかどうか決定する。もし存在
しない場合には、本ルーチンはステツプ８１４に
進み、そこでセクシヨン・ヘツデイングはシステ
ム・ブロツク中のロケーシヨン１０２１から出力
ブロツク１０６０の内の次に入手可能なブロツク
中のロケーシヨン１０６１にコピーされる。更
に、テキスト・ポインタおよび文字数はシステ
ム・ブロツクのロケーシヨン１０２２および１０
２３から出力ブロツクのロケーシヨン１０６２お
よび１０６３中に第１のテキスト・ポインタおよ
び第１の文字数として夫々コピーされる。ロケー
シヨン１０６４に記憶された出力ブロツク中の第
２のテキスト・ポインタはクリアされて空ストリ
ングとなる。次に本ルーチンは次のシステム・ブ
ロツクを処理するためにループする。

他方、現在考慮の対象となつているシステム・
ブロツク中のセクシヨン・ヘツデイングと整合す
るセクシヨン・ヘツデイングがユーザ・ブロツク
１０４０の１つの中に存在すると、本ルーチンは
ステツプ８１６において次に入手可能な出力ブロ
ツクのロケーシヨン１０６１中に該ヘツデイング
をコピーし、次いでステツプ８１９においてユー
ザ・ブロツクのロケーシヨン１０４５に記憶され
たセクシヨン・フラグの値に従つて出力ブロツク
中のテキスト・ポインタ（および相応する文字
数）をセツトする。もしセクシヨン・フラグの値
が“Ａ”（“after”を意味する）であると、出力
ブロツクのロケーシヨン１０６２および１０６４
に記憶された第１および第２のテキスト・ポイン
タはシステムおよびユーザ・ブロツクのロケーシ
ヨン１０２２および１０４２に記憶されたテキス
ト・ポインタの値が与えられる。文字数に関して
も同様なことが行なわれる。セクシヨン・フラグ
が“Ｂ”（“before”を意味する）であると、出力
ブロツク・テキスト・ポインタおよび文字数は同
じ値が逆の順序で割当てられる。セクシヨン・フ
ラグが“Ｒ”（“replace”を意味する）または
“Ｎ”（“new”を意味する）であると、特定のセ
クシヨンに対するシステム・ドキユメンテーシヨ
ンはユーザ・ドキユメンテーシヨンにより完全に
置き換えられる。この場合、出力ブロツク中の第
１のテキスト・ポインタおよび文字数にはユー
ザ・ブロツク・テキスト・ポインタおよび文字数
の値が与えられ、第２の出力ブロツク・テキス
ト・ポインタは空ストリングとなる。ステツプ８
２１に示されているように、対象となつているユ
ーザ・ブロツクは現在使用中であるといることが
そのセクシヨン・ヘツデイングを空ストリングと
することによりマークされる。

このようにしてすべてのシステム・ブロツク１
０２０が処理されると、ループから出てルーチン
はステツプ８２４に進む。ここで本ルーチンはユ
ーザ・レコード・リスト１０３０を走査して、マ
ークされていないユーザ・ブロツク、即ちそのセ
クシヨン・ヘツデイングが空ストリングでないブ
ロツクをさがす。このようなユーザ・ブロツクか
らの情報は、ステツプ８１４と関連して既に述べ
たように整合したユーザ・ブロツクを有さないシ
ステム・ブロツク中の情報が出力ブロツク中にコ
ピーされるのと同じ仕方で出力ブロツク中にコピ
ーされる。以上のことからセクシヨン・フラグの
値はこの場合には無関係なことを理解されたい。

８２６に示すように、本ルーチンは次にそのセ
クシヨン・マーキング／プリンテイング部（これ
を第９図に示す。）に進む。ステツプ９０１にお
いてドキユメンテーシヨン・コマンドがあるセク
シヨンのみを表示すべきものと判定されると、適
当な出力ブロツク中のプリント・フラグがステツ
プ９０３に示すようにセツトされる。そうでない
場合にはすべての出力ブロツク中のプリント・フ
ラグがステツプ９０４に示すようにセツトされ
る。

これでドキユメンテーシヨンがプリント、即ち
ユーザに表示される準備が出来たことになる。ま
ず最初にレコード検索に使用されたレコード・キ
ーがステツプ９０８において大文字で二重＊印を
付してプリントされる。（例えば表および表
の＊＊CALL＊＊）次に出力リスト１０５０の各
ブロツクが９１１から始まるループで処理され
る。ループ内において、各出力ブロツクはまずス
テツプ９１３においてプリントするべくマークさ
れているかどうかがチエツクされる。マークされ
ていないと、次のブロツクに移る。しかしブロツ
クがプリントするべくマークされていると、ルー
チンはステツプ９１５，９１６および９１９を実
行し、そこでセクシヨン・ヘツデイングは大文字
化されて印字され、出力ブロツク中の指定された
第２のテキスト、次いで第２のテキスト（もし存
在する場合には）が印字される。

すべての出力ブロツクが処理されると、本ルー
チンは呼び出し点に戻る。

本発明の特定の実施例に関して示し説明した
が、これは本発明の原理を例示するにすぎない。
当業者にあつては本発明の精神および範囲を逸脱
することなく多数の装置を考案し得るとは明らか
である。

【図面の簡単な説明】

第１図は本発明が使用されるデータ処理／通信
システムのブロツク図、第２図は第１図のシステ
ム内のマルチ計算機ノードのブロツク図、第３図
は本発明の原理を実現するオン・ライン・ドキユ
メンテーシヨン機能を含む第２図のノード内で実
行されるプログラム・パツケージを示す図、第４
図は第２図のノード内にあるシステムの一部およ
びユーザ・データ・ベース・記憶エリアを示す
図、第５図はシステム記憶エリア内に保持されて
いるシステム・ドキユメンテーシヨン・レコード
のフオーマツトを示す図、第６図はユーザ記憶エ
リア内に保持されているユーザ・ドキユメンテー
シヨン・レコードのフオーマツトを示す図、第７
〜９図はオン・ライン・ドキユメンテーシヨン機
能のフローチヤートを示す図、第１０図は実行期
間中にオン・ライン・ドキユメンテーシヨン機能
につて生成されるシステム・ユーザおよび出力レ
コード・リストを示す図である。

【表】 テーシヨンを該システムの前記他
のユーザに提供する第２の手段

Claims (1)

1. 【特許請求の範囲】 １ 計算機システムにおいて実行するオン・ライ
   ン・ドキユメンテーシヨンプログラムによつて遂
   行される方法であつて、該プログラムが関連する
   オン・ライン・ドキユメンテーシヨンコマンドに
   応動してオン・ライン・ドキユメンテーシヨンを
   表示するように適応される方法において、 システムの複数のユーザの各々から特定のオ
   ン・ライン・ドキユメンテーシヨンコマンドと関
   連するユーザ特有のオン・ライン・ドキユメンテ
   ーシヨンを受信し、そのユーザが特定のオン・ラ
   イン・ドキユメンテーシヨンコマンドを発した時
   に複数のユーザの各々に対しそのユーザから前に
   受信したユーザ特有のオン・ライン・ドキユメン
   テーシヨンを表示するステツプからなることを特
   徴とするオン・ライン・ドキユメンテーシヨンの
   方法。 ２ 特許請求の範囲第１項に記載の方法におい
   て、さらに、他のユーザが特定のドキユメンテー
   シヨンコマンドを発した時にそのシステムの各他
   のユーザに特定のドキユメンテーシヨンコマンド
   と関連する前もつて定義されたシステムドキユメ
   ンテーシヨンを表示する段階を含むことを特徴と
   するオン・ライン・ドキユメンテーシヨンの方
   法。 ３ 特許請求の範囲第２項に記載の方法におい
   て、計算機システムは複数のユーザの各々に対し
   ユーザ特有のドキユメンテーシヨンがいかに表示
   されるかを示す情報であつてユーザがそのために
   システムドキユメンテーシヨンと異なる情報を記
   憶する手段を含み、第１の表示段階がシステムド
   キユメンテーシヨンおよび情報に応動してユーザ
   特有のドキユメンテーシヨンを生成する段階を含
   むことを特徴とするオン・ライン・ドキユメンテ
   ーシヨンの方法。 ４ 特許請求の範囲第３項に記載の方法におい
   て、 該情報は１つもしくはそれ以上のドキユメンテ
   ーシヨンテキストおよびユーザ特有のドキユメン
   テーシヨンを生成するために各ユーザドキユメン
   テーシヨンテキストがシステムドキユメンテーシ
   ヨンといかに結合されるべきかを示すインストラ
   クシヨンを含むことを特徴とするオン・ライン・
   ドキユメンテーシヨンの方法。