JPS5941074A - オン・ライン・ドキュメンテーションの方法 - Google Patents

Abstract

(57)【要約】本公報は電子出願前の出願データであるた
め要約のデータは記録されません。

Description

【発明の詳細な説明】 発明の背景 本発明は計算機システムのオン・ライン・ドキュメンテ
ーション施設に関する。オン・ライン・ドキュメンテー
ション施設はドキュメンテーション施設はドキュメンテ
ーション・コマンド、即ち’　ｈｅｌｐ’コマンドに応
じて種々のシステム情報全ユーザに与える。例えばユー
ザがＨＥＬＰ　ＴＥＲＭ　＝　ＢＩＬＬＩＮＧ　ＩＤＥ
ＮＴＩＦＩＥＲの如きドキュメンテーション・コマンド
ヲ発すると、システムは”　ｂｉｌｌｉｎｇ　１ｄｅｎ
ｔｉｆｉｅｒ”なる用語がシステム中においてどのよう
な意味に使用されているか　いうドキュメンテーション
を端末に位置するユーザに提供する。

あるいはユーザがＨＥＬＰ　ＣＯＭＭＡＮＤ　＝　ＣＡ
ＬＬなるドキュメンテーション・コマンドを発すると、
システムは’　ｃａｌｌ　　“コマンドをどのように使
用すべきかに関するドキュメンテーションを提供する。

他の例としてＨＥＬＰ　ＥＲＲＯＲ＝Ｅ　ＮＯＴ　ＦＯ
ＵＮＤなるドキュメンテーション・コマンドがあげられ
るが、これに対してシステムはニモニックがＥＮＯＴ　
ＦＯＵＮＤであるエラーに関するドキュメンテーション
を提供する。

発明の概要 過去においてはこの型のドキュメンテーションはシステ
ム内で完全に定義でれている。

（換言するとシステム設計者にょシ定義されていたと言
うことが出来る。）し２かし本発明に従い、オン・ライ
ン・ドキュメンテーション全提供する計算機システムの
ユーザには特定のドキュメンテーション・コマンドに対
しユーザに特有なドキュメンテーション全定義する能力
が付与される。これはその特定のドキュメンテーション
・コマンドに対するゝゝシステム・ドキュメンテーショ
ン〃（本来システムによって提供されているドキュメン
テーション）に変更全卵えることによシ笑現される。（
ここで“ユーザ〃なる用語は単一の個人だけでなく、あ
る特定の課金奇岩の下でシステムにアクセスする個人の
集合をも包含するものとする。） もちろんシステム・ドキュメンテーションはその本来の
状態に保っておき、それによって他のユーザはその本来
のドキュメンテーションでも該他のユーザによって変更
されたドキュメンテーションでも人手出来ることが必要
である。好丑しき実施例にあってはこれは１つ址たけそ
れ以上のシステム・ドキュメンテーション・ファイルと
、ユーザに特有のドキュメンテーション機能全使用した
いと望んでいる谷ユーザに対し１つまたはそれ以上のユ
ーザ・ドキュメンテーション・ファイルを設けることに
より実現される。詳細に述べると、システム・ファイル
はシステム・ドキュメンテーションを含んでおり、ユー
ザ・ファイルはユーザにより提供されたドキュメンテー
ション・テキストと、これらテキストをどのように使用
すればシステム・ドキュメンテーションを変更すること
が出来るがを示すインストラクションよシ成っている。

換言するとユーザ・ファイル／ｒＪＯ，１つまたはそれ
以上のドキュメンテーション・コマンドト関連するユー
ザに特有のドキュメンテーションとシステム・ドキュメ
ンテーションの相異を示す情報を含んでいる。ユーザに
よシ特定のドキュメンテーション・コマンドが発生され
ると、システムはシステム・ドキュメンテーション・フ
ァイルおよび必要ならユーザ・ドキュメンテーション・
ファイルにアクセスし、ユーザに特有な適当なドキュメ
ンテーションを提供する。

実施例の説明 辰■はドキュメンテーション・コマンドＨＥＬＰＣＭＭ
ＡＮＤ　＝　ＣＡＬＬに応動して第１図の計算機システ
ムに返送されるシステム・ドキュメンテーションを示す
。

表　　■ 苦ヅＣＡＬＬデデ ”　ＵＳＡＧＥ苦 ＰＡＣＫＡＧＥ　−５ＰＨＰ ｃａｌｌ　　（ｎｓａ　＝　）／　ｎｓａ　／（ｍｏｄ
ｅ　＝／　ｍｏｄｅ　／　） 苦　ＥＸＰＬＡＮＡＴＩＯＮ　　＋ ゝゝｃａｌ　ｌ　　コマンド〃は名前を指定されたプロ
グラムを実行させる。

餐　ＡＲＧｕｙｒｍｒＴｓ　　＋ ＮＳＡ： 所定のＮＳＡにインストールされたプログラムが実行さ
れる。

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

本発明に従い、システムのユーザにはシステム・ドキュ
メンテーションに対する変更点を明示することによシト
キュメンテ−ジョン・コマンドに対しユーザに特有のド
キュメンテーションを定義する能力が付与される。ここ
でシステム・ドキュメンテーションとは対象となってい
るドキュメンテーション・コマンドに応動して通常シス
テムが提供するドキュメンテーションのことである。例
えば表■は表Ｉに示すシステム・ドキュメンテーション
をユーザが変更してユーザに特有の’　ｃａｌｌ：Ｉ？
：／　Ｆ“に対するドキュメンテーションにしたものを
示す。

表　　■ 矢餐　ＣＡＬＬ　　餐蒼 薫ＵＳＡＧＥ矢 ｃａｌｌ＜］’Ｊｅｔｗｏｒｋ　５ｔａｎｄａｒｄ　Ａ
ｄｄｒｅｓｓ　）（ｍｏｄｅ＝（ｃｏｍｍｏｎ　ｏｒ　
ｃｌａｓｓ−ｓｐｅｃｉｆｉｃ　）　）プログラムは１
０桁のネットワーク標準アドレス（ＮＳＡ）によシ命名
される。ｃａｌｌコマンドは名前全指定されたプログラ
ムを実行する。

蒼ＡＲＧ［Ｊ厄ＮＴＳ蕾 ＮＳＡ 所定のＮＳＡにインストールされたプログラムが実行き
れる。

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

薫　ＥＸＡＭＰＬＥ　　蒼 ｃａｌｌ　　０４５１２７１２３４　　ｍｏｄｅ＝ｃｌ
ａｓｓ−ｓｐｅｃｉｆｉｃゝゝＵＳＡＧＥ”セクション
が置き換えられ、’　ＥＸＰＬＡＮＡＴＩＯＮ“セクシ
ョンの初めに１つの文が追加でれていること、’　ＡＲ
ＧＵＭＥＮＴ　’セクションの終シに１つの文が追加さ
れていること、新しい’　ＥＸＡＭＰＬＥ“セクション
が追加式れていることに注意されたい。

第１図は本発明が使用されるシステムを示している。該
システムは複数の顧客に統合データ処理／通信サービス
を提供するものであり、サービス提供者の建物の中に位
置する複数個のノード１０を含んでいる。各ノードの中
心部には１つまたはそれ以上のディジタル計算機が以下
で述べる如く設けられている。

複数個のデータ端末１０ａおよびホスト計算機（即ちホ
スト）１０６が適当なデータ・ラインを介してノード１
０に接続されている。

殆んどの端末およびホストは顧客のものであ気夫々の建
物の中に位置している。しかしある端末および計算機は
サービス提供者に属し、例えばシステム・マネージメン
トに便用される。ノード１０はパケット父換トランスポ
ート・ネットワーク１５を介して互いに通信する。ノー
ドは夫々のリンク１１（これはＣＣＩ　ＴＴ　標準Ｘ、
２５に準拠したプロトコル全便用する５６　ｋＢ／Ｓの
データを伝送する）を介してネットワークに接続されて
いる。ノードの内のあるものは特定の機能、例えば請求
書発行、サービス準備、保守等を実行するために使用さ
れ得る。

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

第２図は１つのノーｐｉｏのフロック図である。このノ
ードは２つのノード・プロセッサ２０と１つのデータ・
ベース・プロセッサ２６を含んでいる。これらプロセッ
サの各々はＤＥＣによって供給されているＶ　Ｍ　Ｓオ
ペレーティング・システムの下で動作するＤＥＣ社の■
△Ｘｌｌ／７８０計算機であるものとしている。該ノー
ドは更にデータ・ベース・プロセッサまたはノード・プ
ロセッサの一方の代りをし得る予備のＶＡＸ　１１／７
８０プロセツサ２８全言んでいる。他のノード１０（第
１図）は予想される処理要求に応じて２台以下または２
台以上のノード・プロセッサを有することが可能である
。プロセッサ間の通信はバス２５を介して実行される。

このバス２５はＤＥＣによって提供されるＰＣＬ（並列
通信リンク）ハスである。

大容量記憶ユニット（例えばディスク）２１は谷ノード
・プロセッサと関連しておシ、大容量１己憶ユニット２
７はデータ・ベース・プロセッサ２６と関連している。

大容量記憶ユニット２７はスペア・プロセッサ２８とデ
ュアル・ポート構成されておシ、従ってスペア・プロセ
ッサ２８もアクセス可能である。４つのプロセッサの各
々には汎用の人出力（工１０）（例えばＣＲＴ）端末デ
バイス２９が関連して存在する。

また谷ノード・プロセッサには一方でノード・プロセッ
サと、他方で関連する端末１０ａおよびホスト１０ｂと
の間のインタフェース全提供する少なくとも１つのフロ
ント・エンド・プロセッサ２２が関連している。フロン
ト・エンド・プロセッサ２２は図示の実施例ではＩＢＭ
の提供するＲＰＳオペレーティング・システムの下で動
作するＩＢＭシリーズ／ｌ計算機である。各フロント・
エンド・プロセッサは夫々のノード・プロセッサとＸ、
２５プロトコルを用いて通信を行なう。ＤＥＣによって
供給されているマイクロプロセッサ２３を制御するＤＥ
Ｃ提供のファームウェアはプロトコルのレベル２（ゝゝ
リンク“レベル）のＤＴＥの役割を果す。谷ノート・プ
ロセッサと関連する他のマイクロプロセッサ２４はリン
ク１１を介してのＸ、２５通信に関し同様な機能全米す
。

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

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

ＭＡＰはメイン・プログラムからサフルーヂンとしてｔ
＋ｙ−ひ出てれる多数のユーティリティとリンクきれて
いるメイン・プログラム３１より成る。これらユーティ
リティはテキスト編集機能を提供するエディタ３２；ユ
ーザの端末と関連する種々のパラメータをユーザがＪｅ
、シ出したり、設定したシすること全許容するセット／
ゲット・ステーション・パラメータ・ユーティリティ３
３；ユーザがらコマンド・ラインを受は入れて、コマン
ドの動詞（例えば１ゝｃａｌｌ’または’ｈｅｌｐ“）
を識別し、該動詞を内部形態に変換し、コマンドが転送
されるユーティリティに適した形に変数をまとめる作用
をするコマンド・パーサ３４；ユーザに種々の選択メニ
ューを提供し、ユーザの選択に応じて更なるメニューを
提供したシ、ユーザのために何らかの動作ヲ冥行するメ
ニュー施設３５；および本発明の原理を具現するオン・
ライン・ドキュメンテーション施設３６等を含んでいる
。

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

データ・ベース内の記憶エリアは２つの型、即ちシステ
ム記憶エリアとユーザ記憶エリアよシ成る。第４図に示
すように、システム記憶エリア４ｏは多数のシステム・
ドキュメンテーション・ファイルＪＵＵを営んでいる。

５つのファイルが図には明示されている。これらはコマ
ンド・ドキュメンテーション・ファイル４０１．４０２
および４０３、語粟ファイル４υ４およびエラー・ドキ
ュメンテーション・ファイル４０５である。ファイル４
０１．４０２および４０３はＭ　Ａ　Ｐ　Ｘ５ｃｃｐお
よび５ＰＨＰにょシ夫々認識された特定のコマンドと関
連するシステム・ドキュメンテーションを含むレコード
よシ成っている。語ファイル４υ４はシステムで使用き
れている特定の用語の定義ヲ営むレコードよシ成る。

エラー・ファイル４０５はシステムにより検出きれ、プ
ログラム・パッケージの実行期間中にユーザに返送され
る特定のエラーまたは警報状態に関する情報を含むレコ
ードよシ成る。

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

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

各プログラム・パッケージは１環境”と呼ばれるデータ
構造を夫々含んでいる。各パッケージに対する環境はそ
の特定のプログラム゛パッケージと関連するシステム・
ドキュメンテーション・ファイルに対するファイル名を
含んでいる。詳細に述べると（第３図に示す）ＭＡＰと
関連する環境３１０は例えばＥｒｒｏｒ、　ｄｏｃ、　
Ｔｅｒｍ、　ｄｏｃおよびＭＡＰ、ｄｏｃ　　（これら
は夫々ファイル４０５．４０４、および４０１のファイ
ル名である）等のエラー、語菓およびコマンド・ファイ
ル名を含んでいる。

ドキュメンテーション施設３６が例えばＭＡＰと関連す
るコマンド・ドキュメンテーション全検索する必要が生
じた場合、該施設３６はｉｆｉ　３１０　音調べて、ア
クセスすべきシステム・ドキュメンテーション・ファイ
ルの名前全確認する。５ｃｃｐおよび５ＰＨＰと関連す
る環境はシステム全体を通して同じエラー・ニモニック
の７阻および同じ用語が使用されているならばＭＡＰ猿
境と同じエラーおよび語索ファイル名を含んでいる。し
かし各プログラム・パッケージで使用されるコマンドは
変化する。従って５ｃｃｐおよび５ｐＨｐ！境は夫々の
コマンド・ドキュメンテーション・ファイル名、即ち５
ＣＣＰ、ｄｏＣおよび５ＰＨＰ、　ｄｏｃ　　（これら
はファイル４０２および４０３の名称でめる）を含んで
いる。

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

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

メイン・レコード・フラグの値は文字１０″でりるとき
、これは１１継続“全表わし、対象となっているインデ
ックス・キーと関連するドキュメンテーションが長ずさ
てルーコード内に入りきらないため、１つまたはそれ以
上の付加的なレコードに続いて人っていることを表わす
。（このような打力目的なレコードは第１のレコードが
それによってインデックス指定濱れたキーに数字全付加
することにより形成されたキー、例えばｃａｌｌ　１、
ｃａｌｌ　２等によってインデックス指定される。） あるいはメイン・レコード・フラグは１″メニユー“ヲ
表わす文字１Ｍ“であることがある。このフラグは対象
となっているレコードが実際のドキュメンテーションで
なくメニューの名前を含んでおり、このレコードがドキ
ュメンテーション施設３６に加えられると該施設３６は
メニュー施設３５を呼び出し、該メニューをユーザに表
示すべきメニューであると指定することになる。この型
のレコードは例えばシステムがゝゝ　１ｉｓｔ　ｆｉｌ
ｅ“、’　ｌｉｓｔｃｏｍｍａｎｄｓ“、’　１ｉｓｔ
　ｄｉｒｅｃｔｉｏｒｉｅｓ“等一連のコマンド動詞に
対するドキュメンテーション全提供する場合に使用され
、ユ・−ザが不完全なドキュメンテーション・コマンド
ＨＥＬＰＬＩＳＴ　　−ｉ人力することを予期している
。この場合、コマンド・ドキュメンテーション・ファイ
ルは５Ｍ　Ｉ′をそのメイン・レコード・フラグとして
含み、ユーザにどの型のゝゝＮｓｔ″コマンドのドキュ
メンテーションを知りたいのか尋ねるメニューの名称を
含むキーゝゝ１ｉｓｔ”によってインデックス指定され
るレコードを含んでいる。

第５図に示すシステム・ドキュメンテーション・レコー
ド中のセクション・ヘッディングは表■中のヘッディン
グ（見出し）　’［ＪＳＡＧＥζ’　ＥＸＰＬＡＮＡＴ
ＩＯＮ”等の文字列でるる。セクション・テキストは谷
セクション・ヘッディングに続くテキストよシ成る文字
列である。

（第５図に示すフォーマットに従わないシステム・ドキ
ュメンテーション・ファイルで使用される他の種類のレ
コードは初期デリミタを有をないインデックス・キーの
みより成る。ドキュメンテーション施設３６はこのよう
なレコードと出会うと、そのキーによってインデックス
指定されるレコードに直ちにアクセスすることによシ応
動する。このメカニズムによシシステムがある棟の予想
されるユーザ・エラーを自動的に訂正することが可能と
なる。例えば、’　ｒ、ｕｎ　ｐｒｏｇｒａｍ”という
エントリより成るレコードは正当なコマンドで指定出来
る。従って’　ｒｕｎ　ｐｒｏｇｒａｍ“コマンドに対
するドキュメンテーションを望んでいるユーザがドキュ
メンテーション・コマンドＨＥＬＰ　ＣＯＭＭＡＮＤ　
＝　ＲＵＮ　　を誤って発生すると、ドキュメンテーシ
ョン施設はまずキーゝゝｒｕｎ“ニヨシインデックス指
定されたレコード全検累する。そのレコードがエントリ
１ゝｒｕｎｐｒｏｇｒａｍ　”を含むことが分ると、’
　ｒｕｎｐｒｏｇｒａｍ“なるインデックスを有するレ
コードを検索し、それによってユーザのエラーが自動的
に訂正されることになる。） ユーザ・ドキュメンテーション・レコード、即ちユーザ
・ドキュメンテーション・ファイル４５０の内の１つの
レコードのフォーマットが第６図に示されている。これ
は初期デリミタ、オプショナルな１つまたは２つのメイ
ン・レコード・フラグ、少なくとも第１のセクション・
ヘツデングとそれに続く各セクション・ヘッディング、
オプショナルなセクション・フラグおよびセクション・
テキスト（これらはすべてデリミタで分離されている。

）より成る。

メイン・レコード・フラグ・フィールドは前と同様１継
続“を意味する文字“Ｃ”であることがある。該フィー
ルドは１Ｒ”またはｖ′Ｎ“を含む場合がある。′Ｒ“
は１置き換え”を表わし、１Ｎ“は１新規“を表わす。

これらフラグの値はいずれも同じ機能を有しておシ、こ
のユーザ・ドキュメンテーション・レコード全体が相応
するシステム・ドキュメンテーション・レコード全体の
代りとして使用されるべきことを指示するインストラク
ションである。

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

セクション・フラグは４つの値“Ａ“、１Ｐ“、”Ｒ“
または１Ｎ“の内のいずれか１つをとシ得る。′Ａ“お
よび１１　Ｂ　＃は’　ａｆｔｅｒ　”および’　ｂｅ
ｆｏｒｅ　’　ｆ表わし、ユーザ・レコード中のセクシ
ョン・ヘッディングが、相応するシステム・ドキュメン
テーション・レコードの相応するヘッディングを有すセ
クションのセクション・テキストの後または前に夫々付
加されるべきことを指示するインストラクションである
。−Ｒ〃および１Ｎ”は夫々前述−の如く１置き換え“
および気新規″ヲ表わしている。これらはいずれも対象
となっているセクション・テキストで相応するシステム
・ドキュメンテーション・レコードの相応するヘッディ
ングＴｈ！するセクションのセクション・テキストを置
き換えることを指示する。セクション・フラグが存在し
ない場合には該セクションはセクション・フラグの値が
１Ａ“であるものとして散板われる。そしてユーザ・ド
キュメンテーション・レコードのセクション・ヘッディ
ングがいずれのシステム・ドキュメンテーション・レコ
ードのセクション・ヘッディングとも同じでない場合に
はセクション・フラグの値は以下で分るように無効とな
る。

第７〜９図のフローチャートに進む前に、ドキュメンテ
ーション・コマンドのフォーマットについて更に詳細に
議論することが適尚でめると考えられる。先に指摘し７
た如く、ユーザはＨＥＬＰ　ＣＯＭＭＡＮＤ　＝　ＣＡ
ＬＬ　、　ＨＥＬＰ　ＴＥＲＭ　＝ＢＩＬＬＩＮＧ　Ｉ
ＤＥＮＴＩＦＩＥＲおよびＨＥＬＰ　ＥＲＲＯＲ＝Ｅ　
ＮＯＴ　ＦＤＵＮＤ等のコマンドを発することが出来る
が、これに応動してシステムは対象となっているコマン
ド；用語またはエラーに対して得られる（もしユーザに
よって修正きれているならば修正てれた）ドキュメンテ
ーション全すべて提供する。オプションとしてユーザは
コマンド・ドキュメンテーションの要求に際しゝゝＣＯ
ＭＭＡＮ−“全除去して例えばＨＥＬＰＣＡＬＬ　５Ｅ
ＣＴＩＯＮ　＝　ＵＳＡＧＥ　５ＥＣＴＩＯＮ　＝　Ｅ
ＸＡＭＰＬＥとすることが出来る。更に他のオプション
とじてユーザはそのファイル名を知っている場合、ユー
ザが現在使用しているプログラム・パッケージ以外のプ
ログラム・パッケージと関連するコマンド・ドキュメン
テーション・ファイルからドキュメンテーションを取り
出すことが出来る。例えばＭＡＰのユーザがＨＥＬＰ　
ＣＡＬＬ　ＦＩＬＥ　＝　５ＣＣＰ、　ｄｏｃ　　５Ｅ
ＣＴＩＯＮ　＝ＡＲＧ［ＪＩＶＬＥＮＴＳというコマン
ドを発すると、ユーザは５ＣＣＰ　　で１更用系れてい
るゝゝｃａ１．ｌ　“コマンドの変数に関するドキュメ
ンテーションを得ることが出来る。

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

第７図は本ルーチンのレコード検累都全詳細に示してい
る。該ルーチンはステップγ旧から始するが、該ステッ
プにおいてはコマンド・パーサ３４によって加えられた
変数を調べどのドキュメンテーションが要求されている
かを決定する。ステップ７０３においてユーザが不適当
なドキュメンテーション・コマンド、例えばＨＥＬＰ　
ＥＲＲＯＲを発していたことが分るとドキュメンテーシ
ョン施設はステップ７０４においてメニュー施設３５ｋ
ｌｌ子び出す。メニュー施設はユーザからの応答を用い
てどのドキュメンテーションをユーサカ望ンでいるかを
決定する。ユーザの望んでいるドキュメンテーションが
決定てれると、メニュー施設はユーザに代ってドキュメ
ンテーション要求全形成し、該情報を再びドキュメンテ
ーション施設に加える。

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

同じで々い場合には、ドキュメンテーション施設はステ
ップ７０９において適切なシステムの名称、従ってユー
ザ・コマンド・ドキュメンテーション・ファイル（この
例ではＩＶＩＡＰ、ｄｏｃ　）　　を決定する。７１１
に示すように次にルーチンはオープン・ドキュメンテー
ション・ファイルの名称全保持している表を調べ、ＭＩ
ＡＰ、　ｄ　ｏ　ｃと名付けられたファイルが既にオー
プンされているかどうかを決定する。

オープンされていない場合には、７１４に示すようにシ
ステムおよびユーザ記憶エリアの両方において’ｆｌｌ
ｌ’ｈＰ−ｄ　ｏ　ｃなる名称のファイルのオープンが
行なわれる。

ここでシステム・ファイルは常に存在するから現在対象
としている名称のシステム・ファイルはオープンしてい
るものと仮定することが出来る。しかし袈求きれたイ■
頑のドキュメンテーションに対するユーザ・ファイルは
存在しないこともある。従って７１７でＭＡＰ、　ｄ　
ｏ　ｃと名付けられたオープン・ユーザ・ファイルが実
際に存在するかどうかが決定される。もし存在しない場
合にはルーチンは直接ステップ７３２に進み、そこで対
象となっているコマンドに対するドキュメンテーション
を含むレコードが検索される。

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

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

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

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

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

能力、現在４属の対象となっているシステム・ブロック
中のセクション・ヘッディングと整合するセクション・
ヘッディングがユーザ・ブロック１０４０の１つの中に
存在すると、本ルーチンはステップ８１６において次に
人手可能な出力ブロックのロケーション１０６１中に該
ヘッディングをコピーし、次いでステップ８１９におい
てユーザ・ブロックのロケーション１０４５に記憶され
たセクション・フラグの値に従って出力ブロック中のテ
キスト・ポインタ（および相応する文字数）ヲセットす
る。もしセクション・フラグの値が“Ａ“（ゝゝａｆｔ
ｅｒ　〃に意味する）であると、出力ブロックのロケー
ション１０６２および１０６４に記憶された第１および
第２のテキスト・ポインタはシステムおよびユーザ・ブ
ロックのロケーション１０２２および１０４２に記憶さ
れたテキスト・ポインタの値が与えられる。文字数に関
しても同様なことが行なわれる。セクション・フラグが
ゝゝＢ　ＩＩ（１Ｖｂｅｆｏｒｅ　“全意味する）であ
ると、出力ブロック・テキスト・ポインタおよび文字数
は同じ値が逆の順序で割当てられる。セクション・フラ
グが１１Ｒ”（ゝゝｒｅｐｌａｃｅ　“を意味する）′
またはゝＮ″げｎｅｗ　″全意味する）であると、特定
のセクションに対するシステム・ドキュメンテーション
はユーザ・ドキュメンテーションにより完全に置き換え
られる。

この場合、□出力フロック中の第１のテキスト・ポイン
タおよび文字数にはユーザ・フロック・テキスト・ポイ
ンタおよび文字数の値が与えられ、第２の出力ブロック
・テキスト・ポインタは空ストリングとなる。ステップ
８２１に示きれているように、対象となっているユーザ
・ブロックは現在使用中であるということがそのセクシ
ョン・ヘッディングを空ストリングとする□ことにより
マークされる。

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

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

これでドキュメンテーションがプリント、即ちユーザに
表示される準備が出来たことになる。葦ず最初にレコー
ド検索に使用されたレコード・キーがステップ９０８に
おいて太文字で二重畳印を付してプリントされる。（例
えば表■および表■の”　ＣＡＬＬ　＊＊　）　　次に
出力リスト１０５０の各ブロックが９１１から始まるル
ープで処理される。ループ内において、容量カブロック
はまずステップ９１３においてプリントするべくマーク
されているかどうかがチェックされる。マークされてい
ないと、次のブロックに移る。しかしブロックがプリン
トするべくマークされていると、ルーチンはステップ９
１５．９１６および９１９に’４行し、そこでセクショ
ン・ヘッディングは大文字化されて印字きれ、出力ブロ
ック中の指定された第２のテキスト、次いで第２のテキ
スト（もし祥在する場合には）が印字される。

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

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

【図面の簡単な説明】

第１図は本発明が使用されるデータ処理／通信システム
のブロック図、第２図は第１図のシステム内のマルチ計
算機ノードのブロック図、第３図は本発明の原理を実現
するオン・ライン・ドキュメンテーション機能全台む第
２図のノード内で実行されるプログラム・パッケージを
示す図、第４図は第２図のノード内にあるシステムの一
部およびユーザ・データ・ベース・記憶エリアを示す図
、第５図はシステム記憶エリア内に保持されているシス
テム・ドキュメンテーション・レコードのフォーマット
を示す図、第６図はユーザ記憶エリア内に保持されてい
るユーザ・ドキュメンテーション・レコードのフォーマ
ットを示す図、第７〜９図はオン・ライン・ドキュメン
テーション機能のフローチャートを示す図、第１０図は
実行期間中にオン・ライン・ドキュメンテーション機能
によって生成されるシステム、ユーザおよび出力レコー
ド・リストを示す図である。 〔主要部分の符号の説明〕 する第、１の手段 出願人　　　ウェスターン　エレクトリックカムパニー
、インコーポレーテツド 第１頁の続き ル ′アメリカ合衆国０７７４８ニュージ ャーシイ・モンマウス・ミドル タウン・ラフアイエッチ・コー ト２１ 手続補正書（方式） ％式％ １事件の表示昭和５８年　特許願第　９５９１２　置方
法及び装置 ３　補正をする者 事件との関係　特許出願人 ４代理人 （ＩＪ　　別紙の通り説明文字を削除した図面（第５図
〜第１０図）を１通提出致します。 −４２′

Claims (1)

1. 【特許請求の範囲】 １、　計算機システムで使用されるオン・ライン・ドキ
   ュメンテーションの方法でりっで、該方法は： 特定のドキュメンテーション・コマンドをユーザが発す
   ることに応動してその特定のドキュメンテーション・コ
   マンドト関連するシステム・コマンドを該システムの個
   々のユーザに提供し、 前記特定のドキュメンテーション・コマンド全少なくと
   も１人の他のユーザが発することに応動して該油のユー
   ザにより前以って定義きれたユーザに特許なドキュメン
   テーションを該システムの前記他のユーザに提供するス
   テップよシ成ることを特徴とするオン・ライン・ドキュ
   メンテーションの方法。 ２、　計算機システムで便用されるオン・ライン・ドキ
   ュメンテーションの方法＊笑行−ｒる装置において、該
   装置は： 特定のドキュメンテーション・コマンドをユーザが発す
   ることに応動して該特定のドキュメンテーション・コマ
   ンドと関連するシステム・ドキュメンテーションを該シ
   ステムの個々のユーザに提供する第１の手段（例えば３
   ６．４０　；　１０１０．１０５０）と、 前記特定のドキュメンテーション・コマンドを少なくと
   も１人の他のユーザが発することに応動して、該他のユ
   ーザによって前以って定義されたユーザに特有のドキュ
   メンテーションを該システムの前記他のニー砂に提供す
   る第２の手段（例えば３６．４０．４５．１０３０．１
   ０５０）とにより特徴づけられる装置。 ３、特許請求の範囲第２項記載の装置において、 前記第１および第２の手段は前記特定のドキュメンテー
   ション・コマンドと関連するシステム・ドキュメンテー
   ションを記憶し、該システムのユーザにょυ発生され得
   る他のドキュメンテーション・コマンドと関連するシス
   テム・ドキュメンテーションを記憶する共通の手段（例
   えば４０）を含み、 前記第２の手段は更に、 少なくとも前記特定のドキュメンテーション・コマンド
   と関連する１つまたはそれ以上のユーザ・ドキュメンテ
   ーション・テキストを記憶し、各々のユーザ・ドキュメ
   ンテーション・テキスト全どのように使用すれば前記特
   定のコマンドと関連する記憶てれたシステム・ドキュメ
   ンテーションを変更することが出来るか全示す各々のユ
   ーザ・ドキュメンテーションと関連するインストラクシ
   ョン全記憶する手段（４５）と、各々の前記インストラ
   クションに従って前記ユーザに特有のドキュメンテーシ
   ョン全生成する手段（例えば３６．１０３０゜１０５０
   ．１０１０）と全古むことを特徴とする装置。 ４、特許請求の範囲第２項記載の装置において、 前記第１および第２の手段は前記特定のドキュメンテー
   ション・コマンドと関連するシステム・ドキュメンテー
   ションを記憶し、！システムのユーザが発生し得る他の
   ドキュメンテーション・コマンドと関連するシステム・
   ドキュメンテーションを記憶する共通の手段（例えば４
   ０）ｙ含み、谷ドキュメンテーション・コマンドト関連
   するシステム・ドキュメンテーションは１つまたはそれ
   以上のセクションのシステム・ドキュメンテーション・
   テキストより成シ、 前記第２の手段は更に少なくとも前記特定のドキュメン
   テーション・コマンドト関連した１つまたはそれ以上の
   ユーザ・ドキュメンテーション・テキストを記憶し、そ
   のユーザ・ドキュメンテーション・テキストが相応する
   システム・ドキュメンテーション・テキストに付加され
   るべきものか、相応するシステム・ドキュメンテーショ
   ン・テキストと置き換えるのに使用すべきものか、また
   は前記ユーザに特有のドキュメンテーション中の別個の
   セクションとして使用すべきものかを指示する谷々のユ
   ーザ・ドキュメンテーション・テキストと関連するイン
   ストラクションを記憶する手段（例えば４５）を含み、 前記第２の手段（例えば３６．１０１０．１０５０．１
   ０３０）は更に前記各々のインストラクションに従って
   前記ユーザに特有のドキュメンテーションを生成する手
   段を含んでいることを特徴とする装置。