ml_add_property システムプロシージャー

このシステムプロシージャーを使用して、Mobile Link のプロパティを追加または削除します。このシステムプロシージャーは、ml_property システムテーブルのローを変更します。

構文

ml_add_property ( 
'comp_name', 
'prop_set_name', 
'prop_name', 
'prop_value'
)

パラメーター

構文	説明
comp_name	VARCHAR(128)。コンポーネント名。スクリプトバージョンごとにプロパティを保存するには、ScriptVersion に設定します。Mobile Link サーバープロパティの場合は、MLS に設定します。サーバー起動同期のプロパティの場合は、SIS に設定します。
prop_set_name	VARCHAR(128)。プロパティセット名。コンポーネント名が ScriptVersion である場合、このパラメーターはスクリプトバージョンの名前です。コンポーネント名が MLS である場合、このパラメーターは Mobile Link ユーザーに対して冗長性を指定する ml_user_log_verbosity、またはリモート ID に対して冗長性を指定する ml_remote_id_log_verbosity にすることができます。コンポーネント名が SIS である場合、このパラメーターはプロパティを設定している Notifier、ゲートウェイ、または Carrier の名前です。
prop_name	VARCHAR(128)。プロパティ名。コンポーネント名が ScriptVersion である場合、このパラメーターは定義するプロパティです。DBConnectionContext の場合は getVersion や getProperties、ServerContext の場合は getPropertiesByVersion、getProperties、getPropertySetNames を使用して、このプロパティを参照できます。コンポーネント名が MLS である場合、このパラメーターは定義する Mobile Link ユーザー名またはリモート ID です。
prop_value	TEXT。プロパティの値。 prop_set_name が ml_user_log_verbosity または ml_remote_id_log_verbosity の場合は、有効な mlsrv -v オプションである必要があります。 Adaptive Server Enterprise の場合は VARCHAR(16384)。IBM DB2 LUW の場合は VARCHAR(4000)。Oracle の場合は CLOB。プロパティを削除するには、NULL に設定します。

対象 Mobile Link ユーザーとリモート ID に対するログの冗長性

対象とする Mobile Link ユーザーまたはリモート ID に対して、Mobile Link サーバーが異なるログの冗長性を使用するように設定できます。Mobile Link サーバーは、5 分ごとに ml_property テーブルをチェックし、Mobile Link ユーザーまたはリモート ID の冗長性設定を調べます。冗長性設定が存在する場合は、指定された Mobile Link ユーザーまたはリモート ID に対する出力メッセージを記録するために新しい設定が使用されます。これにより、サーバーファームに悪影響を与えるような高い冗長性設定を使用したり、ファーム内の各サーバーを再起動したりしなくても、特定のユーザーまたはリモート ID に関する詳細を確認できます。

対象 Mobile Link ユーザー (たとえば ml_user1) の冗長性を最大にするには、統合データベースにログインして次の SQL コマンドを発行します。

call ml_add_property( 'MLS', 'ml_user_log_verbosity', 'ml_user1', '-v+' )

対象リモート ID (たとえば rid_1) の冗長性を最大にするには、統合データベースにログインして次の SQL コマンドを発行します。

call ml_add_property( 'MLS', 'ml_remote_id_log_versity', 'rid_1', '-v+' )

verbose_setting は、Mobile Link サーバーで有効な -v オプションにする必要があります。たとえばローデータや未定義テーブルスクリプトをログに記録するには、verbose_setting を -vru または vru に設定できます。Mobile Link サーバーは 5 分後に ml_user1 または rid_1 に対してこの冗長性設定を使用します。 -v mlsrv12 オプションを参照してください。

Mobile Link ユーザーのログの冗長性を無効にするには、統合データベースにログインして次の SQL コマンドを発行します。

call ml_add_property( 'MLS', 'ml_user_log_verbosity', 'ml_user1', NULL )

リモート ID のログの冗長性を無効にするには、統合データベースにログインして次の SQL コマンドを発行します。

call ml_add_property( 'MLS', 'ml_remote_id_log_verbosity', 'rid_1', NULL )

Mobile Link サーバーは 5 分後に ml_user1 または rid_1 に対して先の冗長性設定を使用停止します。

指定された Mobile Link ユーザーやリモート ID に対して ml_user_log_verbosity と ml_remote_id_log_verbosity の「両方」が設定されている場合、および同期における Mobile Link ユーザー名やリモート ID が、指定された対象 Mobile Link ユーザーやリモート ID と同一である場合、Mobile Link サーバーは出力メッセージを記録するときに ml_remote_id_log_verbosity 設定を使用します。

サーバー起動同期

サーバー起動同期では、ml_add_property システムプロシージャーを使用すると、Notifier、ゲートウェイ、Carrier のプロパティを設定できます。

たとえば、x という SMTP ゲートウェイのプロパティ server=mailserver1 を追加するには、次のように入力します。

ml_add_property( 'SIS','SMTP(x)','server','mailserver1' );

冗長なプロパティがすべての Notifier とゲートウェイに適用されるため、特定のプロパティセット名を指定することはできません。冗長性の設定を変更するには、次のようにプロパティセット名を空のままにします。

ml_add_property( 'SIS','','verbosity',2 );

スクリプトバージョン

通常の Mobile Link 同期では、このシステムプロシージャーを使用して、プロパティをスクリプトバージョンに関連付けることができます。この場合、component_name を ScriptVersion に設定します。任意のプロパティを指定し、Java クラスまたは .NET クラスを使用してプロパティにアクセスできます。

たとえば、LDAP サーバーを MyVersion というスクリプトバージョンに関連付けるには、次のように入力します。

ml_add_property( 'ScriptVersion','MyVersion','ldap-server','MyServer' )

参照

DocCommentXchange で意見交換できます