Büros umbenennen - nur im Batch-Betrieb

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

Programm

B87050

Funktion

Büros umbenennen. Der alte Büroname wird durch einen neuen, eindeutigen Büronamen ersetzt.

Warnung:
Es wird empfohlen, dass Sie dieses Dienstprogramm erst dann starten, wenn keine Teilnehmer mehr bei Con-nect angemeldet sind. Sie sollten dies unbedingt beachten, weil sonst Datenintegritätsprobleme auftreten können (z.B. wenn Post an das umzubenennende Büro gesendet wird).

Wichtige Informationen

Bevor Sie mit dem Umbenennen der Büros beginnen, sollten Sie zuerst überprüfen, wieviel Zeit für das Umbenennen erforderlich ist (siehe das Batch-Beispiel unten). Wenn die Zeit ausreichend ist, sollten Sie ein Backup Ihrer Con-nect-Systemdatei erstellen und danach dieses Dienstprogramm auf einer möglichst gering belasteten Maschine ausführen.

Je nach Größe der Con-nect-Systemdatei kann die Ausführung dieses Dienstprogramm mehrere Stunden dauern. Aus diesem Grund sollten Sie die Ausführungsparameter ausreichend setzen (z.B. den JCL-Parameter TIME auf 1440, den Adabas-Parameter MADIO auf 0 und den Natural-Parameter MT auf 0).

Dienstprogramm-Parameter

Parameter Format Beschreibung
Aus dem Büro A8 Wenn Sie einen Stern (*) angeben, werden alle zum Umbenennen markierten Büros umbenannt, wenn das angegebene Datum erreicht ist. Wird ignoriert, wenn der Parameter Test-Ausführungszeit gesetzt ist.
In das Büro A8 Optional. Wird ignoriert, wenn der Parameter Test-Ausführungszeit gesetzt ist.
Test-Ausführungszeit A1 Optional. Wenn dieser Parameter gesetzt ist, werden die Büros nicht umbenannt. Es wird nur geprüft, wie lange der Vorgang dauern wird.
Maximal erlaubte Umbenennungszeit A10 Die Zeit, in Minuten, die während des Umbenennungsvorgangs nicht überschritten werden darf. Vorgabe: 240 Minuten.

Markierter Satz

Dieses Dienstprogramm wird ausgeführt, nachdem ein Büro mit der Administrationsfunktion Büroverwaltung zum Umbenennen markiert wurde, d.h. nachdem ein Satz erstellt wurde, der die umzubenennenden Büros identifiziert.

Anmerkung:
Ab dem angegebenen Datum kann niemand mehr auf das zum Umbenennen markierte Büro zugreifen.

Vorgehensweise

Wenn das angegebene Datum erreicht ist, liest dieses Dienstprogramm einen, mehrere oder alle zum Umbenennen markierten Sätze, je nachdem welche Parameter Sie eingeben.

Dieses Dienstprogramm schätzt dann die Zeit, die zum Umbenennen der ausgewählten Büros erforderlich ist und vergleicht sie mit dem Wert, der im Parameter "Maximal erlaubte Umbenennungszeit" definiert wurde. Wenn die geschätzte Zeit diesen Parameterwert überschreitet, werden die Büros nicht umbenannt und eine Meldung ähnlich der Folgenden wird ausgegeben:

Die Umbenennung ist in der maximal erlaubten Zeit nicht moeglich
1569 Buero(s) werden in ca. 06 Std 25 Min 10 Sek umbenannt 

In diesem Fall können Sie folgendermaßen vorgehen: entweder Sie starten das Dienstprogramm später oder Sie ändern Sie den Parameter "Maximal erlaubte Umbenennungszeit" und starten das Dienstprogramm erneut.

Wenn die geschätzte Zeit kürzer ist als im Parameterwert angegeben, wird jedes ausgewählte Büro gesperrt, um die Teilnehmer daran zu hindern, sich anzumelden. Um konkurrierende Aktionen zu vermeiden, wird ein Umbenennungs-Flag gesetzt (siehe unten: Während der Ausführung nicht erlaubte Funktionen).

Danach werden alle Datensätze aus der Con-nect-Systemdatei in physischer Reihenfolge gelesen, analysiert und gegebenenfalls umbenannt. Nachdem alle markierten Büros umbenannt wurden, wird das Umbenennungs-Flag wieder gelöscht.

Im Falle eines Programmabbruchs wird das Umbenennungs-Flag erst dann gelöscht, wenn dieses Dienstprogramm mit denselben Parametern erneut gestartet wird, um den Umbenennungsvorgang zu beenden.

Dokumente

Dokumentnamen und Rufnamen werden nicht geändert.

Felder wie Autorenkennzeichen und Änderungskennzeichen werden bei allen Objekten aktualisiert.

Wenn die Informationen in einem Objektfeld als Büroname oder als Name, der sich auf ein Büro bezieht (z.B. Teilnehmerkennzeichen), angesehen werden, wird dieses Feld auch umbenannt.

Verteiler

Der Name eines Verteilers wird nicht geändert, wenn er denselben Namen hat wie ein Büro, das umbenannt werden soll. Die Mitglieder eines Verteilers werden jedoch umbenannt.

Passwort

Wenn das Standardpasswort eines Büro benutzt wird, wird es umbenannt. Wenn der Teilnehmer ein anderes Passwort definiert hat, wird es nicht geändert.

Während der Ausführung nicht erlaubte Funktionen

Während dieses Dienstprogramm ausgeführt wird bzw. wenn das Umbenennungs-Flag gesetzt ist, ist Folgendes nicht erlaubt:

  • alle Administrationsfunktionen,

  • alle API-Subprogramme,

  • alle anderen Dienstprogramme,

  • Zugriff auf die zum Umbenennen markierten Büros.

Anmerkung:
Wenn ein API-Subprogramm versucht, auf ein Büro zuzugreifen, wird Return-Code 02 ausgegeben (ungültiger Büroname).

Nicht ausgeführte Befehle

Während dieses Dienstprogramm ausgeführt wird, werden die folgenden Befehle, die im Zusammenhang mit einem markierten Büro eingegeben wurden, nicht ausgeführt. In diesem Fall wird eine Meldung ausgegeben.

Befehl Meldung
ZUGRIFF Mitgliedsbüro wird gerade umbenannt
Adresse EINGEBEN Empfänger nicht verfügbar - wird gerade umbenannt
Verteiler EINGEBEN Empfänger nicht verfügbar - wird gerade umbenannt
WEITERLEITEN Empfänger nicht verfügbar - wird gerade umbenannt
SENDEN Empfänger nicht verfügbar - wird gerade umbenannt
BEANTWORTEN Nicht an alle Empfänger versendet: Umbenennung läuft gerade
BESTAETIGEN Nicht an alle Empfänger versendet: Umbenennung läuft gerade

Ausführungszeit schätzen

Je nach Anzahl der Datensätze in der Con-nect-Systemdatei und der Anzahl der umzubenennenden Büros benötigt dieses Dienstprogramm entweder einige Minuten oder mehrere Stunden.

Die voraussichtliche Dauer können Sie ermitteln, indem Sie den Parameter Test-Ausführungszeit angeben (siehe nachfolgendes Beispiel). In diesem Fall werden die Büros weder gesperrt noch umbenannt. Die Dauer wird für 1, 10, 50, 100, 200, 500 und 1000 Büros ermittelt.

Batch-Beispiel

Alle zum Umbenennen markierten Büros beginnend mit Büro AB umbenennen:

LOGON SYSCNT2B 
MENU
B87050 AB* 
FIN

Die voraussichtliche Dauer des Umbenennungsvorgangs ermitteln:

LOGON SYSCNT2B
MENU
B87050
,,X
FIN