Privilegierung: SUBSYSTEM-MANAGEMENT
Funktionsbeschreibung
Mit der Anweisung PRINT-DOCUMENTATION können Lieferdokumentationen ausgedruckt werden. Gleichzeitig wird das geöffnete SCI aktualisiert, so dass bei nachfolgender Installation DISTRIBUTION-MEDIUM=*REGISTERED-MEDIUM gewählt werden kann.
Folgende Dokumentationen können ausgedruckt werden:
die Rückmeldung (eine Bestätigung der Lieferung für den System-Support)
das Lieferanschreiben (eine Beschreibung der Lieferinhalte)
die Freigabemitteilungen der Liefereinheiten
Erfolgt die Lieferung von einem Datenträger oder aus einer Bibliothek (DISTRIBUTION-MEDIUM= *TAPE/ *LIBRARY), wird die Lieferdokumentation in einer Bibliothek erstellt und gespeichert.
Format
PRINT-DOCUMENTATION | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
DOCUMENTATION =
Bestimmt die Dokumentation, die ausgedruckt werden soll.
DOCUMENTATION = *FROM-SOLIS2-DELIVERY(...)
Die Dokumentation entstammt einer SOLIS2-Lieferung.
PACKAGE-NAME = <alphanum-name 1..12>
Angabe des Pakets (wie in der Fußzeile des Lieferanschreibens angegeben).
USER-CODE = <alphanum-name 1..8>
Angabe des Kundenkennzeichens (wie in der Fußzeile des Lieferanschreibens angegeben).
DISTRIBUTION-MEDIUM =
Angabe des Liefermediums
DISTRIBUTION-MEDIUM = *REGISTERED-MEDIUM
Die Lieferinformation wird dem geöffneten SCI entnommen.
DISTRIBUTION-MEDIUM = *LIBRARY(...)
Die Lieferinformation wird aus der PLAM-Bibliothek mit dem Namen SOLFTR.<paketname>.<user-code> unter der Benutzerkennung SYSSAG gelesen.
<paketname> und <user-code> sind die Werte der Operanden PACKAGE-NAME und USER-CODE.
Die Liefereinheiten der Lieferung werden im geöffneten SCI registriert.
DOCUMENT-LIBRARY =
Name der Bibliothek, in der die Lieferdokumentation gespeichert wird.
Existiert die Bibliothek bereits, wird ihr Inhalt um die neue Lieferdokumentation
erweitert.
DOCUMENT-LIBRARY = *STD
Die Lieferdokumentation wird in der Bibliothek mit dem Standardnamen $<arbeitsdateikennung>.<paketname>.<kundenkennzeichen>.DOC gespeichert.
Dabei ist <paketname> der Wert des Operanden PACKAGE-NAME, <kundenkennzeichen> der Wert des Operanden USER-CODE und <arbeitsdateikennung> der aktuell eingestellte Ablageort für Arbeitsdateien (siehe Anweisung MODIFY-IMON-OPTIONS auf "MODIFY-IMON-OPTIONS IMON-Optionen auswählen ").
DOCUMENT-LIBRARY = <filename 1..54 without-gen-vers>
Explizite Angabe der Bibliothek.
REGISTRATION =
Gibt an, ob die Lieferung als eine bereits im SCI registrierte Lieferung oder als eine neue Lieferung behandelt werden soll.
REGISTRATION = *EXTEND
Die Lieferung wird wie eine bereits registrierte Lieferung behandelt. Soweit bereits Einträge für diese Lieferung im SCI existieren, dürfen diese nicht überschrieben werden.
REGISTRATION = *REPLACE
Die Lieferung wird wie eine neue Lieferung behandelt. Soweit bereits Einträge für diese Lieferung im SCI existieren, werden diese aus Lieferinformationen der gelieferten Bibliothek neu erstellt.
Hinweis
Alle Informationen über bereits installierte Liefereinheiten dieser Lieferung gehen verloren. Insbesondere stehen diese Liefereinheiten nicht mehr für eine Installation mit UNIT-NAME=*FROM-SCI zur Verfügung.
DISTRIBUTION-MEDIUM = *SOLIS2-VOLUME(...)
Die Lieferinformationen werden von einem mit Solis2 ausgelieferten Datenträger gelesen.
Sie werden vom Datenträger auf die aktuelle Benutzerkennung kopiert und im SCI registriert. Bereits existierende Dateien mit gleichem Namen werden überschrieben.
VOLUME = <vsn>
VSN des Datenträgers, der die Lieferinformation enthält.
DEVICE-TYPE = <device>
Gerätetyp des Datenträgers.
DOCUMENT-LIBRARY =
Name der Bibliothek, in der die Lieferdokumentation gespeichert wird. Existiert die Bibliothek bereits, wird ihr Inhalt um die neue Lieferdokumentation erweitert.
DOCUMENT-LIBRARY = *STD
Die Lieferdokumentation wird in der Bibliothek mit dem Standardnamen $<arbeitsdateikennung>.<paketname>.<kundenkennzeichen>.DOC gespeichert.
Dabei ist <paketname> der Wert des Operanden PACKAGE-NAME, <kundenkennzeichen> der Wert des Operanden USER-CODE und <arbeitsdateikennung> der aktuell eingestellte Ablageort für Arbeitsdateien (siehe Anweisung MODIFY-IMON-OPTIONS auf "MODIFY-IMON-OPTIONS IMON-Optionen auswählen ").
DOCUMENT-LIBRARY = <filename 1..54 without-gen-vers>
Explizite Angabe der Bibliothek.
REGISTRATION =
Gibt an, ob die Lieferung als eine bereits im SCI registrierte Lieferung oder als eine neue Lieferung behandelt werden soll.
REGISTRATION = *EXTEND
Die Lieferung wird wie eine bereits registrierte Lieferung behandelt werden. Soweit bereits Informationen über diese Lieferung im SCI existieren, dürfen diese nicht überschrieben werden.
REGISTRATION = *REPLACE
Die Lieferung wird wie eine neue Lieferung behandelt. Soweit bereits Einträge für diese Lieferung im SCI existieren, werden diese aus den vom Datenträger gelesenen Lieferinformationen neu erstellt.
Hinweis
Alle Informationen über bereits installierte Liefereinheiten dieser Lieferung gehen verloren. Insbesondere stehen diese Liefereinheiten nicht mehr für eine Installation mit UNIT-NAME=*FROM-SCI zur Verfügung.
DISTRIBUTION-MEDIUM = *LOCAL-VOLUME(...)
Die Lieferinformationen werden von einem vom Kunden erstellten Datenträger gelesen.
Sie werden vom Datenträger auf die aktuelle Benutzerkennung kopiert und im SCI registriert. Bereits existierende Dateien mit gleichem Namen werden überschrieben.
Für die Beschreibung der untergeordneten Operanden VOLUME, DEVICE-TYPE, DOCUMENT-LIBRARY und REGISTRATION gelten die entsprechenden Operandenbeschreibungen unter DISTRIBUTION-MEDIUM=*SOLIS2-VOLUME(...).
INFORMATION = *PARAMETERS(...)
Bestimmt, welche Dokumentation gedruckt wird.
RETURN-LETTER = *YES / *NO
Bestimmt, ob die Rückmeldung gedruckt werden soll.
DELIVERY-CONTENTS = *YES / *NO
Bestimmt, ob das Lieferanschreiben gedruckt werden soll.
RELEASE-NOTICES = *YES / *NO
Bestimmt, ob die Freigabemitteilung der Liefereinheiten gedruckt werden soll.
Hinweise
Arbeitsdateien
Die Funktion erzeugt Arbeitsdateien, die an dem in der Anweisung MODIFY-IMON-OPTIONS mit dem Operanden WORK-FILE-LOCATION definierten Ort abgelegt werden. Die Arbeitsdateien werden später wieder gelöscht.
Lieferinformationsdateien
Bei DISTRIBUTION-MEDIUM=*REGISTERED-MEDIUM wird der Ablageort der Lieferinformation dem SCI entnommen.
Bei DISTRIBUTION-MEDIUM=*SOLIS2-VOLUME/*LOCAL-VOLUME/*LIBRARY werden die Lieferinformationen von Datenträger/Bibliothek in die angegebene Dokumentationsbibliothek gebracht.
In folgenden Fällen wird die Anweisung mit Fehlermeldung zurückgewiesen:
Die Arbeitsdateikennung ist nicht zugreifbar oder besitzt nicht genügend Speicherplatz.
Es wurde DISTRIBUTION-MEDIUM=*REGISTERED-MEDIUM angegeben und im SCI gibt es keine SOLIS2-Lieferung mit dem angegebenen Paketnamen und Kundenkennzeichen.
Die Lieferinformation existiert nicht oder ist nicht zugreifbar:
Bei DISTRIBUTION-MEDIUM=*REGISTERED-MEDIUM existiert die Lieferinformationsdatei nicht oder ist nicht zugreifbar.
Bei DISTRIBUTION-MEDIUM=*SOLIS2-VOLUME/*LOCAL-Volume existiert der angegebene Datenträger oder das angegebene Gerät nicht oder ist nicht zugreifbar, oder die Lieferinformationsdatei kann nicht vom Datenträger auf die aktuelle Benutzerkennung gebracht werden.
Die Lieferinformation kann von IMON nicht erfolgreich bearbeitet werden.