JSLのコマンド行オプション

サーバー側では、コマンド行からの情報の取得が必要な場合があります。CLOPTパラメータを使用すると、コマンド行オプションを指定して、サーバーに設定されたデフォルト値を変更できます。JSLコマンド行のオプションを次の表で説明します。

表3-1 JSLのコマンド行オプション

オプション	説明
[-a]	Jolt接続プールのセキュリティ・コンテキストを有効または無効にします。WebLogic ServerとJoltの間で認証の伝播を実装する場合は、このオプションを有効にしてください。IDの伝播を実装するには、このオプションを設定してJoltサービス・ハンドラ(JSH)を起動する必要があります。-aオプションを設定しないと、SecurityContextが有効の場合、JSHはこのリクエストを受け付けません。SecurityContext属性が有効の場合、Joltクライアントは呼出し側のユーザー名をJSHに渡します。 JSHは、呼出し側のIDが付いたメッセージを取得すると、impersonate_user()を呼び出してそのユーザーのappkeyを取得します。JSHはappkeyをキャッシュし、呼出し側が次にリクエストしたときに、appkeyをキャッシュから取り出してリクエストがサーバーに転送されるようにします。キャッシュはJSHごとに維持されます。つまり、同じJSHに接続されたすべてのセッション・プールに対して1つのキャッシュが維持されます。
[-A]	リモート・アプリケーションからSSL接続を受け付けるときに証明書ベースの認証が必要になるかどうかを指定します。 ノート: JSL -AオプションはISL(5)およびWSL(5)の-aオプションと同等です。詳細は、セクション5「ファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス」を参照してください。
[-c compression_threshold]	JoltクライアントとJoltサーバー(JSH)の間で送受信されるアプリケーション・データがネットワーク上で転送されるときに、圧縮されるようにします。 compression_threshold には、バイト数(0 - 2,147,483,647)を指定します。指定されたしきい値を超えるメッセージは、転送前に圧縮されます。 デフォルトでは圧縮は行われません。つまり、圧縮のしきい値が指定されていないため、Oracle Joltによるクライアントまたはサーバー上のメッセージの圧縮は行われません。
[-d device_name]	トランスポート層インタフェースを使用するプラットフォームのデバイスを指定します。デフォルトはありません必須です。(ただし、ソケットの場合は省略可能)
[-H external netaddr]	ネットワーク・アドレスの変換が行われる場合に、Joltクライアントがアプリケーションに接続するために使用するネットワーク・アドレス・マスクを指定します。JSLプロセスでは、このアドレスを使用して、このアドレスで接続しようとするクライアントをリスニングします。外部アドレス・マスクが0x0002MMMMddddddddで、JSHのネットワーク・アドレスが0x00021111ffffffffの場合、結果(外部)のネットワーク・アドレスは0x00021111ddddddddになります。先頭に「//」が付いたネットワーク・アドレスは、IPベースであることを示し、JSHネットワーク・アドレスからTCP/IPポート番号がコピーされて、新しいネットワーク・アドレスを構成します。 外部IPアドレス・マスクは、次の形式で指定されます: -H //external ip address:MMMM (Oracle TuxedoのJSLでは省略可能) ノート: このオプションではIPv6はサポートされません。
[-I init-timeout]	JoltクライアントがJ、JSLによるタイムアウトが発生する前に、SHを介して初期化を完了するまでの時間(秒単位)。デフォルトは60秒です。(オプション)
[-j connection_mode]	接続モードの種類は次のとおりです。 RETAINED セッションの全期間、ネットワーク接続は保持されます。 RECONNECT クライアントが接続を確立した後でアイドル状態が続き、タイムアウトが発生したために接続が切断された場合に、複数のリクエストを受け取るとセッション中に再接続を行います。 ANY サーバーは、クライアントがRETAINEDまたはRECONNECTの接続をセッションで確立することを許可します。 デフォルトはANYです。つまり、オプションが何も指定されていない場合、サーバーはクライアントがRETAINEDまたはRECONNECTの接続を要求することを許可する(オプション)
[-K {client | handler | both | none}]	-Kオプションは、client、handler、またはbothに対してネットワークkeep-alive機能をオンにできます。noneを指定すると、clientとhandlerの両方に対してこの機能をオフにできます。
[-m minh]	一度にJSLと共に利用できるJSHの最小数を指定します。このパラメータに指定できる値の範囲は0 - 255。デフォルトは0です。(オプション)
[-M maxh]	一度にJSLと共に利用できるJSHの最大数を指定します。このオプションを指定しない場合、このパラメータにはデフォルト値として、MAXWSCLIENTSを-x多重係数(小数点以下切上げ)で割った値が指定されます。オプションを指定する場合、-Mオプションには1から32,767の値をとります。(オプション)
[-n netaddr]	Oracle TuxedoおよびWebLogicサーバーでOracle Joltリスナーによって使用されるネットワーク・アドレス。 TCP/IPアドレスは、次のいずれかの形式で指定されます。 IPv4 //IP:port //hostname:port_number //#.#.#.#:port_number ドメインはローカル名を解決する手法(通常はDNS)を使用して hostname のアドレスを検索します。 hostname にはローカル・マシン名を指定し、ローカル名の解決機能でローカル・マシンのアドレスに明確に解決されなければなりません “#.#.#.#”にはドット区切りの10進数を指定します。ドット区切りの10進数形式では、それぞれの#に0から255の数字を指定します。このドット区切りの10進数は、ローカル・マシンのIPアドレスを表します。どちらの形式の場合も、port_numberにはドメイン・プロセスが接続リクエストの受信をリスニングするTCPポート番号を指定する。port_numberには、0 - 65535までの数字または名前を指定する。 IPv6 //[IPv6 address]:port //hostname:port_number ノート: IPv6は16進数形式をサポートしません。 SDP sdp://IB_IP:port
[-R renegotiation-interval]	ネゴシエーションを行う間隔を分単位で指定します。SSLおよびTLS標準に規定されているとおり、特定のSSLセッションでSSL暗号化パラメータの再ネゴシエーションを行わずに指定された分数が経過した後で、次にデータを交換するときにSSL暗号化パラメータの再ネゴシエーションが行われます。デフォルトは0で、セッションのネゴシエーションは定期的には行われません。 ノート: -Rパラメータを指定して、-Sパラメータを指定しないか0に設定した場合、JSLはユーザー・ログに警告メッセージを送信します。
[-S Client-timeout]	アイドル時間(分単位)。クライアントに処理中のリクエストがない状態の時間です。つまり、クライアントが「居眠り中」の時間です。 このオプションは、-Tオプションと一緒に使用できません。いずれかのタイムアウトに達すると、JSHによってセッションが閉じられます。 パラメータを指定しないと、デフォルトではタイムアウトの指定なしになる(オプション)
[-s secure-port]	SSLプロトコルを使用した安全な接続の受け付けにJSLが使用するポート番号を指定します。JSLで安全な接続のみを使用するように構成するには、-sオプションで指定するポート番号に同じ値を設定します。 JRLYおよびJRADプロセスが使用される場合、このオプションは使用できません。 JSL -sオプションはISL(5)およびWSL(5)の-Sオプションと同等です。詳細は、セクション5「ファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス」を参照してください。
[-T Client-timeout]	クライアントがアイドル状態でいられる期間(分単位)を指定します。ここで指定した期間内にクライアントからリクエストが発行されないと、JSHによりクライアントの接続は切断され、セッションは終了します。引数が指定されていない場合、セッションでタイムアウトは発生しません。 -j ANYオプションまたは-j RECONNECTオプションを使用する場合は、常に-Tでアイドル・タイムアウト値を指定します。-Tが指定されず、接続が一時停止になっている場合、JSHが自動的にセッションを終了することはありません。クライアントがセッションを異常終了すると、セッションは完全に終了しません。 パラメータを指定しないと、デフォルトではタイムアウトの指定なしになる(オプション)
[-w JSH]	このコマンド行オプションは、Joltサーバー・ハンドラを示します。デフォルトはJSHです。(オプション)
[-x mpx-factor]	1つのJSHで扱えるクライアントの数を指定します。このパラメータを使用して、各JSHプロセスでの多重化のレベルを制御します。UNIXおよびWindows 2003の場合、このパラメータには1 - 32767の範囲の値を指定できます。デフォルト値は10です。(オプション)
[-z 0|56|128|256]	JoltクライアントとJSHの間でネットワーク接続を確立する際に必要な最小レベルの暗号化を指定します。0は暗号化が行われないことを示し、56、128および256は暗号化キーの長さ(ビット単位)を指定します。この最小レベルの暗号化が満たされない場合、接続は確立されません。
[-Z 0|56|128|256]	JoltクライアントとJSHの間にネットワーク・リンクが確立されている場合、このオプションを使用して特定のレベルまでの暗号化を行うことができます。初期値の0は、DHノードの暗号化もRC4形式の暗号化も行わないことを示します。56、128、および256は、暗号化キーの長さ(ビット単位)を示します。キーを生成するには、SSLまたはDHキー交換のいずれかが必要です。セッション・キーは、ネットワーク経由で転送されません。デフォルト値は0です。 ノート: 0ビットの最大暗号化レベルは、-s SSL接続オプションと互換性がありません。