ml_add_property-Systemprozedur

Mit dieser Systemprozedur können Sie MobiLink-Eigenschaften hinzufügen oder löschen. Diese Systemprozedur ändert Zeilen in der Systemtabelle ml_property.

Syntax

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

Parameter

Syntax	Beschreibung
comp_name	VARCHAR(128). Der Komponentennamen. Um Eigenschaften mit einer Skriptversion zu speichern, setzen Sie diesen Parameter auf ScriptVersion. Für MobiLink-Servereigenschaften legen Sie ihn auf MLS fest. Für Eigenschaften der serverinitiierten Synchronisation setzen Sie diesen Parameter auf SIS.
prop_set_name	VARCHAR(128). Der Eigenschaftsgruppenname. Wenn der Komponentenname den Wert ScriptVersion hat, ist dieser Parameter der Name der Skriptversion. Wenn der Komponentenname MLS lautet, kann dieser Parameter ml_user_log_verbosity sein, um die Ausführlichkeitsstufe für einen MobiLink-Benutzer festzulegen, ml_remote_id_log_verbosity, um die Ausführlichkeitsstufe für eine entfernte ID festzulegen, oder locking_and_blocking_detection, damit Informationen zu Sperren und Blockierungen an den MobiLink-Profiler oder die Logdatei des MobiLink-Servers gemeldet werden. Wenn der Komponentenname SIS ist, dann ist dieser Parameter der Name des Notifiers, Gateways oder Carriers, für den oder das eine Eigenschaft festgelegt wird.
prop_name	VARCHAR(128). Der Eigenschaftsname. Wenn der Komponentenname ScriptVersion ist, dann ist dieser Parameter eine von Ihnen festgelegte Eigenschaft. Sie können diese Eigenschaften mithilfe von DBConnectionContext : getVersion und getProperties referenzieren, oder mit ServerContext: getPropertiesByVersion, getProperties und getPropertySetNames. Wenn der Komponentenname MLS lautet, ist diese Eigenschaft entweder ein MobiLink-Benutzername oder eine entfernte ID (jeweils von Ihnen definiert) oder blocking_threshold_in_seconds, damit Informationen zu Sperren und Blockierungen an den MobiLink-Profiler oder die Logdatei des MobiLink-Servers gemeldet werden.
prop_value	TEXT. Der Eigenschaftswert. Wenn prop_set_name entweder ml_user_log_verbosity oder ml_remote_id_log_verbosity ist, muss dies ein gültiger Wert für die mlsrv-Option -v sein. Wenn Informationen zu Sperren und Blockierungen an den MobiLink-Profiler oder die Logdatei des MobiLink-Servers gemeldet werden sollen, ist dieser Wert time_in_seconds. Für Adaptive Server Enterprise hat dieser Parameter den Datentyp VARCHAR(16384). Für IBM DB2 LUW hat dieser Parameter den Datentyp VARCHAR(4000). Für Oracle hat dieser Parameter den Datentyp CLOB. Um eine Eigenschaft zu löschen, setzen Sie diesen Parameter auf NULL.

Sperren und Blockierungen melden

Der MobiLink-Server erkennt alle benutzerdefinierten Skripten, die länger als eine bestimmte Zeit laufen (wobei der Standardwert 60 Sekunden beträgt). Er meldet die Informationen zu Sperren und Blockierungen an den MobiLink-Profiler, falls dieser mit dem MobiLink-Server verbunden ist, und protokolliert sie außerdem in der Logdatei des MobiLink-Servers.

Die Informationen zu Sperren und Blockierungen umfassen Folgendes:

Die Synchronisations-ID
Die MobiLink-Server-ID der Verbindung, die derzeit blockiert ist
Die ID der Verbindung, die derzeit den MobiLink-Server blockiert
Die Gesamtzeit der Blockierung in Sekunden
Den Namen des Objekts oder Vorgangs, auf dem die Serververbindung blockiert ist

Sie können die Standardzeit ändern, indem Sie die folgende SQL-Anweisung in der konsolidierten Datenbank ausführen:

call ml_add_property( 'MLS', 'locking_and_blocking_detection', 'blocking_threshold_in_seconds', 'time_in_seconds' );

Dabei ist time_in_seconds eine Ganzzahl, die den Schwellenwert für die Blockierung in Sekunden angibt. Wenn time_in_seconds gleich Null ist, wird diese Funktion deaktiviert.

Dies ist eine statische Eigenschaft. Der MobiLink-Server muss neu gestartet werden, bevor die neuen Werte wirksam werden.

Ausführlichkeitsstufe des Logs für bestimmte MobiLink-Benutzer und entfernte IDs

Der MobiLink-Server kann so eingerichtet sein, dass für einen Ziel-MobiLink-Benutzer oder eine entfernte ID eine andere Log-Ausführlichkeitsstufe verwendet wird. Der MobiLink-Server prüft die Tabelle ml_property alle fünf Minuten und sucht die Ausführlichkeitseinstellungen für einen MobiLink-Benutzer oder eine entfernte ID. Wenn Ausführlichkeitseinstellungen vorhanden sind, verwendet der MobiLink-Server die neue Einstellung zum Protokollieren von Ausgabenachrichten für den angegebenen MobiLink-Benutzer oder die angegebene entfernte ID. Auf diese Weise können Sie die Details für einen bestimmten Benutzer oder eine bestimmte entfernte ID sehen, ohne hohe Ausführlichkeitseinstellungen zu verwenden, die die Performance der Serverfarm beeinträchtigen würden, und ohne einen Neustart der einzelnen Server in der Farm auszuführen.

Wenn Sie die maximale Ausführlichkeitsstufe für einen MobiLink-Zielbenutzer, z.B. ML-Benutzer1, festlegen möchten, melden Sie sich bei der konsolidierten Datenbank an und führen Sie die folgende SQL-Anweisung aus:

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

Wenn Sie die maximale Ausführlichkeitsstufe für eine entfernte Ziel-ID, z.B. e_ID_1, festlegen möchten, melden Sie sich bei der konsolidierten Datenbank an und führen Sie die folgende SQL-Anweisung aus:

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

Die Option verbose_setting muss ein gültiger Wert für die MobiLink-Server-Option -v sein. Um z.B. Zeilendaten und undefinierte Tabellenskripten zu protokollieren, kann verbose_setting -vru oder vru sein. Der MobiLink-Server verwendet diese Ausführlichkeitsstufe für ml_user1 oder rid_1 nach 5 Minuten. Siehe mlsrv16-Option -v .

Wenn Sie die Protokollierungsausführlichkeit für einen MobiLink-Benutzer deaktivieren möchten, melden Sie sich bei der konsolidierten Datenbank an und führen Sie die folgende SQL-Anweisung aus:

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

Wenn Sie die Protokollierungsausführlichkeit für eine entfernte MobiLink-ID deaktivieren möchten, melden Sie sich bei der konsolidierten Datenbank an und führen Sie die folgende SQL-Anweisung aus:

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

Der MobiLink-Server beendet die Verwendung der vorherigen Ausführlichkeitsstufe für ml_user_1 oder rid_1 nach fünf Minuten.

Wenn sowohl ml_user_log_verbosity als auch ml_remote_id_log_verbosity für einen angegebenen MobiLink-Benutzer und eine entfernte ID festgelegt werden, und wenn der MobiLink-Benutzername und die entfernte ID in einer Synchronisation für den angegebenen MobiLink-Zielbenutzer identisch sind, verwendet der MobiLink-Server die Einstellung ml_remote_id_log_verbosity, um Ausgabenachrichten zu protokollieren.

Serverinitiierte Synchronisation

Bei der serverinitiierten Synchronisation ermöglicht es die Systemprozedur ml_add_property, Eigenschaften für Notifier, Gateways und Carrier festzulegen.

Wenn Sie beispielsweise die Eigenschaft server=mailserver1 für ein SMTP-Gateway namens x hinzufügen möchten, führen Sie die folgende SQL-Anweisung aus:

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

Die verbosity-Eigenschaft gilt für alle Notifier und Gateways, sodass Sie keinen speziellen Eigenschaftsgruppennamen festlegen können. Um die Einstellung der Ausführlichkeitsstufe zu ändern, lassen Sie "Eigenschaftsgruppenname" leer. Beispiel:

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

Skriptversion

Für eine regelmäßige MobiLink-Synchronisation können Sie Eigenschaften mit dieser Systemprozedur einer Skriptversion zuordnen. In diesem Fall setzen Sie "Komponentenname" auf ScriptVersion. Sie können beliebige Eigenschaften festlegen und mit Java- und .NET-Klassen auf sie zugreifen.

Wenn Sie beispielsweise einen LDAP-Server einer Skriptversion namens MyVersion zuordnen möchten, führen Sie die folgende SQL-Anweisung aus:

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

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.