Z-ADD11C

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

Ein Con-nect-Dokument mit Daten aus einem Text-Array (A251/1:20) erstellen.

Sie können entweder ein Txt- oder Cnf-Dokument erstellen. Das Dokument wird immer im Arbeitsfach abgelegt.

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 im Parameter Anzahl die Anzahl der Textzeilen angeben, die gespeichert werden sollen. 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.

Parameter

Parameter Format Ein Aus Bemerkung
Return-Code N2 O X Eingabe -1: kein ET.
Buero A8 E   Das Büro, in dem das Dokument eingegeben werden soll.
Passwort A8 E   Das Passwort des o.g. Büros.
Dokumentname A32 E   Der Name des Dokuments, das eingegeben werden soll. Muss nicht angegeben werden, wenn die erste Zeile der Beschreibung angegeben wurde.
Beschreibung A60/1:4 O   Eine kurze Beschreibung für das Dokument. Wenn Sie keinen Dokumentnamen angeben, müssen Sie eine Beschreibung angeben.
Suchbegriffe A15/1:6 O   Suchbegriffe sind hilfreich, wenn Sie ein Objekt suchen. Sie können bis zu 6 Suchbegriffe eingeben. Ein Suchbegriff darf keinen Stern (*) enthalten.
Dokumentformat A1 E   0=Txt oder 1=Cnf.
Text-Array A251/1:20 E   Der Dokumenttext.
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.
ISN P8   X Die ISN des neuen Dokuments.
Work-Parameter A21     Für den internen Gebrauch. Siehe Work-Parameter.

Return-Codes

00 Erfolg
02 Ungültiger Büroname
03 Falsches Passwort
51 Ungültiger Name
52 Es existiert bereits ein Objekt mit dem angegebenen Namen
54 Mindestens ein Suchbegriff war ungültig
58 Es wurde kein Verzeichnissatz erstellt
79 Ungültiges Dokumentformat

Subprogramme

Z-120
Z-122
Z-123
Z-135
Z-162
Z-190
Z-1200&0