Z-MOD11

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

Den Text eines bestehenden Dokuments mit Daten aus einem Text-Array (A251/1:20) ändern.

Der neue Text kann entweder im Txt- oder Cnf-Format sein. Der Originaltext wird gelöscht und durch den neuen Text ersetzt. Die Dokumentinformation (z.B. Beschreibung und Suchbegriffe) wird nicht verändert.

Sie können nicht den Text eines Dokument ändern, das in einem Systemfach (außer dem Arbeitsfach) abgelegt ist.

Sie müssen den Parameter Text-Array folgendermaßen redefinieren:

Byte-Nummer Beschreibung
1 Anzahl der Zeilenvorschübe (1 bis 9)
2 bis 251 Text

Sie müssen Leerzeilen (d.h. Zeilenvorschübe) separat definieren. Wenn Sie zum Beispiel den Wert 9 definieren, darf hiernach kein Text folgen. Vor einer Textzeile muss immer der Wert 1 stehen (wenn Sie keinen Wert definieren, wird 1 automatisch benutzt). Zum Beispiel:

MOVE '1Dies ist eine Textzeile'  TO TEXT-ARRAY (1)
MOVE '2'                         TO TEXT-ARRAY (2) /* fuegt 2 Leerzeilen ein
MOVE '1Dies ist eine Textzeile'  TO TEXT-ARRAY (3)

Sie können Leerzeilen hinter dem Dokumenttext unterdrücken, indem Sie die Anzahl der Textzeilen, die gespeichert werden sollen, im Parameter Anzahl angeben. Wenn der Parameter Anzahl nicht definiert wird, wird der Vorgabewert 20 benutzt.

Sie können dieses Subprogramm iterativ aufrufen, um ein beliebig langes Dokument zu erstellen. Bei aufeinander folgenden Aufrufen müssen Sie darauf achten, dass der Work-Parameter nicht durch das aufrufende Programm zerstört wird.

Der Parameter Text-Array wird nach einem Aufruf nicht zurückgesetzt. Wenn Sie dieses Subprogramm iterativ aufrufen, muss der Parameter Text-Array daher zurückgesetzt werden, bevor er erneut gefüllt wird.

Mit dem letzten Textsatz müssen Sie den Parameter Ende-Flag setzen, um den Änderungsvorgang zu beenden und das Dokument wieder freizugeben.

Wenn Sie den Text eines TRS-Dokuments ändern wollen und Con-nect Text Retrieval nicht aufgerufen werden kann (Return-Code 06), wird im Parameter TRS-Return-Code die TRS-Fehlernummer ausgegeben.

Wenn der Text nicht die vom Administrator definierte maximale Größe überschreitet, wird ein geändertes TRS-Dokument online invertiert. Wenn die maximale Größe überschritten wird, wird das Dokument automatisch im Fach TRS-XXL abgelegt und wird invertiert, wenn das Dienstprogramm B10000 ausgeführt wird (siehe Con-nect-Dienstprogramme, Abschnitt Dokumente invertieren).

Parameter

Parameter Format Ein Aus Bemerkung
Return-Code N2 O X Eingabe -1: kein ET.
TRS-Return-Code P4   X Nach der erfolgreichen Beendigung dieses Subprogramms wird der Wert 0 ausgegeben. Jeder andere Wert weist auf einen internen Fehler hin.
Buero A8 E   Das Büro, in dem das Dokument geändert werden soll.
Passwort A8 E   Das Passwort des o.g. Büros.
Dokumentname A32 E*   Der Name des Dokuments, das geändert werden soll. Entweder Dokumentname oder ISN, nicht beides.
ISN P10 E*   Die ISN des Dokuments, das geändert werden soll. Entweder ISN oder Dokumentname, nicht beides. Vor dem Aufruf dieses Subprogramms können Sie Z-DIS11 aufrufen, um die ISN des gewünschten Dokuments auszugeben.
Dokumentformat A1 E   0=Txt oder 1=Cnf.
Text-Array A251/1:20 E   Der neue Text für das Dokument.
Anzahl N2 O   Die Anzahl der Zeilen, die mit jedem Aufruf gespeichert werden sollen. Wenn Sie keinen Wert definieren, oder einen Wert, der größer ist als 20, wird der Vorgabewert 20 benutzt.
Ende-Flag A1 E   Beendet den Änderungsvorgang und gibt das Dokument wieder frei. Wenn dieses Subprogramm iterativ aufgerufen wird, ist das Ende-Flag nur beim letzten Textsatz erforderlich (wie im Parameter Anzahl angegeben).
Work-Parameter A25     Für den internen Gebrauch. Siehe Work-Parameter.

Return-Codes

00 Erfolg
02 Ungültiger Büroname oder - nur im Batch-Betrieb - Büro gesperrt
03 Falsches Passwort
04 ISN wurde nicht gefunden
06 TRS konnte nicht aufgerufen werden
08 Geben Sie entweder ISN oder Name ein - nicht beides
09 ISN zeigt nicht auf das richtige Objekt
10 Funktion ist für Systemfach nicht gültig
16 Dokument ist gesperrt - Bearbeitung wurde nicht beendet
51 Ungültiger Name
53 Das gewünschte Objekt existiert nicht
79 Ungültiges Dokumentformat
92 Inkonsistenz zwischen Work-Parameter und Originaldokument, oder zwischen Work-Parameter und Sicherungskopie, oder zwischen Originaldokument und Sicherungskopie

Subprogramme

Z-120
Z-122
Z-123
Z-135
Z-147
Z-161
Z-161A
Z-161B
Z-180
Z-190
Z-1200&0