管理接続ファクトリーのプロパティー (SAP)

アダプターは実行時に「管理接続ファクトリー」プロパティーを使用して、SAP サーバーでアウトバウンド接続インスタンスを作成します。

アダプター接続ウィザードを使用して、「管理接続ファクトリー」プロパティーを設定します。

以下の表では、「管理接続ファクトリー」プロパティーをリストおよび説明しています。 各プロパティーの詳しい説明は、表に続くセクションに記述されています。
表 1. 「管理接続ファクトリー」プロパティー、Adapter for SAP Software
プロパティー名 説明

ABAPDebug

ABAP デバッガー・プロパティー。

クライアント

アダプターが接続する SAP システムのクライアント番号。

コード・ページ番号

コード・ページの数値 ID を示します。

セキュア・ネットワーク接続を使用可能にする

セキュア・ネットワーク接続モードが使用されるかどうかを示します。

RFC トレース・ファイルのフォルダー

RFC トレース・ファイルの書き込み先のフォルダーへの完全修飾ローカル・パスを設定します。

ゲートウェイ・ホスト

SAP ゲートウェイのホスト名。

ゲートウェイ・サービス

RFC サービスを実行するゲートウェイ・ホスト上のゲートウェイ ID。

ホスト名

アダプターがログオンするアプリケーション・サーバー・ホストの IP アドレスまたは名前を指定します。

言語コード

アダプターが SAP にログオンする際の言語コードを指定します。

メッセージ・サーバー・ホスト

メッセージ・サーバーが稼働しているホストの名前を指定します。

パートナー文字セット

PartnerCharset エンコードを指定します。

パスワード

SAP アプリケーション・サーバー上のアダプターのユーザー・アカウントのパスワード。

RFC トレース・レベル

グローバル・トレース・レベルを指定します。

RFC トレースオン

各イベント・リスナーの RFC アクティビティーの詳細を示すテキスト・ファイルを生成するかどうかを指定します。

SAP システム ID

ログオン・ロード・バランシングが許可されている SAP システムのシステム ID を指定します。

セキュア・ネットワーク接続のライブラリー・パス

セキュア・ネットワーク接続サービスを提供するライブラリーへのパスを指定します。

セキュア・ネットワーク接続の名前

セキュア・ネットワーク接続の名前を指定します。

セキュア・ネットワーク接続パートナー

セキュア・ネットワーク接続パートナーの名前を指定します。

セキュア・ネットワーク接続のセキュリティー・レベル

セキュア・ネットワーク接続のセキュリティーのレベルを指定します。

システム番号

SAP アプリケーション・サーバーのシステム番号。

BAPI commit を呼び出す前の wait パラメーターの使用

WAIT パラメーターが BAPI_TRANSACTION_COMMIT で設定されるかどうかを指定します。

ユーザー名

SAP サーバー上のアダプターのユーザー・アカウント。

X509 証明書

ログオン・チケットとして使用される X509 証明書を指定します。

ABAP デバッグ

このプロパティーでは、アダプターがビジネス・オブジェクトの処理を開始する際に、適切な機能モジュールの ABAP デバッガーを呼び出すようにするかどうかを指定します。

表 2. ABAP デバッグの詳細
必須か いいえ
可能な値

True
False

デフォルト False
プロパティー・タイプ ブール
使用法 このプロパティーを True に設定した場合、アダプターはデバッグ・モードで SAP GUI を開きます。

デバッガーの使用許可を持っている必要があります。CPI-C ユーザー ID は SAP GUI セッションを開けないので、ダイアログ・ユーザー ID を作成してください。 デバッグ・モードで実行する許可と、デバッグされる ABAP コードが必要とする許可を持っている必要があります。 例えば、BAPI_CUSTOMER_CREATEFROMDATA1 をデバッグしている場合、カスタマーを作成する許可が必要です。

デバッガーを開いた後でのみ、ブレークポイントを追加できます。

実稼働環境では、 このプロパティーを常に False に設定します。

このプロパティーは Windows システム上でのみサポートされています。

グローバル化対応 いいえ
Bidi サポート いいえ

クライアント

このプロパティーは、アダプターが接続する SAP システムのクライアント番号です。

表 3. 「クライアント」の詳細
必須か はい
可能な値 000 から 999 までの範囲の値を入力できます。
デフォルト 100
プロパティー・タイプ 整数
使用法

アプリケーションが SAP サーバーにログオンしようとすると、アプリケーションはそれに関連付けられたクライアント番号を持つことを必要とします。 「クライアント」プロパティー値は、SAP サーバーへのログオンを試行するクライアント (アダプター) を識別します。

グローバル化対応 いいえ
Bidi サポート いいえ

コード・ページ番号 (Codepage)

コード・ページの数値 ID。

表 4. 「コード・ページ番号」の詳細
必須か いいえ
可能な値 0000 から 9999 までの範囲の値を入力できます。

SAP によりサポートされる言語および関連するコード・ページ番号の完全なリストについては、SAP Note 7360 を参照してください。

デフォルト このプロパティーのデフォルト値は、「言語コード」プロパティーに設定された値によって条件付きで決定されます。
プロパティー・タイプ 整数
使用法

「コード・ページ番号」に割り当てられた値は、使用されるコード・ページを定義し、「言語コード」プロパティーに設定された値との 1 対 1 の関係を持ちます。「コード・ページ番号」では、適切な言語への接続を確立します。

各言語コード値は、それと関連付けられたコード・ページ番号値を持ちます。例えば、英語の言語コードは EN です。 EN (英語) を言語コードとして選択する場合、コード・ページ番号は EN (英語) に関連付けられた数値に自動的に設定されます。EN (英語) の SAP コード・ページ番号は 1100 です。

例

「言語コード」が JA (日本語) に設定されている場合、 「コード・ページ番号」は 8000 に設定されます。

グローバル化対応 いいえ
Bidi サポート いいえ

セキュア・ネットワーク接続を使用可能にする (SncMode)

このプロパティーは、セキュア・ネットワーク接続モードが使用可能にされているかどうかを示します。

表 5. 「セキュア・ネットワーク接続を使用可能にする」の詳細
必須か いいえ
可能な値

0 (オフ)
1 (オン)

デフォルト 0
プロパティー・タイプ ストリング
使用法 セキュア・ネットワーク接続を使用する場合は、値を 1 (オン) に設定します。
グローバル化対応 いいえ
Bidi サポート いいえ

RFC トレース・ファイルのフォルダー (RfcTracePath)

このプロパティーは、RFC トレース・ファイルを書き込むフォルダーへの完全修飾ローカル・パスを設定します。

表 6. 「RFC トレース・ファイルのフォルダー」の詳細
必須か いいえ
デフォルト デフォルト値なし
プロパティー・タイプ ストリング
使用法 RFC トレース・ファイルの書き込み先の完全修飾ローカル・パスを識別します。

「RFC トレースオン」が False (選択されていない) に設定されている場合、「RFC トレース・ファイルのフォルダー」プロパティーに値を設定することは許可されません。

例 c:¥temp¥rfcTraceDir
グローバル化対応 はい
Bidi サポート いいえ

ゲートウェイ・ホスト (GatewayHost)

このプロパティーは、ゲートウェイ・ホスト名です。 ゲートウェイ・ホストの IP アドレスまたは名前のいずれかを入力します。ゲートウェイ・ホスト名についての情報は、SAP 管理者に問い合わせてください。

表 7. 「ゲートウェイ・ホスト」の詳細
必須か はい
デフォルト デフォルト値なし
プロパティー・タイプ ストリング
使用法

このプロパティーは、SAP ゲートウェイのホスト名です。 ゲートウェイによって、SAP システム上の作業プロセスと外部プログラムとの間の通信ができるようになります。

識別されたホストは、リソース・アダプターのゲートウェイとして使用されます。

最大長は 20 文字です。 コンピューター名が 20 文字よりも長い場合は、THOSTS 表内でシンボル名を定義します。

グローバル化対応 いいえ
Bidi サポート いいえ

ゲートウェイ・サービス (GatewayService)

このプロパティーは、RFC サービスを実行するゲートウェイ・ホスト上のゲートウェイ ID です。

表 8. 「ゲートウェイ・サービス」の詳細
必須か はい
デフォルト sapgw00
プロパティー・タイプ ストリング
使用法

これらのサービスによって、SAP サーバー上の作業プロセスと外部プログラムとの間の通信ができるようになります。 通常、サービスは sapgw00 の形式です (00 は SAP システム番号)。

最大 20 文字です。

グローバル化対応 いいえ
Bidi サポート いいえ

ホスト名 (ApplicationServerHost)

アダプターがログオンするアプリケーション・サーバー・ホストの IP アドレスまたは名前を指定します。

表 9. 「ホスト名」の詳細
必須か はい (ロード・バランシングが使用されない場合)
デフォルト デフォルト値なし
プロパティー・タイプ ストリング
使用法

アダプターがロード・バランシングなしで実行するよう構成された場合、このプロパティーでは、アダプターがログオンするアプリケーション・サーバーの IP アドレスまたは名前を指定します。

例 sapServer
グローバル化対応 いいえ
Bidi サポート いいえ

言語コード

このプロパティーでは、アダプターがログオンする言語コードを指定します。

表 10. 「言語コード」の詳細
必須か はい
可能な値

SAP によりサポートされる言語および関連するコード・ページ番号の完全なリストについては、SAP Note 7360 を参照してください。

デフォルト 「言語コード」プロパティーのデフォルト値は、システム・ロケールに基づきます。
プロパティー・タイプ ストリング
使用法

サポートされる各言語には、2 文字の言語コードが先頭に付されます。 言語そのものは、括弧に囲まれて表示されます。

言語コードを手動で入力する場合、言語を括弧で囲んで入力する必要はありません。

リスト表示されている言語コードは、非 Unicode システムとアラビア語用の、41 言語の SAP デフォルト・セットを表します。

選択した値により、「コード・ページ番号」プロパティーの値が決定されます。

例

システム・ロケールが英語の場合、このプロパティーの値は EN (英語) です。

グローバル化対応 いいえ
Bidi サポート いいえ

メッセージ・サーバー・ホスト (MessageServerHost)

このプロパティーは、メッセージ・サーバーが稼働しているホストの名前を指定します。

表 11. 「メッセージ・サーバー・ホスト」の詳細
必須か はい (ロード・バランシングが使用される場合)
デフォルト デフォルト値なし
プロパティー・タイプ ストリング
使用法

このプロパティーは、この SAP システムに属するすべてのサーバー (インスタンス) に、ロード・バランシング用に使用される他のサーバーの存在を伝えるホストの名前を指定します。

「メッセージ・サーバー・ホスト」には RFC クライアントのロード・バランシングに関する情報が含まれます。これによって、RFC クライアントを適当なアプリケーション・サーバーに送信することができます。

例 SAPERP05
グローバル化対応 いいえ
Bidi サポート いいえ

パートナー文字セット (PartnerCharset)

このプロパティーでは、パートナー文字セットのエンコード方式を指定します。

表 12. 「パートナー文字セット」の詳細
必須か いいえ
デフォルト

UTF-8

プロパティー・タイプ ストリング
使用法 エンコード方式を指定した場合、それが使用されます。指定しなかった場合は、デフォルトのエンコード方式が使用されます。
グローバル化対応 いいえ
Bidi サポート いいえ

パスワード

このプロパティーは、SAP アプリケーション・サーバー上のアダプターのユーザー・アカウントのパスワードです。

表 13. 「パスワード」の詳細
必須か はい
デフォルト デフォルト値なし
プロパティー・タイプ ストリング
使用法

SAP Web Application Server のバージョン別のパスワードの制約事項

  • バージョン 6.40 以前の SAP Web Application Server では、パスワードには以下の制限があります。
    • 大文字でなければならない
    • 長さは 8 文字でなければならない
  • バージョン 6.40 より後の SAP Web Application Server の場合、パスワードは以下のようになります。
    • 大/小文字の区別はない
    • 長さは 40 文字まで可能
グローバル化対応 いいえ
Bidi サポート はい

RFC トレース・レベル (RcfTraceLevel)

このプロパティーはグローバル・トレース・レベルを指定します。

表 14. 「RFC トレース・レベル」の詳細
必須か いいえ
可能な値

1 - これはデフォルトの RFC トレース・レベルです。指定すると、SAP JCo Java API ロギングが実行されます。
3 - 指定すると、SAP JCo JNI API ロギングが実行されます。
5 - 指定すると、エラー診断ロギングが実行されます。

デフォルト 1
プロパティー・タイプ 整数
使用法 「RFC トレースオン」が False (選択されていない) に設定されている場合、 「RFC トレース・レベル」プロパティーに値を設定することはできません。
グローバル化対応 いいえ
Bidi サポート いいえ

RFC トレースオン (RcfTraceOn)

このプロパティーでは、各イベント・リスナーの RFC アクティビティーを詳述するテキスト・ファイルを生成するかどうかを指定します。

表 15. 「RFC トレースオン」の詳細
必須か いいえ
可能な値

True
False

デフォルト False
プロパティー・タイプ ブール
使用法 値を True にすると、トレースがアクティブ化され、テキスト・ファイルが生成されます。

このファイルはアダプター処理が開始したディレクトリー内に作成されます。 このファイルの接頭部は rfx で、ファイル・タイプは trc (例えば、rfc03912_02220.trc) です。

こうしたテキスト・ファイルは開発環境内でのみ使用してください (ファイルが急速に大きくなるため)。

「RFC トレースオン」が False (選択されていない) に設定されている場合、「RFC トレース・ファイルのフォルダー」または「RFC トレース・レベル」プロパティーに値を設定することはできません。

例

このファイル内の情報の例としては、RfcCall FUNCTION BAPI_CUSTOMER_GETLIST (インターフェース内のパラメーターの情報が続く)、または RFC Info rfctable (インターフェース表の 1 つからのデータが続く) などがあります。

トレース・ファイルは、アダプター処理が開始したディレクトリー内に作成されます。 トレース・ファイルには .trc ファイル拡張子があり、ファイル名は文字 rfc で始まり、固有 ID が続きます。 例えば、rfc03912_02220.trc などです。

グローバル化対応 いいえ
Bidi サポート いいえ

SAP システム ID (SAPSystemID)

このプロパティーでは、ログオン・ロード・バランシングが許可されている SAP システムのシステム ID を指定します。

表 16. 「SAP システム ID」の詳細
必須か はい (ロード・バランシングが使用される場合)
デフォルト デフォルト値なし
プロパティー・タイプ ストリング
使用法 値は 3 文字でなければなりません
例 DYL
グローバル化対応 いいえ
Bidi サポート いいえ

セキュア・ネットワーク接続のライブラリー・パス (SncLib)

このプロパティーは、セキュア・ネットワーク接続サービスを提供するライブラリーへのパスを指定します。

表 17. 「セキュア・ネットワーク接続のライブラリー・パス」の詳細
必須か SncMode が 1 に設定されている場合は、必須。そうでない場合は、必須ではありません。
デフォルト デフォルト値なし
プロパティー・タイプ ストリング
使用法 SncMode プロパティーが 1 に設定されている (セキュア・ネットワーク接続を使用していることを示す) 場合、サービスを提供するライブラリーへのパスを指定します。
例 /WINDOWS/system32/gssapi32.dll
グローバル化対応 いいえ
Bidi サポート いいえ

セキュア・ネットワーク接続の名前 (SncMyname)

このプロパティーは、セキュア・ネットワーク接続の名前を指定します。

表 18. 「セキュア・ネットワーク接続の名前」の詳細
必須か SncMode が 1 に設定されている場合は、必須。そうでない場合は、必須ではありません。
デフォルト デフォルト値なし
プロパティー・タイプ ストリング
使用法 SncMode プロパティーが 1 に設定されている (セキュア・ネットワーク接続を使用していることを示す) 場合、その接続の名前を指定します。
例 DOMAINNAME/USERNAME
グローバル化対応 いいえ
Bidi サポート いいえ

セキュア・ネットワーク接続パートナー (SncPartnername)

このプロパティーは、セキュア・ネットワーク接続パートナーの名前を指定します。

表 19. 「セキュア・ネットワーク接続パートナー」の詳細
必須か SncMode が 1 に設定されている場合は、必須。そうでない場合は、必須ではありません。
デフォルト デフォルト値なし
プロパティー・タイプ ストリング
使用法 SncMode プロパティーが 1 に設定されている (セキュア・ネットワーク接続を使用していることを示す) 場合、その接続パートナーの名前を指定します。
例 CN=sap00.saperpdev, OU=Adapter, O=IBM, C=US
グローバル化対応 いいえ
Bidi サポート いいえ

セキュア・ネットワーク接続のセキュリティー・レベル (SncQop)

このプロパティーは、セキュア・ネットワーク接続のセキュリティーのレベルを指定します。

表 20. 「セキュア・ネットワーク接続のセキュリティー・レベル」の詳細
必須か SncMode が 1 に設定されている場合は、必須。そうでない場合は、必須ではありません。
可能な値
  • 1 (認証のみ)
  • 2 (保全性の保護)
  • 3 (プライバシー保護)
  • 8 (アプリケーション・サーバー上の snc/data_protection/use にある値を使用)
  • 9 (アプリケーション・サーバー上の snc/data_protection/max にある値を使用)
デフォルト 3 (プライバシー保護)
プロパティー・タイプ ストリング
使用法 SncMode プロパティーが 1 に設定されている (セキュア・ネットワーク接続を使用していることを示す) 場合、その接続のセキュリティー・レベルを示す値を指定します。
グローバル化対応 いいえ
Bidi サポート いいえ

システム番号 (SystemNumber)

このプロパティーは、SAP アプリケーション・サーバーのシステム番号です。

表 21. 「システム番号」の詳細
必須か はい
可能な値 00 から 99 までの範囲の値を入力できます。
デフォルト 00
プロパティー・タイプ 整数
使用法

システム番号はさらに、ゲートウェイ・サービスを識別します。

グローバル化対応 いいえ
Bidi サポート いいえ

BAPI commit を呼び出す前の wait パラメーターの使用

このプロパティーは、アダプターが WAIT パラメーターを設定して BAPI_TRANSACTION_COMMIT を呼び出すかどうかを示します。

表 22. BAPI commit を呼び出す前の wait パラメーターの使用
必須か いいえ
可能な値

True
False

デフォルト False
プロパティー・タイプ ブール
使用法 このプロパティーは、BAPI アウトバウンド同期 RFC 処理にのみ適用されます。

このプロパティーを True に設定すると、Adapter for SAP Software は WAIT パラメーターを設定して BAPI_TRANSACTION_COMMIT を呼び出して、更新が SAP で完了している場合のみ他のリソース・マネージャーがコミットされるようにします。

デフォルト値 False を受け入れると、更新が SAP で完了する前にメッセージ・フローの処理が続行することがあります。 そのため、BAPI を呼び出した後、次にシステムにアクセスするときに更新データが使用できない可能性があります。

グローバル化対応 いいえ
Bidi サポート いいえ

ユーザー名 (userName)

このプロパティーは、SAP サーバー上のアダプターのユーザー・アカウントです。

表 23. 「ユーザー名」の詳細
必須か はい
デフォルト デフォルト値なし
プロパティー・タイプ ストリング
使用法 最大長は 12 文字です。 ユーザー名は大/小文字の区別をしません。

SAP アプリケーションで CPIC ユーザー・アカウントをセットアップし、アダプターによりサポートされるビジネス・オブジェクトが必要とするデータを操作するための必要な特権をこのアカウントに付与することが推奨されています。 例えば、アダプターが特定の SAP ビジネス・トランザクションを実行する必要がある場合、SAP アプリケーション内のアダプターのアカウントは、それらのトランザクションを実行できるようにするための許可セットを持つ必要があります。

例 SapUser
グローバル化対応 はい
Bidi サポート はい

X509 証明書 (X509cert)

このプロパティーは、ログオン・チケットとして使用される X509 証明書を指定します。

表 24. 「X509 証明書」の詳細
必須か いいえ
デフォルト デフォルト値なし
プロパティー・タイプ ストリング
使用法 SncMode プロパティーが 1 に設定されている (セキュア・ネットワーク接続を使用していることを示す) 場合、X509 証明書の値を指定できます。
グローバル化対応 いいえ
Bidi サポート いいえ
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
最終更新

        最終更新 : 2012-07-13 15:46:37


参照トピック参照トピック | バージョン 8.0.0.1 | rbp_sap_j2c_conn_fact_props