Zen ファイルのデフォルトの保存場所については、『Getting Started with Zen』のファイルはどこにインストールされますか？を参照してください。

Windows では、これらのユーティリティは Zen インストールの bin ディレクトリにインストールされます。デフォルトの場所にインストールした場合は、C:\Program Files (x86)\Actian\Zen\bin\ です。Zen インストールはインストール ディレクトリを PATH 環境変数に追加するため、これらのユーティリティはコマンド プロンプトでどこからでも使用できます。

Linux では、ユーティリティは /usr/local/psql/bin にインストールされます。zen-svc というユーザーは、このユーティリティを使用するための必須の環境変数です。zen-svc 以外のアカウントでユーティリティを使用したい場合は、Linux および Raspbian での Zen のアカウント管理の説明に従ってください。

bcfg ツールについては、『Advanced Operations Guide』で説明しています。bcfg を使用した設定を参照してください。

以下のデータ内容を使用して、サンプルの文字区切りテキスト ファイルが作成されています。使用例を検証するのに、このファイルを使用することができます。例では、このファイルを data_file.txt として使用しています。以下のデータ内容はカンマ区切りになっているため、BDU では -t パラメーターを指定する必要があることに注意してください。-t パラメーターは、タブ文字以外の区切り文字では必須です。

たとえば、ソース ファイルに各行が \n で分離されるテキストを含まれている場合は、次のように記述します。

bmon ツールについては、『Advanced Operations Guide』で説明しています。Monitor のコマンド ライン インターフェイスを参照してください。

btadmin ツールは、Zen ユーザーを認証するためのユーザー名とパスワードが保存されたフラット ファイル btpasswd の作成と更新に使用します。管理者権限を付与されたユーザーは、リモートでエンジンのステータスを監視し、エンジンを設定できます。

username
この変数に指定したユーザー名を btpasswd ファイル内で作成または更新します。username に指定したユーザー名がこのファイルに存在しない場合、そのユーザー名がエントリとして追加されます。存在する場合は、btpasswd ファイルが変更されます。

リモート ワークステーションからエンジンを管理するには、ユーザー名とパスワードを指定する必要があります。Zen の初期インストール時では、デフォルトのユーザー名は admin で、パスワードは空です。

btadmin を使用して管理者を追加します。

このツールは、username として指定したユーザーに password として指定したパスワードを付けたレコードをファイル btpasswd に作成します（オプション -p を使用しなかった場合、パスワードの入力が求められます）。ユーザーが既に存在する場合は、パスワードが指定されたとおりに変更されます。

デフォルトでは、ユーザーは管理者権限なしで作成されます。a+ オプションを使用して、ユーザーに管理者権限を付与できます。管理者権限を取り消すには、a- オプションを使用します。

btpasswd ファイルが変更されるたびに、前バージョンが btpasswd- にバックアップされます。

Btrieve ユーティリティ butil は、Btrieve ファイルとそのデータの操作や管理のためにコマンド プロンプトで使用されます。butil を使用することで以下の操作が実行できます。

Continuous オペレーションは、Zen ベースのアプリケーションで使用中のファイルをバックアップできる MicroKernel エンジンの機能です。Maintenance ユーティリティの 2 つのコマンド startbu と endbu を使用して、単一または複数のファイルに対する Continuous オペレーションを開始および終了します。

コマンド オプションを指定せずに、または無効なコマンド オプションを指定して butil を実行すると、使用方法のメッセージが表示されます。使用方法のメッセージは、butil には、オプションの /S コマンド ライン引数があることを示します。この引数は Linux または Raspbian では無視されます。

butil のコマンド、オプションおよび使用例の詳しい説明については、『Advanced Operations Guide』の Btrieve の Maintenance コマンド ライン ツール（butil）を参照してください。

コマンド ライン バージョンの License Administrator ツールは、エンジン上のユーザー カウント ライセンスを管理します。Windows および Linux の 32 ビット コマンド ライン ツールは clilcadm です。このツールの Windows 64 ビット バージョンは w64clilcadm、Linux の 64 ビット バージョンは clilcadm64 です。64 ビット システムでの下位互換のため、clilcadm を使用すると clilcadm64 を呼び出します。

コマンド ライン オプションの詳しい説明については、License Administrator のトピック CLI 構文を参照してください。

製品キーおよびそれに関連するユーティリティの詳細については、ライセンス管理で説明しています。

clipaadm ツールは、オンライン、リモートまたはオフラインによるキーの認証が不可能な場合に、手動による Zen の認証を可能にします。clipaadm は CLI バージョンの手動認証管理ユーティリティです。ここで説明する手順を、ご利用のプラットフォームに応じたバージョンのツールを使用して実行してください。

clipaadm はパラメーターなしで使用できますが、パラメーターを指定する 2 つの手順で使用することもできます。

clipaadm は、stdin を処理する環境ではパラメーターがなくても実行できます。このように実行された clipaadm は対話型モードになり、製品キーを認証する手順が表示されます。

リモートによる PowerShell セッションなど、stdin をサポートしない環境では、下記の 2 つの手順で記述しているパラメーターを指定した clipaadm を使用することで認証を実行することができます。

製品キーの管理の詳細については、ライセンス管理で説明しています。

dbdefrag ツールについては、『Advanced Operations Guide』で説明しています。データ ファイルの断片化の監視を参照してください。

dbmaint ツールは、名前付きデータベースを管理します。

dbmaint a | d | l | m [-nDbname][-a][-b][-c][-i][-e][-v][-ldictpath][-ddatapath][-ssecuritymode]

dsnadd、butil(1)、btadmin(1)、syslogd(1)、smb.conf(5)

『Advanced Operations Guide』の データベース コード ページとクライアント エンコードを参照してください。

deu データ エクスポート ユーティリティは、SQL SELECT ステートメントの結果を区切り文字付きテキスト ファイルにエクスポートします。

以下の値は -d オプションで使用できるコード ページを示します。このオプションを指定しない場合、デフォルトはオペレーティング システムのエンコードです。これらの値では、大文字と小文字は区別されません。

以下の値は -e オプションで使用できるコード ページを示します。このオプションを指定しない場合、デフォルトは CP1252 です。これらの値では、大文字と小文字は区別されません。

次の一覧は、deu による、選択されたデータ型のエクスポートの処理方法を示します。

次の例は、deu コマンド ラインの -h ヘルプに含まれているものです。

deu demodata select.sql datafile.dat -c -l log.txt

C:\>deu demodata D:\Data\select.sql D:\Data\datafile.dat -c -l D:\Data\log.txt

deu は、結果が 1 つのレコード セットになる、selectfile 内の 1 つの SELECT ステートメントを受け入れるように設計されています。複数の SELECT ステートメントがセミコロンで区切られて含まれるファイルの場合、エラーは返されませんが、deu は最初の SELECT ステートメントのみを実行します。

selectfile では、次の例のように、 UNION を使用して複数の SELECT ステートメントを組み合わせることができます。

SELECT * FROM Class where max_size <= 25

Zen は /usr/local/actianzen/etc にある odbcinst.ini ファイルを使用することで UNIXODBC に従い、32 ビットおよび 64 ビット ODBC ドライバーを指定します。ドライバー記述 Pervasive ODBC Interface を参照する DSN は、odbc.ini ファイル内の odbcinst.ini 情報を指し示します。1 つの DSN を 32 ビット アプリケーションと 64 ビット アプリケーションの両方で使用することができます。注記も参照してください。

myDSN は、新しいデータ ソースに割り当てたい名前です。

DBname は、Zen ホスト上の名前付きデータベースの名前です。

zenhost は、Zen Enterprise Server または Cloud Server がインストールされているホストの名前です。

engineDSN は、Zen ホスト上のエンジン DSN の名前です。

dsnadd -dsn=acctingdb -db=region1accting

dsnadd -dsn=USInvoices -db=DomesticOrders -host=USInventory

dsnadd -dsn=bkorderclnt -sdsn=backordersrv -host=JapanSvr2 -translate=auto -clntdsn

dsnadd -dsn=partsctlg -db=partscatalog -engdsn

btadmin、dbmaint、isql

easysync は、Zen データベース サーバー間で新規作成または更新されたレコードのレプリケーションを自動化できるデータ同期ユーティリティです。2 つのデータベースは、それぞれ異なるサーバー上にあっても、また同じサーバー上にあってもかまいません。同期の頻度は、ほぼリアルタイムにすることも、長い間隔を空けてスケジュールすることもできます。全般的な監視、エラーの検出、予期しない結果のトラブルシューティングを可能にするログ機能が含まれています。easysync を使用する場合は、以下の点に注意してください。

対話型の ODBC テスト ツールである isql を使用するれば、DSN に対しデータベースへの接続をテストしたり、データベースに接続できていれば SQL ステートメントを実行したりすることができます。このツールの 32 ビット版は、Zen Enterprise Server 32 ビット、Zen Client 32 ビット、また Zen Enterprise Server 64 ビットのインストールで一緒にインストールされます。このツールの 64 ビット版は isql64 という名前です。これは Enterprise Server 64 ビットおよび Client 64 ビットのインストールで一緒にインストールされます。

2 つのユーティリティの違いは、接続できる DSN のタイプです。デフォルトで、dsnadd は 32 ビットおよび 64 ビットのどちらのアプリケーションにもアクセスできます（DSN はドライバー記述 "Pervasive ODBC Interface" を指定します）。isql または isql64 ではそのような DSN の接続をテストできます。Linux および Raspbian 用の Zen ODBC ドライバー記述を参照してください。

使用が推奨されないレガシー スタイルの DSN がアクセスできるのは 32 ビット アプリケーションのみです。このため、そのような DSN の接続テストが可能なのは isql のみです。Linux または Raspbian 向けの ODBC および DSN サポートに関する FAQ を参照してください。

たとえば、Zen に含まれる Demodata サンプル データベースに接続するには、isql demodata または isql64 demodata というように、DSN を第 1 パラメーターとして指定し isql（または isql64）を実行します（Demodata 用の DSN にはドライバー記述に "Pervasive ODBC Interface" を指定するので、どちらのバージョンのツールもその DSN 接続をテストすることができます）。

このツールを使用すると、データベースを対話型で処理できる状態になります。この状態で、データベースにクエリ（SELECT * FROM Department など）を実行することができます。

isql を使用してデータベースのセキュリティを有効にするには、まず Master ユーザーとしてデータベースに接続します。次に SQL の SET SECURITY ステートメントを使用して Master ユーザーのパスワードを設定します。たとえば、次のように指定します。

『SQL Engine Reference』の SET SECURITY を参照してください。

セキュリティが設定されているデータベースに接続するには、isql の 2 番目と 3 番目のパラメーターとして、それぞれユーザー名とパスワードを渡します。たとえば、demodata にパスワード vforge を使用し Master ユーザーとして接続するには、isql64 demodata Master vforge または isql demodata Master vforge と入力します。

isql および isql64 は入出力のリダイレクションとパイプをサポートします。さらに、両ユーティリティは複数の SQL ステートメントを含むファイルを処理することができます。各ステートメントの終わりには、キャリッジ リターン/ライン フィードを指定する必要があります。ファイルの最終行は空白行にしてください。例を参照してください。

licgetauth ツールは、製品キーの認証に用いられるオフライン認証プロセスの第 2 段階で使用されます。このツールは clilcadm と組み合わせて使用することで、オフライン認証プロセスが完了します。

psc は、Actian Zen Enterprise Server サービスに関する制御情報を取得および設定するためのツールです。

psc を実行するには、管理者権限を持っている必要があります。

サービスには、特に（ハードウェアに近い）低レベルでほかのプログラムをサポートする、特定のシステム関数を実行するプログラム、ルーチンまたはプロセスの名前を指定します。servicename は、レジストリでサービス キーに設定されている名前です。サービス キー名は、サービス表示名とは異なることがあるので注意してください。多くの場合は、異なります。

start、stop、および restart で zenengine サービス名を使用できます。

psc ツールでは psc コマンドの実行後、サービスの状態を示す以下のコード（DOS ERRORLEVEL）を返します。

pvdbpass を使用すると、ユーザーは管理者の介入なしでセキュリティで保護されたデータベースのパスワードを変更することができます。

『SQL Engine Reference』で、使用できる SQL 構文に関する詳細を参照してください。

pvnetpass は、Zen ネットワーク パスワード ユーティリティです。クライアントが接続するサーバーのユーザー ID とパスワードを管理するのに使用するコマンド ライン ツールです。サーバーに接続しようとする場合、クライアントはレジストリでサーバー名を検索し、そのサーバーのユーザー名とパスワードのセットを使用します。

アプリケーションが MicroKernel エンジンを使用し、BTPASSWD または PAM 認証を使用するよう設定されている Linux または Raspbian データベース エンジンに接続する場合、このアプリケーションはデータベース エンジンに接続するのに一連の資格情報を必要とします。pvnetpass を使用して、アプリケーションが使用する一連の資格情報を設定します。Pvnetpass は、データベース エンジンがローカルでもリモートでもそのデータベース エンジンに接続するすべてのマシンで実行する必要があります。詳細については、『Getting Started with Zen』の認証（Authentication）を参照してください。

同一サーバーに対してグローバル エントリおよびユーザー エントリを持っている場合、ユーザー エントリがグローバル エントリより優先されます。ユーザー名にはユーザー コンテキスト全部を含める必要があります。たとえば、ドメイン名を持つ Windows 環境ではユーザーは domain\user のように指定します。Linux または Raspbian 環境では、mymachine.mydomain などの完全なマシン DNS 名とユーザー アカウント名を使用します。

pvnetpass ユーティリティは、Windows クライアントで、ログイン ダイアログを使用して保存された証明を変更するのにも使用できます。『Advanced Operations Guide』のクライアント保持の資格情報の容認およびクライアント資格情報の入力要求を参照してください。

ユーザー コンテキスト（PS_HKEY_USER）にデフォルトのサーバー エントリを追加するには次のように記述します。

マシン コンテキスト（PS_HKEY_CONFIG）にデフォルトのサーバー エントリを追加するには次のように記述します。

rbldcli ツールはサーバー上の MicroKernel データ ファイルの再構築に使用します。

rebuild の詳細については、『Advanced Operations Guide』のコマンド構文を参照してください。

Zen v16 リリースには、rbldcli_offline と呼ばれる、rbldcli のスタンドアロン バージョンが含まれています。このユーティリティを使用すれば、Zen がインストールされていないシステムで Zen データ ファイルを変換することができます。大量のファイルやサイズが非常に大きなファイルをリビルドすると、他のユーザーに対する Zen データベース エンジンのパフォーマンスを低下させる可能性があります。別のシステムでファイルをリビルドできれば、この問題を回避できます。

データ ファイルのリビルドの詳細については、『Advanced Operations Guide』を参照してください。