Page History
[ 
|../../index.htm#lansa/define_any_server.htm]
現在地:
| Anchor | ||||
|---|---|---|---|---|
|
注意: 9.1 組み込み関数の規則 &<a href="bifcat3_01.htm"&>利用オプション&</a&>利用オプション
サーバーとして使用するためのLANSAシステムの詳細を定義します。
定義の詳細は、永続的なものではなく、LANSA環境がアクティブな間だけ存続します。
サーバーを定義するのにかかる時間は、ほんのわずかです。
プラットフォームについて
...
番号 | タイプ | 必須/ 任意 | 記述 | 最小長 | 最大長 | 最小小数桁数 | 最大小数桁数 |
1 | A | 必須 | SSN (サーバーの別名)。これは、今後のこのサーバーへのすべての参照でこのファンクションおよび他のRDMLファンクションが使用する名前です。 | 1 | 10 |
| 0 |
2 | A | 必須 | LU パートナー名 | 1 | 20 |
| 0 |
3 | A | 必須 | 非 IBM i サーバーでは無視 (常にY) Y または 1：サーバー上でコミットメント制御を開始する。このサーバーの接続が完了すると、クライアントからRDMLレベルのCOMMITまたは ROLLBACKコマンドが発行されるたびに、"commit" または "rollback" 要求を受け取ります。 その他：コミットメント制御を使用しない | 1 | 1 |
|
|
4 | A | 任意 | X_RUN 例外引数 | 1 | 256 |
| 0 |
5 | A | 任意 | LOCK_OBJECT 要求をこのサーバーに転送します。このオプションを使用する場合は、後続するすべてのLOCK_OBJECT要求がこのサーバーに転送されます。複数のサーバーが同時このオプションを使用可能に設定している場合、各サーバーとも同じLOCK_OBJECT要求を受け取ります。 | 1 | 1 |
| 0 |
6 | A | 任意 | 接続待ちの間に「しばらくお待ちください」というメッセージを表示します。 Yまたは1：上記メッセージを表示する その他：メッセージを表示しない デフォルトはYです。 | 1 | 1 |
| 0 |
7 | A | 任意 | IBM i以外のサーバーでは無視 実行優先順位。デフォルトは20です。他の値は、IBM iのCHGJOBコマンドのRUNPTYパラメータで指定してください。指定された値を変更する権限がユーザーに許可されている必要があります。 | 1 | 2 |
|
|
8 | A | 任意 | IBM i以外のサーバーでは無視 クライアントからサーバーへの変換テーブル名。ライブラリ名は指定できません。デフォルトは*JOBで、この場合、IBM iサーバーのジョブのCCSIDとクライアント・コード・ページに基づいて変換テーブルが生成されます。 この引数が*JOBの場合、サーバーからクライアントへの変換テーブルも*JOBである必要があります。 | 1 | 10 |
| 0 |
9 | A | 任意 | IBM i以外のサーバーでは無視 サーバーからへクライアントの変換テーブル名。ライブラリ名を指定することはできません。デフォルトは*JOBで、この場合、IBM iサーバーのジョブのCCSIDおよびクライアント・コード・ページに基づいて変換テーブルが生成されます。 この引数が*JOBの場合、クライアントからサーバーへの変換テーブルも*JOBである必要があります。 | 1 | 10 |
| 0 |
...
- このBIFを使用するには、x_runパラメータCDLLをLCOMGR32.DLLに、x_runパラメータCMTHをCかTにそれぞれ設定する必要があります。
- この組み込み関数の呼び出しで指定するサーバー・ネットワーク名は、サーバーがLANSAコミュニケーション管理機能で登録されたか登録予定のパートナーLU名と一致している必要があります。
- サーバー定義および接続のロジックは、多数のRDMLファンクションに分散させるのではなく、1つのファンクションにのみコーディングすることを強くお勧めします。このようにすることで、将来サーバーに対して加えられる変更からアプリケーションを保護することができます。
- SSN 値は、メッセージにしばしば表示される場合があるため、エンド・ユーザーにとって意味のある名前にすることをお勧めします(CHICAGO、BOSTONCHARLIE1など)。
- SSN 名は、英語のアルファベット(大文字のAからZまで)で始まる固有の名前である必要があります。
- サーバーが接続されていない時は、繰り返し(再)定義することができます。現在接続されているサーバーを(再)定義しようとすると、致命的なエラーが発生します。
- X_RUN 例外引数を使用して、サーバー・システム上で開始しているX_RUNコマンドのパラメータをオー バーライドすることができます。 デフォルトでは、サーバー・システム上で開始しているX_RUNコマンドに、以下のクライアントX_RUNパラメータが渡されます(このコマンドから継承されます)。CMTH=、CDLL=、DATF=、DATS=、DBCF=、DBCL=、DBLK=、DBTC=、DBUS=、DEVE=、FXQF=、FXQM=、HSKC=、INIT=、ITHP=、ITRC=、ITRL=、ITRM=、ITRO=、LANG=、PART=、PRTR=、PSPW=、PSTC=、PSWD=、TASK=、TERM=、USER=、XAFP=、およびXCMD=。以下のクライアントX_RUNパラメータ値は、クライアントとサーバーが同じオペレーティング・システムを使用する場合にのみこれらから継承されます。DBID=、DBII=、DBIT=、DBUT=、ODBI=、およびWPEN (および関連するWindows印刷拡張&<a href="depb3_0090.htm"&>パラメータ&</a&>パラメータ)。 サーバー・システム上のその他すべてのX_RUNパラメータ値は、通常の方法(プロフィール・ファイルから、システム環境設定からなど)でデフォルトが指定されます(サーバー・システム上で)。X_RUNコマンドに関する説明を参照して、すべてのパラメータの詳細およびその設定方法またはデフォルトの指定方法について確認してください。
- CDLL=、CMTH=、DATF=、DATS=、DBUG=、DEVE=、LANG=、MODE=、PART=、PROC=、PSPW=、USER=、および XAFP=以外のサーバーX_RUNパラメータは、(X_RUN例外引数値を使用して)すべてオーバーライドすることができます。これらのX_RUN引数は、無条件にクライアント・システムから継承されます。ただし、一部のパラメータは、CONNECT_SERVERを呼び出す前に「 &<a href="set_session_value.htm"&>SET_SET_SESSION_VALUE&</a&>」を呼び出すことにより変更できます。 」を呼び出すことにより変更できます。 パラメータのオーバーライドにより、特定の値または特殊な値*SERVERが指定される場合があります。*SERVERは、デフォルトのサーバーを使用する必要があることを示す値です。例えば、DBII=*NONEを使用するWindowsクライアントは、Oracleを実行するWindows Serverに接続する場合があります。デフォルトでは、Windowsはデータベース・タイプMSSQLS (SQL Server)を使用するため、DBUTをオーバーライドする必要があります。X_RUN例外引数値には、DBUT=ODBCORACLEかDBUT= *SERVERのいずれかを設定することができます。
- この組み込み関数を使用して定義された詳細は、永続的なものではありません。X_RUNコマンドが終了すると消滅します。ユーザー独自のSQLベースのテーブルを定義して、サーバー詳細を保持したり、テーブルを実際に読み込んでこの組み込み関数に渡される値を取得することができます。
- これらの機能で十分に経験を積んでから、組織で使用する特定のサーバー・アーキテクチャを設計するようにしてください。サーバー・アーキテクチャは、以下のような特徴が必要です。
- 組織の要件を満たしている
- 手早く容易に変更できる
- 拡張可能である
- 大規模な設計あるいは開発プロジェクトに着手する前に、これを実行してください。
- クライアントの日付形式は自動的にサーバーに渡されます。日付形式同士が異なる場合(MDYとDMYなど)、サーバーはクライアントの形式で自動的にデータを戻します。 クライアントの日付形式は、x_runパラメータのDATF=を指定するとデフォルトから変更することができます。このパラメータの詳細については、『Deploying Client and Server Applications』の標準の「&<a href="depb3_0005.htm"&>X_RUNパラメータ&</a&>」を参照してください。 X_RUNパラメータ」を参照してください。 クライアントとサーバーで日付形式が異なる場合、正確な形式(DDMMYY) を指定する日付形式の妥当性検査は失敗します(戻されるデータはMMDDYY の形式になる場合があります)。クライアントが別の日付形式を使用する必要がある地域(米国および英国のクライアントなど)では、SYSFMTの日付形式を使用されることをお勧めします。
...
- 「コミット制御の開始」をYにした場合、LANSAは自動的にコミット制御の開始および終了を実行します。詳細については、『LANSA/AD ユーザーガイド』の「&<a href="../../../lansa010/content/lansa/ladtgubh_0160.htm"&>ユーザー出口 F@BGNCMT – コミット制御の開始&</a&>」および「&<a href="../../../lansa010/content/lansa/ladtgubh_0155.htm"&>ユーザー出口 F@ENDCMT - コミット制御の終了&</a&>」を参照してください。ユーザー出口 F@BGNCMT – コミット制御の開始」および「ユーザー出口 F@ENDCMT - コミット制御の終了」を参照してください。
- サーバーがコミット制御を使用するよう指定されると、それ以降のすべてのCOMMITおよびROLLBACK コマンドで適用されます。 COMMITまたはROLLBACK コマンドが発行されると、現在接続中のすべてのサーバーに対して関連するルーチンがループします。 コミット制御がアクティブなサーバーに対しては、"commit"もしくは"rollback"要求を発行し、サーバーからの応答を待機してから続行します。 これは、ローカル/クライアント・データベース・マネジメント・システムに対してcommit/rollbackが正しく発行された後で実行されます。
...
区切り文字に使用できるのは、シングル・カンマ (,) のみです。
[ |../../index.htm#lansa/define_any_server.htm]