Z-FIL11A

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

Ein Dokument in einem anderen Fach oder Ordner ablegen.

Dieses Subprogramm entspricht Z-FIL11X mit der Ausnahme, dass es zusätzliche Parameter enthält: Mit-Originalen-ablegen und Nur-neue-Suchbegriffe.

Sie können ein Dokument im Arbeitsfach oder einem beliebigen selbstdefinierten Fach ablegen. Sie können ein Dokument jedoch nicht im einem Systemfach wie z.B. Posteingang oder Tageskopien ablegen.

Sie können kein TRS-Fach und kein TRS-Dokument angeben. Um ein Dokument in einem TRS-Fach abzulegen, müssen Sie Z-TRS11 benutzen.

Wenn Sie Mit-Originalen-ablegen angeben, werden alle früheren Antworten auf dieses Dokument ebenfalls abgelegt. Antworten bei denen Datum und Uhrzeit später ist als Datum und Uhrzeit des Dokuments, das Sie gerade ablegen, werden nicht berücksichtigt. Deshalb sollten Sie immer darauf achten, dass Sie das aktuellste Objekt ablegen. Damit alle zusammen abgelegten Objekte leicht wieder gefunden werden können, sollten Sie für alle Objekte dieselben Suchbegriffe vergeben.

Wenn Sie das Dokument umbenennen wollen, ohne es in einem anderen Fach oder Ordner abzulegen, müssen Sie den Parameter Neuer-Dokumentname angeben. Die Parameter Neues-Fach und Neuer-Ordner dürfen Sie hierbei nicht angeben. Das Umbenennen ist nicht möglich, wenn Mit-Originalen-ablegen auch angegeben wurde.

Wenn Sie ein Dokument ablegen, das sich zur Zeit im Ordner Neu des Fachs Posteingang befindet, wird die dazugehörende Empfängerliste aktualisiert (d.h. der Empfangsstatus des Dokuments weist nun darauf hin, dass das Dokument gelesen wurde).

Parameter

Parameter Format Ein Aus Bemerkung
Return-Code N2 O X Eingabe -1: kein ET.
Buero A8 E   Das Büro, in dem sich das Dokument befindet, das Sie ablegen wollen.
Passwort A8 E   Das Passwort des o.g. Büros.
Dokumentname A32 E*   Der Name des Dokuments, das ablegt werden soll. Entweder Dokumentname oder ISN, nicht beides. Sie dürfen nicht den Namen eines TRS-Dokuments angeben.
ISN P10 E* X Die ISN des Dokuments, das ablegt werden soll. Eingabe: entweder ISN oder Dokumentname, nicht beides. Sie dürfen nicht die ISN eines TRS-Dokuments angeben. Vor dem Aufruf dieses Subprogramms können Sie Z-DIS11X aufrufen, um die ISN des gewünschten Dokuments auszugeben.
Neues-Fach A15 O   Das Fach, in dem das Dokument abgelegt werden soll. Sie dürfen kein TRS-Fach und kein Systemfach (außer dem Arbeitsfach) definieren.
Neuer-Ordner A15 O   Der Ordner im o.g. Fach, in dem das Dokument abgelegt werden soll.
Neuer-Dokumentname A32 O   Wenn angegeben, wird das Dokument unter einem neuen Namen abgelegt.
Suchbegriffe A15/1:6 O   Suchbegriffe sind hilfreich, wenn Sie ein Objekt suchen. Sie können bis zu 6 Suchbegriffe angeben. Ein Suchbegriff darf keinen Stern (*) enthalten. Sobald Sie einen neuen Suchbegriff angeben, werden alle vorher definierten Suchbegriffe gelöscht. Um die alten Suchbegriffe zu erhalten, müssen Sie sie in diesem Fall erneut angeben.
Nur-neue-Suchbegriffe A1 O   Wenn angegeben, werden alle Dokumente mit den Suchbegriffen abgelegt, die im Parameter Suchbegriffe angegeben wurden. Wenn nicht angegeben, werden alle Dokumente mit den Suchbegriffen abgelegt, die ursprünglich für sie definiert wurden.
Mit-Originalen-ablegen A1 O   Wenn angegeben, werden alle früheren Antworten auf dieses Dokument auch in dem Fach abgelegt, das im Parameter Neues-Fach angegeben wurde.

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
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
51 Ungültiger Name
52 Es existiert bereits ein Objekt mit dem angegebenen Namen
53 Das gewünschte Objekt existiert nicht
54 Mindestens ein Suchbegriff war ungültig
55 Das gewünschte Fach bzw. der gewünschte Ordner existiert nicht
56 Das gewünschte Fach ist ein TRS-Fach
90 Ein TRS-Dokument kann nicht in einem anderen Fach abgelegt werden
91 Umbenennen ist nicht möglich, wenn Mit-Originalen-ablegen angegeben wurde

Subprogramme

Z-120
Z-122
Z-123
Z-147
Z-150
Z-165
Z-175
Z-177
Z-190
Z-194
Z-197
Z-222
Z-223
Z-230
Z-400
Z-401
Z-1200&0

Beispiel

DEFINE DATA
LOCAL
*
1 RETURN-CODE            (N2)
1 BUERO                  (A8)
1 PASSWORT               (A8)
1 DOKUMENTNAME           (A32)
1 ISN                    (P10)
1 NEUES-FACH             (A15)
1 NEUER-ORDNER           (A15)
1 NEUER-DOKUMENTNAME     (A32)
1 SUCHBEGRIFFE           (A15/1:6)
1 NUR-NEUE-SUCHBEGRIFFE  (A1)
1 MIT-ORIGINALEN-ABLEGEN (A1)
*
END-DEFINE
*
MOVE 'Buero'          TO BUERO
MOVE 'Passwort'       TO PASSWORT
MOVE 'Dok-name1'      TO DOKUMENTNAME
MOVE 'Arbeitsfach'    TO NEUES-FACH
MOVE 'Ordner-Arbeit1' TO NEUER-ORDNER
MOVE 'Suchbegriff1'   TO SUCHBEGRIFFE(1)
MOVE 'Suchbegriff3'   TO SUCHBEGRIFFE(3)
MOVE 'X'              TO NUR-NEUE-SUCHBEGRIFFE
MOVE 'X'              TO MIT-ORIGINALEN-ABLEGEN
*
CALLNAT 'Z-FIL11A'
  RETURN-CODE
  BUERO
  PASSWORT
  DOKUMENTNAME
  ISN
  NEUES-FACH
  NEUER-ORDNER
  NEUER-DOKUMENTNAME
  SUCHBEGRIFFE (*)
  NUR-NEUE-SUCHBEGRIFFE
  MIT-ORIGINALEN-ABLEGEN
*
WRITE
  '='  BUERO                  /
  '='  PASSWORT               /
  '='  DOKUMENTNAME           /
  '='  ISN                    /
  '='  NEUES-FACH             /
  '='  NEUER-ORDNER           /
  '='  NEUER-DOKUMENTNAME     /
  '='  SUCHBEGRIFFE (*)       /
  '='  NUR-NEUE-SUCHBEGRIFFE  /
  '='  MIT-ORIGINALEN-ABLEGEN /
*
IF RETURN-CODE NE 0
  WRITE / 'Return-Code' RETURN-CODE
ELSE
  WRITE / 'Return-Status OK'
END-IF
*
END