tmconfig、wtmconfig(1)

名前

tmconfig、wtmconfig-ネイティブ・クライアントまたはワークステーション・クライアントとして実行中の BEA Tuxedo アプリケーションに関する情報を、動的に更新および検索

形式

tmconfig

wtmconfig

機能説明

tmconfig は対話型プログラムであり、BEA Tuxedo アプリケーションの動作中に、コンフィギュレーション・ファイル・パラメータまたは MIB 属性の更新、および TUXCONFIG セクション部へのレコードの追加を行います。tmconfig は、追加、変更、または検索対象の入力フィールド値があるバッファを管理します。操作が完了すると、tmconfig は出力フィールド値と状態を表示します。ユーザは、利用可能なテキスト・エディタを使用して入力バッファを更新できます。

tmconfig は BEA Tuxedo ネイティブ・クライアント、wtmconfig はワークステーション・クライアントです。これについては、tmadmin/printclient コマンド・シーケンスの出力で確認できます。アプリケーションが SECURITY 機能を使用している場合、tmconfig は起動時にアプリケーション・パスワードの入力を求めるプロンプトを表示します。

注記 tmconfig は BEA Tuxedo ネイティブ・クライアントであり、wtmconfig はワークステーション・クライアントであるという以外に双方の違いはなく、wtmconfig と tmconfig は共に同じ機能を備えているため、このリファレンス・ページでは tmconfig を中心に説明していきます。ここで説明する機能は wtmconfig も備えていると考えてかまいません。

tmconfig は最初に、目的のセクションを指定するよう求め、続いてそれに対する操作の内容を指定するよう求めてきます。セクションを求めるプロンプトは次のとおりです。

Section:1) RESOURCES, 2) MACHINES, 3) GROUPS 4) SERVERS 5)SERVICES
6) NETWORK 7) ROUTING q) QUIT 9) WSL 10) NETGROUPS 11) NETMAP [1]:

プロンプト末尾の大括弧の中にはデフォルトのセクションが表示されます。

続いて、目的の操作内容を求めるプロンプトが次のように表示されます。

Operation: 1) FIRST 2) NEXT 3) RETRIEVE 4) ADD 5) UPDATE 
6) CLEAR BUFFER 7) QUIT [1]:

プロンプト末尾にデフォルトの操作内容が表示されます。デフォルトの操作を選択する場合は、Return キーを押します。ほかの操作を選択する場合は、該当する番号を入力して Return キーを押します。

現在、以下の操作がサポートされています。

次に tmconfig は、入力バッファを編集するかどうかを確認するプロンプトを表示します。

Enter editor to add/modify fields [n]?

ユーザが入力バッファの編集を完了すると、tmconfig はその内容を読み取ります。特定のフィールド名についての行が複数ある場合、最初のオカレンスが使用され、ほかのオカレンスは無視されます。何らかのエラーが発生すると、構文エラー・メッセージが表示され、tmconfig はその問題を訂正するかどうかをユーザに尋ねてきます。

Enter editor to correct?

問題を訂正しなかった場合には (上記プロンプトに対して n と応答した場合)、入力バッファには何もフィールドが入りません。問題を訂正する場合は、エディタが再度実行されます。

最後に、tmconfig は操作を完了させるかどうかを尋ねてきます。

Perform operation [y]?

操作が完了すると、tmconfig は次のように戻り値を表示し、Return value TAOK続いて出力バッファのフィールドを表示します。次に、プロセスが再開され、セクションを求めるプロンプトが表示されます。すべての出力バッファ・フィールドは、バッファがクリアされない限り、入力バッファ内で利用できます。

いつでもブレークを入力して、セクションを求めるプロンプトでの対話を再開できます。

QUIT を選択すると、tmconfig はコンフィギュレーション・ファイルのバックアップ (テキスト形式) を作成するかどうかを確認するプロンプトを表示します。

Unload TUXCONFIG file into ASCII backup [y]? 

バックアップの作成を選択すると、tmconfigはファイル名の入力を求めるプロンプトを表示します。

Backup filename [UBBCONFIG]?

無事にバックアップが完了すると、tmconfig バックアップ・コピーが作成されたことを示すメッセージを出します。失敗すれば、エラー・メッセージを出します。

入力形式

入力パケットは次のような形式の行で構成されます。

fldname fldval

フィールド名とフィールド値とは 1 つ以上のタブで区切ります。

長いフィールド値の場合、継続行に 1 つ以上のタブをつけることによって、次の行にまたがるようにすることができます (これらのタブは、tmconfig に読み戻されるときに取り除かれます)。

改行文字だけで構成される空の行は無視されます。

表示できない文字をフィールド値に入力したり、タブからフィールド値を開始するには、バックスラッシュを使用し、その後に希望する文字を 2 文字の 16 進表現で使用します (UNIX System リファレンス・マニュアルの ASCII(5) を参照してください)。たとえば、スペースは \20 と入力データに入力できます。バックスラッシュは 2 回書くことで 1 つのバックスラッシュを入力できます。tmconfig はこの形式で入力された文字をすべて認識しますが、16 進数形式を使用する最大の利点は表示不能文字を入力できることです。

制限事項

動的な再構成機能については、次のような一般的な制限事項があります。

TMCONFIG、UBBCONFIG、および MIBS 間の関係

システム 6 以降では、BEA Tuxedo のリソースをクラスや属性に再定義する BEA Tuxedo 管理情報ベース (MIB) が導入されました。MIB の導入と同時に、BEA Tuxedo システムは、管理者 (またはユーザ) がアプリケーションの属性にプログラムでアクセスし、変更することを可能にする管理 API も提供しました。

アトリビュートフィールドの更新時期と更新者

RESOURCES セクション

注意

このセクションについては、ADD 操作は使用できません。このセクションにはレコードが 1 つしかないので、RETRIEVE 操作は FIRST 操作と同じです (キー・フィールドは不要)。NEXT 操作は常に「レコードなし」が返されます。

TA_LDBAL、TA_CMTRET および TA_SYSTEM_ACCESS に対する変更は、それ以後ブートされる新しいクライアントとサーバに対してのみ適用されます。NO_OVERRIDE の指定があり、指定アクセス・タイプと一致しない (PROTECTED または FASTPATH) サーバ・エントリがある場合、TA_SYSTEM_ACCESS は変更できません。TA_NOTIFY と TA_AUTHSVC に対する変更は、それ以後起動される新しいクライアントに対してのみ適用されます。

上記のパラメータ以外の更新は、アンロードされたテキスト形式のバックアップ・ファイルには反映されません。

MACHINES セクション

注意

RESOURCES セクションの OPTIONS に "LAN" が指定されていないかぎり、マシンを追加することはできません。

上記のパラメータ以外の更新は、アンロードされたテキスト形式のバックアップ・ファイルには反映されません。

GROUPS セクション

SERVERS セクション

注意

*SERVERS セクションで変更されたパラメータは、次回、関連するサーバがブート (再開ではなく) された時点で有効になります。複数のサーバが MSSQ に定義されている場合 (TA_RQADDR)、これらのサーバでは同じサービスがブートされます。(たとえば、TA_CLOPT あるいは ENVFILE に対する変更は、それらが現在ブートされているサーバと一致しないよう、ブートされるサービスには影響しないようにしなければなりません。) TA_MAX に変更があった場合、そのサーバ・セットのサーバが 1 つあるいはそれ以上ブートされるまで、新しいサーバ識別子に対応する会話サーバは自動的には生成されません。

SERVICES セクション

注意

*SERVICES セクションでなされたパラメータの変更は、次回、そのサービスを提供するサーバがブートされる時点 (再開ではなく) で有効になります。TA_ROUTINGNAME の更新が可能なのは、TA_SRVGRP フィールドに値が指定されていない場合、またはそのフィールドにヌルが指定されている場合だけです。この場合、TA_ROUTINGNAME 属性は、一致するすべての SERVICES エントリで同時に更新されます。TA_ROUTINGNAME は SERVICES セクションの ROUTING に対応しています。

上記のパラメータ以外の更新は、アンロードされたテキスト形式のバックアップ・ファイルには反映されません。

NETWORK セクション

次の表に、*NETWORK セクションのフィールド一覧を示します。

関連する LMID がブートされている場合には、レコードを追加することはできません。

*RESOURCES セクションの OPTIONS に "LAN" がないかぎり、*NETWORKS セクションに対する操作は何もできません。

上記のパラメータ以外の更新は、アンロードされたテキスト形式のバックアップ・ファイルには反映されません。

ROUTING セクション

注意

*ROUTING セクションは、システムが稼働状態にあるときには更新したり追加したりすることはできません。掲示板のサイズを制御する、RESOURCES セクションの 3 つのパラメータ MAXDRT、MAXRFT、および MAXRTDATA が増加可能に設定されている場合、ROUTING セクションの新しいエントリを追加できます。

WSL セクション

注意

ワークステーション・リスナ・ サーバの CLOPT の更新は SERVER セクションを通して行うこともできますが、T_WSL クラスを使用してください。

NETGROUPS セクション

NETMAP セクション

セキュリティ

tmconfig は保護アプリケーションで実行する場合、そのアプリケーションを利用するときにアプリケーション・パスワードが必要とされます。標準入力が端末であると、tmconfig はユーザにパスワードの入力を求めてきます。ユーザが入力するパスワード文字列は画面には表示されません。標準入力が端末でない場合には、このパスワードは環境変数 APP_PW から取り出されます。この環境変数の指定がなく、アプリケーション・パスワードが必要とされる場合には、tmconfig は異常終了します。

ワークステーション・クライアント

/WS クライアントの場合、このコマンドは wtmconfig です。UPDATE および ADD コマンドはサポートされていません (TAEPERM が返されます)。

環境変数

tmconfig は環境変数 FIELDTBLS および FLDTBLDIR を設定しなおして、${TUXDIR}/udataobj/tpadmin フィールド・テーブルを取り出します。TUXDIR を正しく設定しておかなければなりません。

APP_PW は、標準入力が端末でない場合、保護アプリケーションのアプリケーション・パスワードに設定しなければなりません。

クライアントを BEA Tuxedo アプリケーションに結合する前に、いくつかの環境変数を設定しておく必要があります。

診断

tmconfig は、型付きバッファを割り当てることができない場合、該当ユーザに対する /etc/passwd エントリを判別できない場合、クライアント・プロセスになれない場合、入力バッファ編集用に /tmp に一時ファイルを作成できない場合、あるいは環境変数 FIELDTBLS または FLDTBLDIR を設定しなおすことができない場合には異常終了します。

各操作が完了した後、tmconfig から出力される戻り値には、要求された操作に関する状況が示されます。戻り値には 3 つのクラスがあります。

次の戻り値は、パーミッションに関する問題または BEA Tuxedo の通信エラーを示しています。戻り値は、操作が正常に完了しなかったことを示しています。

次の戻り値は、操作を行うこと自体の問題を示します。一般的には、入力バッファ内のアプリケーション・データに関するセマンティクスの問題です。文字列フィールド TA_STATUS が出力バッファに設定され、その問題を示します。また、文字列フィールド TA_BADFLDNAME が、その問題の原因となった値を収めているフィールドのフィールド名に設定されます (エラーが 1 つのフィールドに限定されると想定した場合)。

次の戻り値は、少なくとも MASTER サイトでは操作が成功したことを示します。

相互運用性

BEA Tuxedo システム・リリース 4.0 または 4.1 ノードが起動されている状態では、UPDATE および ADD 操作は実行できません。これらの操作を行うには、前もってこれらのノードをシャットダウンしておかなければなりません。リブートすると、変更内容が有効になります。

TMUNLOADCF の互換性

使用例

次に挙げる例では、tmconfig を使用して、ワークステーション・リスナ・サーバ上に指定されたネットワーク・アドレスを訂正しています。このアドレスはサーバ・セクションの最初のエントリになっていることがあります。この例で使用されているエディタは ed(1) です。

$ EDITOR=ed tmconfig

Section:1) RESOURCES, 2) MACHINES, 3) GROUPS 4) SERVERS 5)SERVICES
6) NETWORK 7) ROUTING q) QUIT 9) WSL 10) NETGROUPS 11) NETMAP [1]: 4
 
Operation: 1) FIRST 2) NEXT 3) RETRIEVE 4) ADD 5) UPDATE 
6) CLEAR BUFFER 7) QUIT [1]: 1
Enter editor to add/modify fields [n]? <return>
Perform operation [y]? <return>
Return value TAOK 
Buffer contents: 
TA_OPERATION    4 
TA_SECTION      3 
TA_SRVID        2 
TA_MIN          1 
TA_MAX          1 
TA_RQPERM       432 
TA_RPPERM       432 
TA_MAXGEN       1 
TA_GRACE        86400 
TA_STATUS       Operation completed successfully 
TA_SRVGRP       WDBG 
TA_SERVERNAME   WSL 
TA_CLOPT        -A -- -d/dev/tcp -M4 -m2 -x5 -n0x0002fe19c00b6d6b
TA_CONV         N 
TA_REPLYQ       N 
TA_RESTART      N 
Section:1) RESOURCES, 2) MACHINES, 3) GROUPS 4) SERVERS 5)SERVICES
6) NETWORK 7) ROUTING q) QUIT 9) WSL [4]10) NETGROUPS 11) NETMAP [4]: <return> 
Operation: 1) FIRST 2) NEXT 3) RETRIEVE 4) ADD 5) UPDATE 
6) CLEAR BUFFER 7) QUIT [1]: 5 
Enter editor to add/modify fields [n]? y 
240 
/CLOPT/s/6d6b/690E/p 
TA_CLOPT         -A -- -d/dev/tcp -M4 -m2 -x5 -n0x0002fe19c00b690E
w
240
q
Perform operation [y]? <return>
Return value TAUPDATED
Buffer contents: 
TA_OPERATION    1 
TA_SECTION      3 
TA_SRVID        2 
TA_MIN          1 
TA_MAX          1 
TA_RQPERM       432 
TA_RPPERM       432 
TA_MAXGEN       1 
TA_GRACE        86400 
TA_STATUS       Update completed successfully 
TA_SRVGRP       WDBG 
TA_SERVERNAME   WSL 
TA_CLOPT        -A -- -d/dev/tcp -M4 -m2 -x5 -n0x0002fe19c00b690E
TA_CONV         N 
TA_REPLYQ       N 
TA_RESTART      N 
Section:1) RESOURCES, 2) MACHINES, 3) GROUPS 4) SERVERS 5)SERVICES
6) NETWORK 7) ROUTING q) QUIT 9) WSL [1] 10) NETGROUPS 11) NETMAP {1}:q
Unload TUXCONFIG file into ASCII backup [y]? <return>
Backup filename [UBBCONFIG]? <return> 
Configuration backed up in UBBCONFIG 
$ # boot the changed server 
$ tmboot -s WSL -i 2

関連項目