Dieses Dokument behandelt die folgenden Themen:
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 | 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. |
| 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 |
Z-120
Z-122
Z-123
Z-135
Z-147
Z-161
Z-161A
Z-161B
Z-180
Z-190
Z-1200&0