Caché のリモート管理

^GBLOCKCOPY の使用

^GBLOCKCOPY は、以下のように異なる複数の演算で使用されます。

• データベースから他のデータベース、またはネームスペースに 1 つ以上のグローバルをコピーします。 — コピー先のデータベースまたはネームスペースにコピーするグローバルを 1 つ以上選択できます。グローバルがコピー先のデータベースに既に存在する場合、ソース・グローバルのデータは既存のデータに結合されます。

• 添え字レベル・マッピングを使用して、1 つのデータベースからのグローバルを複数のデータベースに分割します。 — グローバルの添え字レベル・マッピング (SLM) でネームスペースを設定することで、データベースのグローバルを新規のネームスペースにコピーすることができます。これにより、SLM を構築するデータベース間でグローバルを分割することができます。

• 複数のデータベース内の添え字マップされたグローバルを、1 つのデータベースに移動します。 — グローバル全体を含む新規のデータベースを作成します。次に、異なるすべての SLM データベースから新規のデータベースにコピーするバッチで、複数のコピーを設定します。データベースは現在、2 GB を超過できるため、これは複数のデータベースを 1 つに統合するのに便利なメソッドです。

• データベースのコピーを作成します。すべてのグローバルを別のディレクトリにコピーすることによって、データベースをそのディレクトリにコピーできます。

• ECP を通じて他のマシンにグローバルをコピーします。 — ^GBLOCKCOPY は、ECP ネットワーク接続上の他のマシンへのグローバルのコピーをサポートします。リモート・マシンに対する ECP 接続、およびそれを示すネームスペース・マッピングを設定する必要があります。次に、“Copy from Database to Namespace” オプションを選択し、コピー先としてリモート・ネームスペースを選択します。

• データベースの未使用スペースを再要求します。大規模なグローバルがデータベース内で作成されて削除された場合、データベースには未使用の余分なスペースがあることがあります。データベースのすべてのグローバルを新規のデータベースにコピーし、古いデータベースを新しいもので置換すると、このスペースを削除できます。

• データベース内のポインタを再編成します。データベースがブロックの分割により断片化された場合、そのデータベース内のデータを再編成すると高速なパフォーマンスを得ることができます。これには、データベース内のすべてのグローバルを新規のデータベースにコピーし、古いデータベースを新規のデータベースに置換します。

• グローバルの照合の変更 — ソース・グローバルが以下の照合タイプのいずれかの場合に行われます。

  • ISM Pre-6.2

  • ISM 6.2->6.4

  • Ipsum/Cobra

  • Ipsum/Cobra-2

  ^GBLOCKCOPY を使用してコピーされた場合、グローバルの照合は、Caché 標準に自動的に変更されます。

  照合のタイプを変更したい (例えば、Caché 標準から German1) グローバルが既に存在している場合、^GBLOCKCOPY を実行する前に、適切な既定の照合を持つコピー先のデータベースにグローバルを作成します。

  Note:

  ISM 5.10/6.4 から移行されたデータベースには、ISM 照合を持つグローバルが含まれます。

• 古いデータベースを CACHE.DAT データベース、またはネームスペースにインポートします。CACHE.DAT データベースやネームスペースにインポートしたい古いデータベース・ファイルがある場合は、コピー時にそのファイルが存在するディレクトリをソース・ディレクトリとして選択します。データベースは CACHE.DAT という名前に変更され、データをコピー先のデータベースやネームスペースにコピーすることができるようになります。

• ISM 5.10/6.4 MUMPS.DAT データベースを CACHE.DAT データベース、またはネームスペースにインポートします。CACHE.DAT データベースやネームスペースにインポートしたい MUMPS.DAT ファイルがある場合、コピー時にそのファイルが存在するディレクトリをソース・ディレクトリとして選択します。データベースは CACHE.DAT という名前に変更され、データをコピー先のデータベースやネームスペースにコピーすることができるようになります。

^GBLOCKCOPY の実行

^GBLOCKCOPY を実行する前 (またはアップグレードを実行する前) に、ご使用のデータベースのオペレーティング・システムの完全なバックアップを作成し、データベースに破損がないことを確実にするために整合性チェックを実行します。

^GBLOCKCOPY のバッチ機能を使用して、同時に実行するバッチ操作を設定することができます。操作バッチが実行されている間、Monitor、または Batch Report を使用して進行状況を監視することができます。

現在定義されているスイッチ

スイッチは、すべて番号によって識別されます。Caché の起動時、スイッチはゼロ (オフ) に初期化されます。次のテーブルは、スイッチの番号とその動作を示しています。

スイッチの操作法

^SWSET ルーチンを使用して、スイッチの値を直接操作できます。また、クラスタ・システム上でのジャーナル操作やシステム・バックアップを行う機能など、他の Caché 機能でも呼び出し元に代わってスイッチの値を設定できます。

SWSET ルーチン

このルーチンは、ターミナル・セッションなどからスイッチの値をインタラクティブに設定する方法を提供します。

SWSET

パラメータ

なし

備考

この後の例に示す方法でこのルーチンを呼び出すと、スイッチ番号とそのスイッチに設定する値 (0 または 1) の入力を求められます。

例

以下の例は、SWSET の使用法を示しています。実行すると、

    DO ^SWSET

以下のような内容が順次表示されます。

Set/Clear switch #:

Set/Clear switch #: 2

Set/Clear switch #: 2 to value (0 or 1):

Set/Clear switch #: 2 to value (0 or 1): 1

Set/Clear switch #: 2 to value (0 or 1): 1...done

%swstat^SWSET 関数

この関数は、スイッチの現在の設定を返します。

%swstat^SWSET(switch)

パラメータ

• switch — スイッチの番号。

備考

switch が有効な番号の場合、この関数はスイッチの値を次のどちらかとして返します。

• 0 — スイッチはリセットされています (オフ)。

• 1 — スイッチは設定されています (オン)。

それ以外の場合は、エラーが発生したことを示す値の –1 を返します。

例

以下の例は、スイッチ番号 1 の値を出力します。

   Write $$%swstat^SWSET(1)

%swset^SWSET 関数

この関数は、スイッチを指定された値に設定します。

%swset^SWSET(switch, value)

パラメータ

• switch — スイッチの番号。

• value — 設定する値 (0 または 1)。

備考

返り値としては、以下の 3 種類があります。

• 0 — スイッチが、目的の値に設定されていなかったことを示します。

• 1 — スイッチが、新しい目的の値に適切に設定されていたことを示します。

• -1 — スイッチが指定不可能な値 (0 か 1 以外) に設定されていたことを示します。

例

以下の例は、スイッチ番号 1 の値をオフに設定します。

   Write $$%swset^SWSET(1, 0)

失敗モード

Caché プロセスがシステム予約のいずれかのスイッチを設定し、その処理を適切にクリーンアップせずに終了した場合、システムが制限されたオペレーティング・モードのままになる場合があります。例えば、あるプロセスでスイッチ 12 を設定した後に重大な障害 (あるいは単純な停止) が発生した場合、Caché は以降のユーザがログインできない状態になります。この問題が生じた場合は、インターシステムズのサポート窓口 (WRC)Opens in a new tab までお問い合わせください。

CctrlGetDirs

指定された構成名に対して、構成・バイナリ・マネージャー、それぞれのディレクトリ・パスと、サービス名を検索します。

構文

CctrlGetDirs(char *config, CCTRL_DIR_INFO *dirinfo)

config	要求される構成名
dirinfo	ディレクトリ情報が格納される C 構造へのポインタ

CctrlConfigStatus

Caché 構成の状態を返します。

構文

CctrlConfigStatus(char* config)

config

要求される構成名

CctrlControl

Windows NT の Caché コントロール・サービスを経由して、あるいは Windows 95/98 で直接 Caché 構成を制御します。

構文

CctrlControl(char *command, char *config)

command	以下のコマンドのいずれか 1 つを使用します。 start — 構成を開始 stop — 構成の無理のないシャット・ダウン stopnoshut — ユーザ提供のシャット・ダウン・ルーチンを実行せずに、構成をシャット・ダウン force — 構成の強制終了。UNIX® システムの cforce と同じです。 stopstart — 無理のない構成の停止と、素早い再起動
config	要求される構成名

CctrlRun

指示された構成とネームスペースで Caché プロセスを開始し、指示された主要入出力デバイスを使用し、指示されたルーチンを呼び出します。

構文

CctrlRun(char *config, char *routine, char *namespace, char *IOtype)

config	実行中の構成名です。
routine	開始するために要求されるルーチン名です。
namespace	要求されるネームスペース名です。
IOtype	cterminal あるいは none のいずれかの値を持つ入出力の処理方法です。 cterminal — Caché プログラマのターミナル none — 入出力なし。プロセスは、NUL でバックグラウンドで実行されます。$Principal で使用されます。$Principal への書き込みは破棄されます。$Principal からの読み取りはエラーになります。

CctrlRunIO

指示された構成とネームスペースで Caché プロセスを開始し、指示された主要入出力デバイス・タイプを使用し、指示されたルーチンと、入出力デバイスおよびエラー・デバイス用の追加の入出力仕様を呼び出します。

構文

CctrlRunIO(
        char *config, 
        char *routine, 
        char *namespace, 
        char *IOtype, 
        HANDLE *hIO, 
        char *cwd, 
        char *options, 
        HANDLE *child, 
        DWORD *childPID))

config	実行中の構成名で、すべて大文字です。
routine	開始するために要求されるルーチン名です。
namespace	要求されるネームスペース名です。
IOtype	cterminal あるいは none のいずれかの値を持つ TCP の処理方法です。 TCP — TCP ソケット cterminal — Caché プログラマのターミナル none — 入出力なし。プロセスは、NUL でバックグラウンドで実行されます。$Principal で使用されます。$Principal への書き込みは破棄されます。$Principal からの読み取りはエラーになります。
hIO	3 つの配列は、Caché プロセスの標準入出力、エラー・デバイスとして使用するために処理します。
cwd	子プロセスの作業中のディレクトリ・パスです。ディレクトリ引数が 0 の場合、現在のプロセスの作業ディレクトリを使用します。
option	追加の cache.exe コマンド行オプションが、生成されたコマンド行に追加されます。例えば、大規模プロセスのメモリ・サイズ (-b 1024) を定義できます。
child	子プロセスへのハンドルが返される HANDLE タイプ変数へのポインタです。ハンドルの値が 0 の場合、子プロセスのハンドルは、この関数によってクローズされます。
childPID	生成された cache.exe プロセスの PID へのポインタです。 この引数は、子の PID が要求されない場合、ゼロになります。

Windows NT では、指定の構成を実行する必要があります。構成が実行中かどうかが判別できない場合、CctrlConfigStatus と CctrlControl を使用してチェックし、必要な構成を開始してください。これにより Caché は、コントロール・サービスを使用せずに構成を開始しないようにします。

^SHADOW

管理者は、このルーチンを使用して、別の Caché インスタンスのシャドウ・システムとして機能する Caché インスタンスを定義および管理できます。

1. シャドウの作成

   このシステムのシャドウ・サーバとして機能する別システムを識別するのに必要なパラメータを指定できます。

2. シャドウの編集

   既存のシャドウに関連付けられているパラメータを変更できます。

3. シャドウとそのプロパティの一覧表示

   シャドウ・サーバとして定義されているシステムとそのプロパティを一覧表示します。

4. シャドウとその動作ステータスの一覧表示

   シャドウ・サーバとして定義されているシステムとそのパフォーマンス情報を一覧表示します。

5. シャドウの開始

   定義済みのサーバでシャドウイングを開始します。

6. シャドウの停止

   シャドウイング動作を停止します。

7. シャドウの一時停止

   シャドウ・サーバへのデータの転送を一時停止します。

8. シャドウの再開

   一時停止中のサーバでシャドウイング動作を再開します。

9. シャドウの再起動

   定義済みのサーバでシャドウイングを再起動します。

10. シャドウの削除

    現行システムの定義済みシャドウ・サーバ・リストからシステムを削除します。

11. シャドウの詳細の表示

    特定のシャドウ・サーバに関するすべての情報を表示します。

^LEGACYNETWORK

このルーチンは、Caché と連携できる従来のネットワーク・ツールの構成をサポートします。

1. COM ポート設定

   COM ポート (シリアル通信ポート) をリスト、追加、編集、および削除できます。COM ポートの追加および編集には、そのさまざまな構成パラメータの指定も含まれます。

2. 終了