Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

9.39 DEFINE_OS_400_SERVER

Note
title注意

 9.1 組み込み関数の規則     利用オプション

現在のRDMLファンクションに対するサーバーとして使用されるIBM iシステムの詳細を定義します。 

...

番号

タイプ

必須/任意

記述

最小長

最大長

最小小数桁数

最大小数桁数

1

A

必須

SSN (サーバーの別名)。これは、今後のこのサーバーへのすべての参照でこのファンクションおよび他のRDMLファンクションが使用する名前です。

これは、今後のこのサーバーへのすべての参照でこのファンクションおよび他のRDMLファンクションが使用する名前です。

1

10



2

A

必須

LU パートナー名

1

20



3

A

必須

サーバー上でコミットメント制御を開始します。このサーバーの接続が完了すると、クライアントからRDMLレベルのCOMMITまたはROLLBACKコマンドが発行されるたびに、"commit"または"rollback"要求を受け取ります。

Yまたは1:コミットメント制御を使用 
その他:コミットメント制御を使用しない

1

1



4

A

任意

サーバーがDBCSを使用可能かどうか指定

Yまたは1:DBCSを使用可能 
その他:DBCSが使用できないサーバー

デフォルトはNです。

1

1



5

A

任意

LOCK_OBJECT要求をこのサーバーに転送します。このオプションを使用する場合は、後続するすべてのLOCK_OBJECT要求がこのサーバーに転送されます。複数のサーバーが共にこのオプションを使用可能に設定している場合、各サーバーとも同じLOCK_OBJECT要求を受け取ります。

このような場合は、LOCK_OBJECTを実行するすべてのサーバーが正常に処理を完了するためには、サーバーにロックが許可されている必要があります。1つのサーバーでロックの許可に失敗すると、すでにオブジェクトのロックが許可されているすべてのサーバーに対してUNLOCK_OBJECT要求が発行されます。 

Yまたは1:LOCK_OBJECT要求を転送する 

Z:LOCK_OBJECT要求を転送し、このサーバーに権限検査要求も転送する (権限検査要求を転送する対象としては、1つのサーバーのみ指定してください) 

R:ロック要求、権限要求、リポジトリ・データ要求 (ローカルで検出されない場合) を経路指定する。X_RUNパラメータについては、「X_RUN コマンドの使用」を参照してください。

その他 - LOCK_OBJECT要求を転送しない 

デフォルトはNです。

1

1



6

A

任意

接続待ちの間に「しばらくお待ちください」というメッセージを表示します。

Yまたは1:上記メッセージを表示する 

その他:メッセージを表示しない 

デフォルトはYです。

1

1



7

A

任意

IBM i実行の優先順位

デフォルトは20です。他の値は、IBM i実行の優先順位。デフォルトは20です。他の値は、IBM iのCHGJOBコマンドのRUNPTYパラメータに指定してください。指定された値を変更する権限がユーザーに許可されている必要があります。

1

2



8

A

任意

クライアントからサーバーへの変換テーブル名

ライブラリ名を指定することはできません。デフォルトでANSEBC1140に設定されます。クライアントからサーバーへの変換テーブル名。ライブラリ名を指定することはできません。デフォルトでANSEBC1140に設定されます。

1

10



9

A

任意

サーバーからへクライアントの変換テーブル名

ライブラリ名を指定することはできません。デフォルトでEBC1140ANSに設定されます。サーバーからへクライアントの変換テーブル名。ライブラリ名を指定することはできません。デフォルトでEBC1140ANSに設定されます。

1

10



戻り値

番号

タイプ

必須/任意

記述

最小長

最大長

最小小数桁数

最大小数桁数

1

A

必須

戻りコード

OK:サーバーが定義された 
ER:サーバーが未定義でエラー・メッセージが発行される

2

2



...

  • クライアントの日付形式は自動的にサーバーに渡されます。日付形式同士が異なる場合(MDYとDMYなど)、サーバーはクライアントの形式で自動的にデータを戻します。 
    クライアントの日付形式は、x_runパラメータのDATF= を指定するとデフォルトから変更することができます。このパラメータの詳細については、X_RUNパラメータ概要を参照してください。 
    クライアントとサーバーで日付形式が異なる場合、正確な形式 (DDMMYY) を指定する日付形式の妥当性検査は失敗します (戻されるデータはMMDDYY の形式になる場合があります)。クライアントが別の日付形式を使用する必要がある地域 (米国および英国のクライアントなど) では、SYSFMTの日付形式を使用されることをお勧めします。

...

  • 「コミット制御の開始」をYにした場合、LANSAは自動的にコミット制御の開始および終了を実行します。詳細については、『LANSA/AD ユーザーガイド』ユーザー出口 F@BGNCMT – コミット制御の開始」および「ユーザー出口 F@ENDCMT - コミット制御の終了を参照してください。
  • サーバーがコミットメント制御を使用するよう指定されると、それ以降のすべてのCOMMITおよびROLLBACKコマンドで適用されます。 COMMITおよびROLLBACKコマンドが発行されると、現在接続中のすべてのサーバーに対して関連するルーチンがループします。 コミットメント制御がアクティブなサーバーに対しては、"commit"または"rollback"要求を発行し、サーバーからの応答を待機してから続行します。 これは、ローカル/クライアントのデータベース・マネジメント・システムに対してcommit/rollbackが正しく発行された後で実行されます。

...