Mit dem Aufruf KC_MODIFY_OBJECT können Sie während eines Anwendungslaufs die Eigenschaften von Objekten und Parameter des Anwendungsprogramms ändern und Aktionen veranlassen (z.B. Rücksetzen von Statistikwerten).
| KC_MODIFY_OBJECT, siehe "KC_MODIFY_OBJECT - Objekteigenschaften und Anwendungsparameter ändern" |
Folgende Objekttypen haben dynamisch veränderbare Eigenschaften:
KC_CLUSTER_NODE, KC_DB_INFO, KC_KSET, KC_LOAD_MODULE, KC_LPAP, KC_LSES, KC_LTAC, KC_LTERM, KC_MUX, KC_OSI_CON, KC_OSI_LPAP, KC_PTERM, KC_TAC, KC_TACCLASS, KC_TPOOL, KC_USER.
In den folgenden Abschnitten wird auf das Modifizieren einiger Objekttypen näher eingegangen (KC_PTERM, KC_LTERM, KC_TAC, KC_USER, KC_KSET und KC_LSES).
Folgende Parametertypen haben Eigenschaften, die dynamisch verändert werden können:
KC_CLUSTER_CURR_PAR, KC_CLUSTER_PAR, KC_CURR_PAR, KC_DIA-G_AND_ACCOUNT_PAR, KC_MAX_PAR, KC_TASKS_PAR, KC_TIMER_PAR.
Pro KC_MODIFY_OBJECT-Aufruf können Sie genau ein Objekt ändern. Es ist jedoch möglich innerhalb eines Administrationsprogramms KC_MODIFY_OBJECT mehrfach aufzurufen, um die Eigenschaften mehrerer Objekte zu modifizieren. Beim Aufruf geben Sie den Typ des Objektes, seinen Namen und die Eigenschaften an, die geändert werden sollen.
Bei der Änderung von Anwendungsparametern können Sie innerhalb eines Aufrufs alle Parameter ändern, die zu demselben Parametertyp gehören.
Welche Eigenschaften bei welchem Objekttyp oder Anwendungsparameter geändert werden können und welche Aktionen dadurch ausgelöst werden, ist im Abschnitt „KC_MODIFY_OBJECT - Objekteigenschaften und Anwendungsparameter ändern“ beschrieben.
Die Wirksamkeit und Dauer einer Änderung ist abhängig vom Objekttyp bzw. Anwendungsparameter und der Eigenschaft, die verändert wird. Es gibt Änderungen, die nur im aktuellen Anwendungslauf wirksam sind (Run) und Änderungen, die über den aktuellen Anwendungslauf hinaus wirken (Durable). Der Zeitpunkt, zu dem eine Änderung wirksam wird, kann sein:
sofort (Immediate),
nach der Transaktionssicherung (PEND),
wenn es die Auslastung der Anwendung zulässt.
UTM-Cluster-Anwendungen (Unix-, Linux- und Windows-Systeme)
In einer UTM-Cluster-Anwendung gilt:
Je nach Objekt kann der Aufruf sowohl Aktionen, die Cluster-global als auch solche, die Knoten-lokal wirken, anstoßen. Global wirkende Aktionen werden für jede Knoten-Anwendung der UTM-Cluster-Anwendung ausgeführt, unabhängig davon, ob eine Knoten-Anwendung gerade aktiv ist oder nicht. Lokal wirkende Aktionen wirken sich nur auf die Knoten-Anwendung aus, an der sie ausgeführt wurden.