![]() ![]() ![]() ![]() ![]() ![]() |
Oracle Service Architecture Leveraging Tuxedo (SALT)コマンド・リファレンスには、SALTソフトウェアで提供されるシステム処理とコマンドについて記載されています。
表1に、Oracle Service Architecture Leveraging Tuxedoのコマンドと関数を示します。
GWWS SRVGRP="identifier" SRVID=number [other_parms]
CLOPT="-A -- – i InstanceID [-a <scheme>://<host>:<port>]"
GWWSサーバーは、TuxedoアプリケーションのWebサービス・ゲートウェイで、SALTのコア・コンポーネントです。GWWSゲートウェイ・サーバーは、SOAP 1.1/1.2プロトコルを通じてWebサービス・プログラムとの通信を提供します。GWWSサーバーでは、双方向(着信または発信)の機能があります。Webサービス・アプリケーションからSOAPリクエストを受け付けて、Tuxedoネイティブ・コールをTuxedoサービス(着信)に渡します。また、Tuxedo ATMIリクエストを受け付けて、SOAPコールをWebサービス・アプリケーション(発信)に渡します。GWWS
サーバーは、Tuxedoシステム・プロセスとして使用され、UBBCONFIG
ファイルの*SERVERS
セクションに記述されています。
CLOPT
オプションは、コマンドライン・オプションの文字列で、起動時にGWWS
サーバーに渡されます。GWWS
サーバーは次のCLOPT
オプションを受け付けます。
-i InstanceID
GWWS
インスタンスの一意のIDを指定します。同じTuxedoドメインの複数のGWWS
インスタンスを識別するために使用されます。この値は、UBBCONFIG
ファイル内の複数のGWWS
項目の間で一意である必要があります。 注意: | InstanceID の値は、SALTデプロイメント・ファイルの<WSGateway> セクションであらかじめ定義する必要があります。 |
-a <scheme>://<host>:<port>
UBBCONFIG
ファイルで-a
オプションを使用して構成する必要があります。-a <scheme>://<host>:<port>
注意: | 次のURLを使用して、Web管理コンソールにアクセスします。<scheme>://<host>:<port>/admin |
環境変数SALTCONFIG
は、GWWSサーバーを起動する前に設定する必要があります。 Accesslog(5)
は、環境変数
TMENABLEALOG=y
を設定することで有効にできます。
注意: | %TUXDIR%\bin\ssllibs をPATH に追加します。 |
次のSALT 1.1 GWWSパラメータは現在のリリースでは非推奨になっています。
-c Config_file
注意: | SALT 2.0リリース以降では、GWWS サーバーはXMLベース構成ファイルではなくバイナリSALTCONFIGファイルからSALT構成をロードします。構成ファイルはGWWS入力パラメータではなくなりました。GWWSサーバーを起動する前に、 wsloadcf を使用してSALTCONFIGファイルを生成する必要があります。 |
発信呼出しについては、SOAPメッセージの処理中に発生したエラーはログに記録されます。エラーは、適切なSOAPエラー・コードまたはHTTPエラー・ステータス・コードに変換されてWebサービス・クライアントに返されます。
発信呼出しについては、処理中に発生したエラーはログに記録されます。エラーは、適切なTuxedoシステム・エラー・コード(tperrno
)に変換されてTuxedoクライアントに返されます。
GWWS SRVGRP=GROUP1 SRVID=10
CLOPT="-A -- – i GW1"
GWWS SRVGRP=GROUP1 SRVID=11
CLOPT="-A -- – i GW2"
GWWS SRVGRP=GROUP2 SRVID=20
CLOPT="-A -- – i GW3"
「Oracle SALT Webサービス定義ファイルのリファレンス」
tmscd(1)
– サービス規約検索を有効または無効にします。
tmscd start|stop|status [-e] [-f <file>][id1 [ id2 [ ...]]]
tmscd
コマンドライン・ユーティリティを使用すると、サービス規約検索を有効または無効にできます。
tmscdでは、次のパラメータとオプションがサポートされます。
start|stop|status
start
またはstop
を要求しても無視されます。リクエストの処理中には、有用なサービス情報が表示されます。 注意: | -e または-f オプションを指定する場合は、その後にstart|stop|status を指定する必要があります。 |
[-e]
[-f <file>]
<file>
内に定義されます。このファイルには、関連する定義をまとめたセクションが含まれている場合もあります。セクションのすべてのエントリは、1行ずつ記述する必要があります。
id1 id2 ...
サンプル1 - TOUPPER
、TOLOWER
の検索を開始します。
tmscd start TOUPPER TOLOWER
サンプル2 - TO
およびBR
で始まるサービスの検索を開始します。
tmscd -e start TO.* BR.*
サンプル3 - サンプル1と同じリクエストをファイルを使って行います。
tmscd -f svcfile start id1 id2
注意: | セクションが指定されていない場合は、最初に見つかった定義が使用されます。 |
サンプル4 - サンプル2と同じリクエストをファイルを使って行います。
tmscd -e -f svcfile start case4.svcs
コード・リスト 2に、「svcfile」
という名前のファイルの内容を示します。
# file: svcfile
*case3
id1 = TOUPPER
id2 = TOLOWER
*case4
svcs = TO.*|BR.*
TMMETADATAが起動していないか、-r
(読取り専用)オプションを指定し-o
オプションを指定しない状態で起動されていない場合は、tmscd
でエラーが発生します。
Oracle Service Architecture Leveraging Tuxedo構成ガイドのサービス・コントラクトの検出の構成
「Oracle SALT Webサービス定義ファイルのリファレンス」
tmwsdlgen
- WSDLドキュメント・ジェネレータです。
tmwsdlgen – c wsdf_file [-y] [-o wsdl_file] [-m {pack|raw|mtom}] [-t
{wls|axis}]
tmwsdlgen
は、TuxedoネイティブWebサービス定義ファイル(WSDF)からWSDLドキュメント・ファイルを生成します。生成されたWSDLドキュメントは、WSDL 1.1の仕様に準拠し、サービス契約とポリシーの両方を表現します。tmwsdlgen
はTuxedoサービス・メタデータ・リポジトリ管理の処理(TMMETADATA)中にTuxedoサービス情報を集めます。tmwsdlgen
はTuxedoネイティブ・クライアントとして動作し、次の設定を行う必要があります。
警告: | 指定したWSDFはTuxedoネイティブWSDFである必要があります。wsdlcvt で変換された非ネイティブのWSDFファイルを入力に使用しないでください。 |
-c wsdf_file
tmwsdlgen
には次の省略可能なパラメータを指定できます。
-o wsdl_file
tuxedo.wsdl
のデフォルトのファイルがカレント・ディレクトリに作成されます。指定したWSDL文書ファイルがすでに存在する場合は、既存のファイルを上書きするかどうかを確認するメッセージが表示されます。
-y
-m
raw
モードを指定した場合は、CARRAYがMIME添付ファイルで表現されます。pack
モードを指定した場合は、CARRAYの表現にxsd:base64Binary
が使用されます。デフォルト値はpack
モードです。 注意: | raw モードは.Netクライアントに使用できません。.Net FrameworkはMIME添付ファイルをサポートしていないからです。 |
次のSALT 1.1 GWWSパラメータは現在のリリースでは非推奨になっています。
-c Config_file
-s
-v
注意: | 現在のSALTリリースには、SOAPのバージョンおよびメッセージ・スタイルの属性がSALT WSDF内で指定されています。 |
指定したWSDF内で構文エラーが検出した場合、標準エラーの問題であることを示す「ERROR」または「FATAL」メッセージを表示したり、WSDLファイルを生成したりせずに、終了コード「1」でtmwsdlgen
を終了します。
実行に成功した時、tmwsdlgen
は終了コード「0」で終了します。
次のコマンドを実行すると、指定したSALT WSDFのtux.wsdf
からWSDLドキュメント・ファイルのSalt.wsdlが生成されます。
tmwsdlgen – c tux.wsdf – o Salt.wsdl
次のコマンドを実行すると、指定したSALT WSDFのapp_wsdf.xml
からのSOAP w/添付の機能でデフォルトのWSDLドキュメント・ファイルが生成されます。
tmwsdlgen – c app_wsdf.xml – m raw
「Oracle SALT Webサービス定義ファイルのリファレンス」
wsadmin
: SALT管理コマンド・インタープリタです。
wsadmin [-v]
wsadmin
は、特定のコマンドを使用して、指定したTuxedoドメイン内のアクティブなGWWSプロセスのモニターと管理を行います。TUXCONFIG環境変数は、Tuxedo構成ファイルがロードされた場所を決定します。wsadminはtmadmin(1)またはdmadmin(1)と同じように使用されます。
-v
コマンドは、完全な名前または省略形(かっこ内に示す形式)で入力できます。その後に適切な引数を指定します。角かっこ[ ]で囲まれた引数は省略可能です。中かっこ{}で囲まれた引数は、その中から1つだけオプションを選択できることを示します。
注意: | 角かっこで囲まれていないコマンドライン・オプションは、そのデフォルト値がdefaultコマンドで設定されている場合は指定する必要がありません。 |
configstats(cstat) -i gwws_instance_id
default(d) [-i gwws_instance_id]
*
を指定すると、デフォルト値を変更できます。引数を指定しないでdefaultコマンドを入力した場合は、現在のデフォルト値が出力されます。
tran_id
またはcoord_context
コーディネーション・コンテキストを指定すると、そのトランザクションのヒューリスティックなログ・レコードのみが削除されます。コーディネーション・コンテキスト(coord_context
)は、printtrans
コマンドまたはULOGファイルから取得できます。
help (h) [command]
gwstats(gws) -i gwws_instance_id [-s serviceName]
serviceName
を指定すると、サービスレベル情報が表示されます。
paginate(page) [{off | on}]
pg
です。シェル環境変数のPAGERを使用すると、デフォルトのページ単位表示出力に使用するコマンドをオーバーライドできます。
quit (q)
saml create [-p password]
saml add {-g -s shared_secret |-i -n issuer_name [ -l issuer_local_id]{[-c] [-s shared_secret]}} [-p password]
saml modify {-g -s shared_secret |-i {[-n issuer_name ][ -l issuer_local_id]}{[-c][-s shared_secret]} [-p password]
verbose (v) [{off | on}]
! shellcommand
! !
# [text]
<CR>
wsadmin
> gws -i GW2GWWS Instance : GW2
Inboud Statistics :
---------------------------------
Request Response Succ : 3359
Request Response Fail : 0
Oneway Succ : 0
Oneway Fail : 0
Total Succ : 3359
Total Fail : 0
Avg. Processing Time : 192.746 (ms)
---------------------------------
Outboud Statistics :
---------------------------------
Request Response Succ : 4129
Request Response Fail : 0
Oneway Succ : 0
Oneway Fail : 0
Total Succ : 4129
Total Fail : 0
Avg. Processing Time : 546.497 (ms)
-----------------------------------
Total request Pending : 36
Outbound request Pending : 0
Active Thread Number : 141
ToUpperWS
サービスの実行時の統計が調べられ、出力が冗長モードで表示されます。wsadmin
> > verbose
Verbose now on.
> gws -i GW1 -s ToUpperWS
GWWS Instance : GW1
Service : ToUpperWS
Outboud Statistics :
----------------------------------
Oneway Succ : 0
Oneway Fail : 0
---------------------------------
Avg. Processing Time : 0.000 (ms)
wsdlcvt -i WSDL_URL -o output_basename [-m] [-v] [-y] [-w][-sh] [-sp]
wsdlcvtは既存のWSDL 1.1ドキュメントをメタデータ入力ファイル、FML32マッピング・ファイルおよびSALT Webサービス定義ファイル(WSDF)に変換します。Xalanのwsdl2mif.xsl
、wsdl2fml32*.xsl
およびwsdl2wsdf.xsl
のラッパー・スクリプトです。SALT製品には、Apache Xalan 2.7ライブラリがバンドルされています。
wsdlcvt
を実行するには、JRE 1.5以上が必要です。
-i
-o
wsdlcvt
には、次のパラメータを指定できます。
-y
-m
-v
-w
wsdl:import
が含まれる場合、wsdlcvtが正しく処理できるようにこのパラメータを指定します。
-
sh
-sp
TUXDIRおよびLANG環境変数を正しく設定する必要があります。
「java」を実行するには、PATH
環境変数を正しく設定する必要があります。
次のコマンドを実行すると、ローカルのWSDLファイルのsample.wsdl
ファイルが変換されます。
wsdlcvt -i sample.wsdl -o sample
次のコマンドを実行すると、HTTP URLリンクからWSDLドキュメントが変換されます。「xsd:string」データ型はTuxedo FLD_MBSTRINGフィールド型に対応します。
wsdlcvt -i http://api.google.com/GoogleSearch.wsdl -o GSearch -m
Oracle Tuxedoサービス・メタデータ・リポジトリの作成
「Oracle SALT Webサービス定義ファイルのリファレンス」
wsloadcf
– SALTデプロイメント・ファイルなどの参照アーティファクトを読み込みます。バイナリSALTCONFIGファイルをロードします。
Usage 1: wsloadcf [-n][-y][-D loglevel] saltdeploy_file
Usage 2: wsloadcf [-n][-y][-D loglevel] -1 [-s rpc|doc]
[-v 1.1|1.2] salt_1.1_config
wsloadcfはSALTデプロイメント・ファイル、他の参照したファイル(WSDFファイル、WS-Policyファイル)を読んだり、構文をチェックしたり、必要に応じてバイナリ・ファイルのSALTCONFIG
をロードしたりします。SALTCONFIG
環境変数は、情報を格納する必要があるSALTCONFIG
ファイルを指します。生成したSALTCONFIGファイルは、GWWS
サーバーを起動する時に必要となります。
wsloadcfには次の省略可能なパラメータを指定できます。
-n
-y
tmloadcf
は、(a) SALTCONFIG
が参照したファイルは存在しているか、(b) Oracle Tuxedoシステムの有効なファイル・システムであるか、(c) SALTCONFIG
表を含まれているかなどを確認します。上記の条件がtrueでない場合、wsloadcf
は、SALTCONFIG
を作成し初期化するコマンドを実行する必要があるかを示すメッセージを表示します。 コマンドラインで「-y」を指定すると、Initialize SALTCONFIG file: path [y, q]?
のメッセージが表示されません。
-D
SALT 1.1の後方互換性については、wsloadcfはSALT 1.1の構成ファイルを読むことができます。SALTCONFIGバイナリ・ファイルの生成に加えて、wsloadcf
は、指定したSALT 1.1構成ファイルに従ってSALT Webサービス定義ファイル(WSDF)を1つとSALTデプロイメント・ファイルを1つ生成します。
-1
wsloadcfを実行する前にSALTCONFIG環境変数を設定する必要があります。
指定した構成ファイル内で構文エラーが検出した場合、コンソールの問題であることを示す「ERROR」または「FATAL」メッセージを表示したりSALTCONFIG
ファイルを更新したりせずに、終了コード「1」でwsloadcf
を終了します。
(1)構成ファイルが実行時の潜在的なリスクとなる場合、および(2)構成ファイル内で値を指定しなかったためデフォルトの値が使用された場合は、コンソールに「警告」メッセージが表示されます。「警告」メッセージが表示されても、wsloadcf
の実行は中断されません。
実行に成功した時、wsloadcf
は終了コード「0」で終了します。SALTCONFIG
ファイルを更新した場合、ユーザーのログ・メッセージが生成されます。
「Oracle SALT Webサービス定義ファイルのリファレンス」
wsunloadcf
: SALTCONFIG
バイナリ・ファイルを読み込み、SALTデプロイメント・ファイルやその他の参照ファイル(WSDFファイル、WS-Policyファイル)を作成します。
Usage: wsunloadcf
wsloadcfは、SALTCONFIGファイルやその他の参照ファイル(WSDFファイル、WS-Policyファイル)を読み込みます。SALTCONFIG
環境変数は、情報を格納する必要があるSALTCONFIG
ファイルを指します。
wsunloadcf
を実行する前にSALTCONFIG
環境変数を設定する必要があります。
「Oracle SALT Webサービス定義ファイルのリファレンス」
![]() ![]() ![]() |