スイッチの使用法

InterSystems IRIS スイッチは、インスタンス単位のフラグで、さまざまな目的に使用できます。特に、バックアップの実行中やクラッシュしたシステムの回復中に、各種システム・プロセスを抑制する際に便利です。^SWSET ルーチンを使用して、スイッチの値を直接操作できます。

InterSystems IRIS のスイッチの起源はマシンとの物理的な接点にあり、かつてはコンピュータのオペレータ・コンソールの一部として使用されたり、マイクロコンピュータのフロント・パネルに装備されていました。オペレータは、これらのスイッチの 1 つを設定することで、そのマシンで実行中のプログラムに 1 ビットの情報を送信できました。InterSystems IRIS では “仮想マシン” が実装されるため、マシンに対するスイッチの概念も同様に抽象化されています。

今日、InterSystems IRIS におけるスイッチとは、InterSystems IRIS インスタンスの共有メモリまたは共通メモリの個々のビット設定であり、すべての InterSystems IRIS プロセスから見えます。一部のスイッチはユーザに対して設定されますが、その大半は InterSystems IRIS 自体のオペレーションに影響を与えます。

スイッチの操作法

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

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 — スイッチの番号。

備考

考えられる返り値として以下の 3 つがあります。

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

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

• -1 — スイッチが無効な値 (0 または 1 以外の値) に設定されていることを示します。

例

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

   Write $$%swstat^SWSET(1)

%swset^SWSET 関数

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

%swset^SWSET(switch, value)

パラメータ

• switch — スイッチの番号。

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

備考

switch が有効な番号で value が 0 または 1 の場合、この関数はスイッチを指定された値に設定し、次を返します。

• 0 — スイッチはリセットされました (オフ)。

• 1 — スイッチは設定されました (オン)。

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

例

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

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