Privilegierung: | SUBSYSTEM-MANAGEMENT, USER-ADMINISTRATION |
Funktionsbeschreibung
Mit der Anweisung INSTALL-UNITS werden die Liefereinheiten einer SOLIS2-Lieferung installiert und das geöffnete SCI mit den neuen Informationen aktualisiert. Beim Öffnen einer neuen Lieferung (d.h noch nicht im SCI registriert) wird die Lieferung im SCI registriert. Zu Einzelheiten zum Installationsvorgang siehe Abschnitt „Installieren".
Die Installation kann für START=*BY-USER bis einschließlich der Erstellung der Installationsprozedur unter einer beliebigen Benutzerkennung ausgeführt werden, die beide Privilegien besitzt. Die aktuelle Benutzerkennung muss dabei mit der Anweisung MODIFY-IMON-OPTIONS als WORK-FILE-LOCATION spezifiziert sein. Die Installationsprozedur muss danach unter TSOS gestartet werden.
Ausnahme: Wird von Datenträger installiert oder wird eine andere als die aktuelle Benutzerkennung bei der Installation bearbeitet, muss die gesamte Installation unter TSOS erfolgen.
Wird die Lieferung von einem Datenträger (Original bzw. vom Kunden erstellte Kopie) oder aus einer Bibliothek installiert (Operand DISTRIBUTION-MEDIUM= *SOLIS2-VOLUME/*LOCAL-VOLUME/*LIBRARY), wird die Lieferdokumentation in einer Bibliothek erstellt und gespeichert.
Bis zum nächsten Systemstart ist die installierte Software für die Anwender des Systems gesperrt (siehe auch Kommando LOCK-PRODUCT-VERSION, "Pfadnamen und Produktversionen verwalten (IMON-GPN) ").
Wird bei einer Installation ein Installation-Item einer „freigegebenen“ Liefereinheit verändert, setzt IMON das Freigabekennzeichen dieser Liefereinheit zurück (siehe auch Anweisung RESET-CUSTOMER-APPROVAL, Seite 407 (RESET-CUSTOMER-APPROVAL Freigabekennzeichen einer Liefereinheit zurücksetzen )).
Format
INSTALL-UNITS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
UNIT-NAME =
Auswahl der Liefereinheiten, die installiert werden sollen.
UNIT-NAME = *FROM-SOLIS2-DELIVERY(...)
Die Liefereinheiten entstammen einer SOLIS2-Lieferung.
PACKAGE-NAME = <alphanum-name 1..12>
Angabe des Paketnamens (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: entweder verwendet IMON die Information aus dem SCI oder das Liefermedium wird explizit angegeben.
DISTRIBUTION-MEDIUM = *REGISTERED-MEDIUM
Die Lieferinformation, die VSN und der Gerätetyp des gelieferten Datenträgers bzw. der Name der PLAM-Bibliothek werden dem geöffneten SCI entnommen. Bereits installierte Dateien werden dabei nicht nochmals vom Datenträger gelesen.
Eine Liefereinheit kann über die Funktionalität *REGISTERED-MEDIUM für das selbe System mehrmals neu installiert werden, da nun auch Liefereinheiten, die bereits im Status „Installiert" sind, erneut auswählbar sind (z. B. nach versehentlichem Löschen einer Datei der Liefereinheit). Zudem wird der Status „Installiert“ einer Liefereinheit jetzt nur noch im SCI des Systems eingetragen, in dem sie tatsächlich installiert ist.
DISTRIBUTION-MEDIUM = *LIBRARY(...)
Die Lieferung befindet sich in einer PLAM-Bibliothek mit dem Namen SOLFTR.<paketname>.<kundenkennzeichen> auf der Benutzerkennung SYSSAG. <paketname> und <kundenkennzeichen> sind die Werte der Operanden PACKAGE-NAME und USER-CODE.
Die Lieferinformationen werden aus der Bibliothek gelesen. Die ausgewählten Liefereinheiten werden aus der Bibliothek installiert und im SCI registriert.
DOCUMENT-LIBRARY =
Name der Bibliothek, in der die Lieferdokumentation gespeichert ist. 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 den 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 Lieferung befindet sich auf einem mit Solis2 ausgelieferten Datenträger (Magnetbandkassette, CD oder DVD). Die Lieferinformationen werden vom Datenträger gelesen. Es stehen alle Liefereinheiten der angegebenen Lieferung zur Auswahl.
Die ausgewählten Liefereinheiten 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 Lieferung enthält (siehe Lieferanschreiben).
DEVICE-TYPE = <device>
Gerätetyp des Datenträgers (siehe Lieferanschreiben).
DOCUMENT-LIBRARY =
Name der Bibliothek, in der die Lieferdokumentation gespeichert ist. 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 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 Lieferung befindet sich auf einem vom Kunden erstellten Datenträger (Magnetbandkassette oder virtuelles Volume in einem CentricStor). Die Datenträgerinformationen der Produktbewegungsdatei werden ignoriert. Es stehen alle Liefereinheiten der angegebenen Lieferung zur Auswahl. Die ausgewählten Liefereinheiten werden vom Datenträger auf die aktuelle Benutzerkennung kopiert und im SCI registriert. Bereits existierende Dateien mit gleichem Namen werden überschrieben.
Siehe auch „Erstellung eines LOCAL-VOLUME".
VOLUME = <vsn>
VSN des Datenträgers, der die Lieferung enthält.
DEVICE-TYPE = <device>
Gerätetyp des Datenträgers.
DOCUMENT-LIBRARY =
Name der Bibliothek, in der die Lieferdokumentation gespeichert ist. 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 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.
SUPPLY-UNITS =
Bestimmt die Liefereinheiten, die installiert werden sollen.
SUPPLY-UNITS = *ALL-REMAINING(...)
Aus der SOLIS2-Lieferung werden nur Liefereinheiten installiert, die sich nicht im Installationszustand Installed oder Being Installed befinden.
REPLACE-OLD-FILES =
Steuert, ob eine bereits existierende Datei bei der Installation überschrieben werden soll.
REPLACE-OLD-FILES = *YES
Existierende Dateien werden überschrieben.
REPLACE-OLD-FILES = *MINIMUM
Existierende Dateien werden nach Möglichkeit nicht überschrieben.
REPLACE-OLD-FILES = *NO
Existierende Dateien werden nicht überschrieben.
FORCE-LOCATION =
Steuert das Verhalten von IMON beim Placement von Release-Items, wenn die gewünschte Ablageort (bestimmt durch Katalog- und Benutzerkennung sowie ggf. Präfix) von der vorgeschriebenen Benutzerkennung oder Präfix der Release-Unit oder des Release-Items abweicht.
FORCE-LOCATION = *NO
Das Placement wird abgebrochen, wenn für die Release-Unit oder eines der Release-Items der Pfadname oder die Benutzerkennung fest vorgeschrieben ist. Anderenfalls wird der gewünschte Ablageort verwendet.
FORCE-LOCATION = *MINIMUM
Release-Units und -Items mit vorgeschriebener Benutzerkennung oder Präfix werden unter dem daraus resultierenden Pfadnamen abgelegt. Sonst werden die gewünschte Benutzerkennung bzw. Präfix verwendet.
FORCE-LOCATION = *YES
Der gewünschte Ablageort wird für die Release-Items verwendet. Vorgaben bezüglich Benutzerkennung oder Präfix werden ignoriert.
SUPPLY-UNITS = *COMPLETE-DELIVERY(...)
Alle Liefereinheiten der SOLIS2-Lieferung werden installiert.
REPLACE-OLD-FILES = *YES / *MINIMUM / *NO
Siehe Beschreibung bei SUPPLY-UNITS=*ALL-REMAINING(...) auf "INSTALL-UNITS Software installieren und registrieren ".
FORCE-LOCATION = *NO / *MINIMUM / *YES
Siehe Beschreibung bei SUPPLY-UNITS=*ALL-REMAINING(...) auf "INSTALL-UNITS Software installieren und registrieren ".
SUPPLY-UNITS = *BY-CONFIGURATION(...)
Die Liefereinheiten werden entsprechend der Konfiguration installiert.
Alle Liefereinheiten aus der Lieferung, die eine neuere oder dieselbe Version wie die bereits im System installierten haben, werden installiert.
Wenn die Liefereinheit nicht im System ist, wird ihre Installation übersprungen.
REPLACE-OLD-FILES = *YES / *MINIMUM / *NO
Siehe Beschreibung bei SUPPLY-UNITS=*ALL-REMAINING(...) auf "INSTALL-UNITS Software installieren und registrieren ".
FORCE-LOCATION = *NO / *MINIMUM / *YES
Siehe Beschreibung bei SUPPLY-UNITS=*ALL-REMAINING(...) auf "INSTALL-UNITS Software installieren und registrieren ".
SUPPLY-UNITS = *BY-DIALOG
Die Auswahlkriterien und die dazugehörigen Liefereinheiten werden interaktiv ausgewählt (siehe „Interaktive Auswahl von Liefereinheiten").
SUPPLY-UNITS = list-poss(30): <text 1..30 without-sep>(...)
Name der Liefereinheit, siehe "Liefereinheit (Supply-Unit) ".
VERSION =
Version der Liefereinheit.
VERSION = *HIGHEST-EXISTING
Die höchste Version der Liefereinheit wird verwendet.
VERSION = *ALL
Sämtliche Versionen der Liefereinheit werden verwendet.
VERSION = <product-version without-man-corr>
Versionsbezeichnung ohne Freigabe- und Korrekturstand.
CORRECTION-STATE =
Änderungsstand der Liefereinheit.
CORRECTION-STATE = *HIGHEST-EXISTING
Der höchste Änderungsstand der Liefereinheit wird verwendet.
CORRECTION-STATE = *ALL
Sämtliche Änderungsstände der Liefereinheit werden verwendet.
CORRECTION-STATE = *LOWEST-EXISTING
Der niedrigste Änderungsstand der Liefereinheit wird verwendet.
CORRECTION-STATE = list-poss(15): <alphanum-name 3..3>
Der Änderungsstand der Liefereinheit wird explizit angegeben.
Format: <aso>
REPLACE-OLD-FILES =
Steuert, ob eine bereits existierende Datei bei der Installation überschrieben werden soll.
REPLACE-OLD-FILES = *YES
Existierende Dateien werden überschrieben.
REPLACE-OLD-FILES = *MINIMUM
Existierende Dateien werden nach Möglichkeit nicht überschrieben.
REPLACE-OLD-FILES = *NO
Existierende Dateien werden nicht überschrieben.
FORCE-LOCATION =
Steuert das Verhalten von IMON beim Placement von Release-Items, wenn die gewünschte Ablageort (bestimmt durch Katalog- und Benutzerkennung sowie ggf. Präfix) von der vorgeschriebenen Benutzerkennung oder Präfix der Release-Unit oder des Release-Items abweicht.
FORCE-LOCATION = *NO
Das Placement wird abgebrochen, wenn für die Release-Unit oder eines der Release-Items der Pfadname oder die Benutzerkennung fest vorgeschrieben ist. Anderenfalls wird der gewünschte Ablageort verwendet.
FORCE-LOCATION = *MINIMUM
Release-Units und -Items mit vorgeschriebener Benutzerkennung oder Präfix werden unter dem daraus resultierenden Pfadnamen abgelegt. Sonst werden die gewünschte Benutzerkennung bzw. Präfix verwendet.
FORCE-LOCATION = *YES
Der gewünschte Ablageort wird für die Release-Items verwendet. Vorgaben bezüglich Benutzerkennung oder Präfix werden ignoriert.
UNIT-NAME = *FROM-SCI(...)
Die Liefereinheiten sind bereits in einem System installiert und im SCI registriert.
PACKAGE-NAME = <alphanum-name 1..12>
Angabe des Paketnamens (wie in der Fußzeile des Lieferanschreibens angegeben), auf den sich die Auswahl der Liefereinheiten beschränkt.
PACKAGE-NAME = *BY-SUPPLY-UNITS
Die Angabe ist nur möglich zusammen mit USER-CODE=*BY-SUPPLY-UNITS. Die Auswahl der Liefereinheiten erfolgt unabhängig vom Paketnamen über das geöffnete SCI.
USER-CODE = <alphanum-name 1..8>
Angabe des Kundenkennzeichens (wie in der Fußzeile des Lieferanschreibens angegeben), auf das sich die Auswahl der Liefereinheiten beschränkt.
USER-CODE = *BY-SUPPLY-UNITS
Die Angabe ist nur möglich zusammen mit PACKAGE-NAME=*BY-SUPPLY-UNITS.
Die Auswahl der Liefereinheiten erfolgt unabhängig vom Kundenkennzeichen über das geöffnete SCI.
SUPPLY-UNITS =
Bestimmt die Liefereinheiten, die installiert werden sollen.
SUPPLY-UNITS = *ALL(...)
Alle Liefereinheiten der SOLIS2-Lieferung werden installiert.
REPLACE-OLD-FILES =
Steuert, ob eine bereits existierende Datei bei der Installation überschrieben werden soll.
REPLACE-OLD-FILES = *YES
Existierende Dateien werden überschrieben.
REPLACE-OLD-FILES = *MINIMUM
Existierende Dateien werden nach Möglichkeit nicht überschrieben.
REPLACE-OLD-FILES = *NO
Existierende Dateien werden nicht überschrieben.
FORCE-LOCATION =
Steuert das Verhalten von IMON beim Placement von Release-Items, wenn die gewünschte Ablageort (bestimmt durch Katalog- und Benutzerkennung sowie ggf. Präfix) von der vorgeschriebenen Benutzerkennung oder Präfix der Release-Unit oder des Release-Items abweicht.
FORCE-LOCATION = *NO
Das Placement des Release-Items wird abgebrochen. Eine entsprechende Meldung wird ausgegeben.
FORCE-LOCATION = *MINIMUM
Release-Units und -Items mit vorgeschriebener Benutzerkennung oder Präfix werden unter dem daraus resultierenden Pfadnamen abgelegt. Sonst werden die gewünschte Benutzerkennung bzw. Präfix verwendet.
FORCE-LOCATION = *YES
Der gewünschte Ablageort wird für die Release-Items verwendet. Vorgaben bezüglich Benutzerkennung oder Präfix werden ignoriert.
SUPPLY-UNITS = *BY-DIALOG
Die Auswahlkriterien und die dazugehörigen Liefereinheiten werden interaktiv ausgewählt (siehe „Interaktive Auswahl von Liefereinheiten").
SUPPLY-UNITS = list-poss(30): <text 1..30 without-sep>(...)
Name der Liefereinheit, siehe "Liefereinheit (Supply-Unit) ".
VERSION =
Version der Liefereinheit.
VERSION = *HIGHEST-EXISTING
Die höchste Version der Liefereinheit wird verwendet.
VERSION = *ALL
Sämtliche Versionen der Liefereinheit werden verwendet.
VERSION = <product-version without-man-corr>
Versionsbezeichnung ohne Freigabe- und Korrekturstand.
CORRECTION-STATE =
Änderungsstand der Liefereinheit.
CORRECTION-STATE = *HIGHEST-EXISTING
Der höchste Änderungsstand der Liefereinheit wird verwendet.
CORRECTION-STATE = *ALL
Sämtliche Änderungsstände der Liefereinheit werden verwendet.
CORRECTION-STATE = *LOWEST-EXISTING
Der niedrigste Änderungsstand der Liefereinheit wird verwendet.
CORRECTION-STATE = list-poss(15): <alphanum-name 3..3>
Der Änderungsstand der Liefereinheit wird explizit angegeben (Format: <aso>).
REPLACE-OLD-FILES =
Steuert, ob eine bereits existierende Datei bei der Installation überschrieben werden soll.
REPLACE-OLD-FILES = *YES
Existierende Dateien werden überschrieben.
REPLACE-OLD-FILES = *MINIMUM
Existierende Dateien werden nach Möglichkeit nicht überschrieben.
REPLACE-OLD-FILES = *NO
Existierende Dateien werden nicht überschrieben.
FORCE-LOCATION =
Steuert das Verhalten von IMON beim Placement von Release-Items, wenn die gewünschte Benutzerkennung von der vorgeschriebenen Benutzerkennung der Release-Unit oder des Release-Items abweicht.
FORCE-LOCATION = *NO
Das Placement wird abgebrochen, wenn für die Release-Unit oder eines der Release-Items der Pfadname oder die Benutzerkennung fest vorgeschrieben ist. Anderenfalls wird der gewünschte Ablageort verwendet.
FORCE-LOCATION = *MINIMUM
Release-Units und -Items mit vorgeschriebener Benutzerkennung werden auf der vorgeschriebenen Benutzerkennung abgelegt. Sonst wird die gewünschte Benutzerkennung verwendet.
FORCE-LOCATION = *YES
Die gewünschte Benutzerkennung wird verwendet. Eine vorgeschriebene Benutzerkennung wird ignoriert.
UNIT-NAME = *CUSTOMER-APPROVED(...)
Die Liefereinheiten sind bereits in einem System installiert und im SCI registriert. Im Unterschied zur Installation mit UNIT-NAME=*FROM-SCI(...) werden nur Liefereinheiten ausgewählt, die ein Freigabekennzeichen besitzen. Für die ausgewählten Liefereinheiten wird dann eine Delta-Installation durchgeführt, d.h. es werden nur Installation-Items installiert, die im Zielsystem einen älteren Installations-Zeitstempel aufweisen.
PACKAGE-NAME = <alphanum-name 1..12>
Angabe des Paketnamens (wie in der Fußzeile des Lieferanschreibens angegeben), auf den sich die Auswahl der Liefereinheiten beschränkt.
PACKAGE-NAME = *BY-SUPPLY-UNITS
Die Angabe ist nur möglich zusammen mit USER-CODE=*BY-SUPPLY-UNITS.
Die Auswahl der Liefereinheiten erfolgt unabhängig vom Paketnamen über das geöffnete SCI.
USER-CODE = <alphanum-name 1..8>
Angabe des Kundenkennzeichens (wie in der Fußzeile des Lieferanschreibens angegeben), auf das sich die Auswahl der Liefereinheiten beschränkt.
USER-CODE = *BY-SUPPLY-UNITS
Die Angabe ist nur möglich zusammen mit PACKAGE-NAME=*BY-SUPPLY-UNITS.
Die Auswahl der Liefereinheiten erfolgt unabhängig vom Kundenkennzeichen über das geöffnete SCI.
SUPPLY-UNITS = *ALL(...) / *BY-DIALOG / list-poss(30): <text 1..30 without-sep>(...)
Bestimmt die Liefereinheiten, die installiert werden sollen. Für eine detaillierte Beschreibung der Operandenwerte siehe UNIT-NAME=*FROM-SCI(...).
SUPPLY-UNITS = *ALL(...)
Alle Liefereinheiten der SOLIS2-Lieferung, die ein Freigabekennzeichen besitzen, werden für die Delta-Installation ausgewählt.
REPLACE-OLD-FILES = *YES / *MINIMUM / *NO
Siehe Beschreibung von SUPPLY-UNITS=*ALL(...) unter UNIT-NAME=*FROM-SCI(...) auf "INSTALL-UNITS Software installieren und registrieren ".
FORCE-LOCATION = *NO / *MINIMUM / *YES
Siehe Beschreibung von SUPPLY-UNITS=*ALL(...) unter UNIT-NAME=*FROM-SCI(...) auf "INSTALL-UNITS Software installieren und registrieren ".
SUPPLY-UNITS = *BY-DIALOG
Die Auswahlkriterien und die dazugehörigen Liefereinheiten werden interaktiv ausgewählt (siehe „Interaktive Auswahl von Liefereinheiten").
SUPPLY-UNITS = list-poss(30): <text 1..30 without-sep>(...)
Name der Liefereinheit, siehe "Liefereinheit (Supply-Unit) ".
VERSION = *HIGHEST-EXISTING / *ALL / <product-version without-man-corr>
Version der Liefereinheit. Voreingestellt ist *HIGHEST-EXISTING, d.h. die höchste Version der Liefereinheit wird verwendet.
Mit *ALL werden sämtliche Versionen der Liefereinheit verwendet. Eine explizite Versionsangabe erfolgt ohne Freigabe- und Korrekturstand.
REPLACE-OLD-FILES = *YES / *MINIMUM / *NO
Siehe Beschreibung von SUPPLY-UNITS=*ALL(...) unter UNIT-NAME=*FROM-SCI(...) auf "INSTALL-UNITS Software installieren und registrieren ".
FORCE-LOCATION = *NO / *MINIMUM / *YES
Siehe Beschreibung von SUPPLY-UNITS=*ALL(...) unter UNIT-NAME=*FROM-SCI(...) auf "INSTALL-UNITS Software installieren und registrieren ".
TARGET-SYSTEM = *PARAMETERS(...)
Angaben zum Zielsystem, für das die Installation durchgeführt wird.
VERSION =
BS2000 Version des Zielsystems.
VERSION = *CURRENT
Die aktuelle BS2000-Version wird verwendet.
VERSION = <product-version without-man-corr>
Explizite Angabe der BS2000-Version.
Zulässige Eingaben: V19.0 / V20.0 /V 21.0
PUBSET =
Home-Pubset des Systems, für das installiert werden soll.
PUBSET = *DEFAULT
Es soll auf dem Home-Pubset des laufenden Systems unter der Standard-Katalogkennung der entsprechenden Benutzerkennung installiert werden.
PUBSET = *PARAMETERS(...)
Es soll auf einem importierten Pubset für ein anderes Zielsystem („Fremdsystem“) installiert werden.
CATID = <cat-id 1..4>
Katalogkennung des Pubsets, auf dem installiert werden soll.
DEFLUID =
System-Standardkennung des Zielsystems.
DEFLUID = *STD
Als System-Standardkennung wird die des aktuellen Systems verwendet, wenn die Parameterdatei keinen „PVS-INFO“-Parameter für den angegebenen Pubset des Zielsystems enthält. Im anderen Fall wird die Katalogkennung verwendet, die im „PVS-INFO“-Parameter für den angegebenen Pubset des Zielsystems vereinbart ist. Zu Einzelheiten siehe Abschnitt „IMON-Parameterdatei für Default-Installationsparameter".
DEFLUID = <name 1..8>
Explizite Angabe der System-Standardkennung des Zielsystems.
PROCESSOR-TYPE =
Bestimmt den Hardware-Typ des Zielsystems für die Installation von hardware-abhängigen Release-Items.
PROCESSOR-TYPE = *STD
Es gilt der Wert, der im „PVS-INFO“-Parameter für den Hardware-Typ des Zielsystems vereinbart ist (Einzelheiten siehe im Abschnitt „IMON-Parameterdatei für Default-Installationsparameter" ). Ohne Vereinbarung ist der Wert abhängig von der Zielsystem-Version (siehe Operand VERSION):
Zielsystem-Version | die Voreinstellung *STD entspricht |
BS2000 V19.0 – V21.0 | *ANY; alle Werte sind zulässig (*CISC-390, *X86) |
PROCESSOR-TYPE = *CISC-390
Das Zielsystem läuft auf einer /390-Anlage. Es werden nur die Release-Items installiert, die das Kennzeichen TARGET=A (hardware-unabhängig) oder das Kennzeichen TARGET=S (/390-Ausprägung) besitzen.
PROCESSOR-TYPE = **X86
Es werden nur die Release-Items installiert, die das Kennzeichen TARGET=A (hardware-unabhängig) oder das Kennzeichen TARGET=K (X86-Ausprägung) besitzen.
PROCESSOR-TYPE = *ANY
Es werden die Release-Items installiert, deren Hardware-Ausprägung in der Zielsystemversion unterstützt wird.
Zielsystem-Version | unterstützter Hardware-Typ |
BS2000 V19.0 – V21.0 | *CISC-390 und *X86 |
ITEM-SELECTION =
Bestimmt, ob nur Release-Items installiert werden, die für die angegebene Zielsystem- Version (siehe Operand VERSION) bestimmt sind.
ITEM-SELECTION = *STD
Es gilt der Wert, der im „PVS-INFO“-Parameter für den angegebenen Pubset des Zielsystems vereinbart ist (Einzelheiten siehe im Abschnitt „IMON-Parameterdatei für Default-Installationsparameter" ). Ohne Vereinbarung gilt *TARGET-VERSION-ONLY.
ITEM-SELECTION = *ALL
Es werden alle Release-Items unabhängig von der Zielsystem-Version installiert.
ITEM-SELECTION = *TARGET-VERSION-ONLY
Es werden nur Release-Items installiert, die für die angegebene Zielsystem-Version bestimmt sind. Für andere Zielsystem-Versionen bestimmte Release-Items werden nicht installiert (betrifft vor allem die Item-Typen SSC, SSD, MSV, SDF, *DA, REP).
OLD-FILE-SAVING = *STD / *NO / *WITH-LMS / *WITH-ARCHIVE(...)
Bestimmt, ob die Dateien, die durch die Installation überschrieben werden, vorher gesichert werden sollen.
OLD-FILE-SAVING = *STD
Es gilt der Wert, der im „OLD-FILE-SAVING“-Parameter für den angegebenen Pubset des Zielsystems vereinbart ist (Einzelheiten siehe im Abschnitt „IMON-Parameterdatei für Default-Installationsparameter" ). Ohne Vereinbarung gilt *NO.
OLD-FILE-SAVING = *NO
Die Dateien werden nicht gesichert.
OLD-FILE-SAVING = *WITH-LMS
Die Dateien werden mit LMS/LMSCONV in eine Bibliothek gesichert. Der Name der Sicherungsbibliothek ist $<arbeitsdateikennung>.IMON.SAVE.LIB.<paketname>.<kundenkennzeichen>. Dabei ist <paketname> der Wert des Operanden PACKAGE-NAME, <kundenkennzeichen> der Wert des Operanden USER-CODE und <arbeitsdateikennung>
die aktuell eingestellte Arbeitsdateikennung (siehe Anweisung MODIFY-IMON-OPTIONS).
OLD-FILE-SAVING = *WITH-ARCHIVE(...)
Die Dateien werden mit ARCHIVE gesichert.
VOLUME = <vsn> / *FROM-OPERATOR(...)
VSN des Datenträgers, auf den mit ARCHIVE gesichert werden soll.
VOLUME = *FROM-OPERATOR(...)
Das Subsystem MAREN wählt automatisch die VSN eines freien Datenträgers aus. Ist das Subsystem MAREN nicht geladen, wird die Anweisung mit der Meldung IMO0449 abgewiesen.
LOCATION = *STD / <alphanum-name 1..8>
Name des Lagerortes, aus dem der freie Datenträger ausgewählt werden soll.
Voreingestellt ist *STD, d.h. die ARCHIVE-Sicherung wird ohne MAREN-Unterstützung mit den Default-Einstellungen von ARCHIVE durchgeführt.
DEVICE-TYPE = <device>
Gerätetyp des Datenträgers.
PASSWORD-FILE =
Bestimmt, ob Kennwörter, die zum Überschreiben einer Datei während der Installation nötig sind, aus einer Datei gelesen werden. Im Fehlerfall wird die Installation abgebrochen.
PASSWORD-FILE = *NO
Es sind keine Kennwörter in einer Datei hinterlegt.
PASSWORD-FILE = <filename 1..54 without-gen-vers>(...)
Name der Datei, die alle ADD-PASSWORD-Kommandos für die geschützten Dateien enthält. Diese Kommandos werden in die Installationsprozedur integriert. Sie müssen syntaktisch korrekt sein.
READ-PASSWORD = <c-string 1..4>
Lesekennwort der Kennwort-Datei.
LOG-PRINTING = *STD / *NO / *YES
Bestimmt, ob die Installationsprotokolle gedruckt werden.
LOG-PRINTING = *STD
Es gilt der Wert, der im „PRINT-LOG-FILES“-Parameter für den angegebenen Pubset des Zielsystems vereinbart ist (Einzelheiten siehe im Abschnitt „IMON-Parameterdatei für Default-Installationsparameter" ). Ohne Vereinbarung gilt *NO.
PLACEMENT-MODE =
Bestimmt den Ablageort der Installation-Items.
PLACEMENT-MODE = *STD
Die Voreinstellungen für den Ablageort, für das Überschreiben von existierenden Dateien und für das Verhalten bei Konflikten in der Benutzerkennung werden verwendet.
PLACEMENT-MODE = *BY-DIALOG
Angaben zum „Customizing“ und wahlfreie Angaben zum Ablageort der Installation-Items der Liefereinheit werden über Dialogmasken erfragt (ähnlich wie Bild 27 (Menü Bearbeiten )).
Wenn in der Dialogmaske „Liefereinheiten Anordnungsparameter“ in der Spalte „Userid“ die Zeichenfolge *RU für eine Liefereinheit angegeben wird, erscheint eine Folgemaske, in der die Angaben speziell für die Release-Units der Liefereinheit eingestellt werden können.
Die Angaben für Release-Unit haben Vorrang vor denen der Liefereinheit.
Datei Ersatz
Steuert, ob eine bereits existierende Datei bei der Installation überschrieben werden soll. Mögliche Eingaben sind:
Y M N | Existierende Dateien werden überschrieben. Existierende Dateien werden nach Möglichkeit nicht überschrieben. Existierende Dateien werden nicht überschrieben. |
Abl.Ort zwingen
Steuert das Verhalten von IMON beim Placement von Release-Items, wenn die gewünschte Benutzerkennung von der vorgeschriebenen Benutzerkennung der Release-Unit oder des Release-Items abweicht. Mögliche Eingaben sind:
N | Das Placement wird abgebrochen, wenn für die Release-Unit oder eines der Release-Items der Pfadname oder die Benutzerkennung fest vorgeschrieben ist. Anderenfalls wird der gewünschte Ablageort verwendet. |
M | Release-Units und -Items mit vorgeschriebener Benutzerkennung oder Präfix werden unter dem daraus resultierenden Pfadnamen abgelegt. Sonst wird die gewünschte Benutzerkennung bzw. Präfix verwendet. |
Y | Der gewünschte Ablageort wird für die Release-Items verwendet. Vorgaben bezüglich Benutzerkennung oder Präfix werden ignoriert. |
Bibliothek
Bestimmt das IMON-Verhalten für die Bibliotheken der Liefereinheiten. Mögliche Eingaben sind:
Y | Die Bibliotheken der Liefereinheiten werden auf dem Zielsystem unter ihrem Originalnamen katalogisiert. Zusätzlich werden ihre Elemente über IMON in alternative Bibliotheken eingemischt. |
N | Die Bibliotheken der Liefereinheiten werden im Zielsystem nur unter ihrem Orginalnamen katalogisiert. |
| - | Die Liefereinheit enthält keine Bibliotheksdatei. |
Call/Enter
Steuert, ob Installation-Items vom Typ DO oder ENT bei der Installation gestartet werden sollen. Mögliche Eingaben sind:
Y N | Das Item wird gestartet. Das Item wird nicht gestartet. |
ACTIVATION-MODE = *STD / *PARAMETERS(...)
Bestimmt, welche Installation-Items bei Ablauf der Installationsprozedur für die spätere Aktivierung vorbereitet werden sollen.
ACTIVATION-MODE = *STD
Für jeden Aktivierungsprozess gilt der Wert, der im entsprechenden Parametersatz (SDF-PROCESSING, MIP-PROCESSING,...) deklariert wurde. Wenn keine Deklaration angegeben ist, gilt *CFG (für POSIX-PROCESSING) oder *YES (für die anderen). Zu Einzelheiten siehe Abschnitt „IMON-Parameterdatei für Default-Installationsparameter".
ACTIVATION-MODE = *PARAMETERS(...)
Auswahl der zu bearbeitenden Installation-Items über Dialogmasken (ähnlich wie Bild 29 "Menü Bearbeiten ").
SYNTAX-FILE-PROCESS = *BY-DIALOG / *NO / *YES
Bestimmt, ob Syntaxdateien bei Ablauf der Installationsprozedur bearbeitet werden sollen. Die nötigen Angaben werden über Dialogmasken erfragt.
SDF-Param-Datei
Name der SDF-Parameterdatei.
MESSAGE-FILE-PROCESS = *BY-DIALOG / *NO / *YES
Bestimmt, ob Meldungsdateien bei Ablauf der Installationsprozedur bearbeitet werden sollen. Die nötigen Angaben werden versionsabhängig über Dialogmasken erfragt.
MIP-Param-Datei
Name der MIP-Parameterdatei.
MES-Datei
Name der Meldungsdatei, in welche die Meldungsdateien der Subsysteme mit CREATION-TIME=BEFORE-DSSM-LOAD bzw. AT-DSSM-LOAD gemischt werden sollen.
DSSM-PROCESSING = *BY-DIALOG / *NO / *YES
Bestimmt, ob der statische DSSM-Subsystemkatalog bei Ablauf der Installationsprozedur bearbeitet werden soll. Die nötigen Angaben werden über Dialogmasken erfragt.
Der neue DSSM-Subsystemkatalog wird erst im nächsten Systemlauf aktiviert.
Katalogname
Bestimmt, welcher statische DSSM-Subsystemkatalog bearbeitet wird. Ohne Angabe wird der Standardname des statischen Katalogs verwendet.
|
Alte Versionen behalten: Ja / Nein
Bestimmt für Subsysteme, die ein Entfernen erlauben, ob alte Versionen der bearbeiteten Subsysteme im DSSM-Subsystemkatalog verbleiben oder daraus entfernt werden sollen.
REP-PROCESSING = *BY-DIALOG / *NO / *YES
Bestimmt, wie das RMS-Depot bei Ablauf der Installationsprozedur bearbeitet werden soll.
REP-PROCESSING = *BY-DIALOG
Die nötigen Angaben werden über Dialogmasken erfragt.
RMS-Verarbeitung: 1. Depot+Lader 2. Nur Depot 3.Nein
Bestimmt die Art der Verarbeitung der RMS-Daten.
Bei Nur Depot werden die RMS-Daten in das RMS-Depot übernommen.
Bei Depot+Lader werden zusätzlich die Rep-Lader erstellt.
Bei Nein erfolgt kein Depot-Update und keine Erstellung von Rep-Ladern.
Ablageort des RMS-Depots: 1. Standard 2. Erzwungen
Bestimmt den Namen des RMS-Depots für die Datenübernahme und das Erstellen der REP-Lader.
Bei Standard wird dabei für geparkte Software das RMS-Depot benutzt, das beim Parken angegeben worden war. Sonst wird das unter „Ablageort“ angegebene RMS-Depot verwendet.
Bei Erzwungen wird stets das unter „Ablageort“ angegebene RMS-Depot verwendet.
Ablageort: [:<catid>:]$[<userid>].
Bestimmt die Katalog- und/oder die Benutzerkennung, unter der das RMS-Depot liegt.
Standarddateiname ist „RMS.DEPOT“.
REP-PROCESSING = *NO
Die RMS-Dateien werden nicht bearbeitet. Es wird kein Depot-Update ausgeführt.
Es werden keine REP-Lader erstellt.
Hinweis
Bei fehlenden REP-Ladern kann das System u.U. kein „System Ready“ erreichen.
POSIX-PROCESSING = *BY-DIALOG / *BY-CONFIGURATION-FILE / *NO / *ALL
Legt fest, ob POSIX-Satelliten bei der Installation (als Installationsaufrufe in POSIX) verarbeitet werden müssen. *BY-CONFIGURATION-FILE/*ALL kann selbst dann angegeben werden, wenn die POSIX-Konfigurationsdatei nicht existiert.
POSIX-PROCESSING = *BY-DIALOG
Aktivierungsparameter werden interaktiv über eine weiteres, spezifisches Dialogfeld abgefragt.
POSIX-PROCESSING = *BY-CONFIGURATION-FILE / *NO / *ALL
Legt fest, ob die POSIX-Verarbeitung durchgeführt werden soll oder nicht.
POSIX-PROCESSING =*BY-CONFIGURATION-FILE
Keine kundenspezifische Aktivierung. POSIX-Satelliten werden nur verarbeitet, wenn das zugehörige Produkt bereits in der POSIX-Konfigurationsdatei registriert ist.
POSIX-PROCESSING =*NO
Keine Verarbeitung von POSIX-Satelliten.
POSIX-PROCESSING =*ALL
Jeder POSIX-Satellit wird verarbeitet. Der alte Wert "Yes" wird wie "All" behandelt..
START = *IMMEDIATELY / *BY-USER
Bestimmt, ob die Installationsprozedur sofort automatisch oder durch den Benutzer gestartet wird. Der Prozedurname wird nach der Generierung der Datei bzw. beim automatischen Start gemeldet (Start mit dem Job-Namen INSTALL).
START = *IMMEDIATELY
Die Installationsprozedur wird sofort automatisch gestartet.
START = *BY-USER
Der Installationsvorgang (Placement und Activation) wird durch das Starten der Installationsprozedur eingeleitet (ENTER-PROCEDURE-Kommando). Der Ablauf der Installationsprozedur im Dialog (CALL-PROCEDURE-Kommando) ist möglich, aber zeitaufwendig.
WORK-FILE-DELETING = *STD / *YES / *NO
Bestimmt, ob nicht mehr benötigte Dateien der Installation (Dateien der geparkten Release-Items und SYSRMS-Dateien) gelöscht werden.
WORK-FILE-DELETING = *STD
Es gilt der Wert, der im „WORK-FILE-DELETING“-Parameter für den angegebenen Pubset des Zielsystems vereinbart ist (Einzelheiten siehe im Abschnitt „IMON-Parameterdatei für Default-Installationsparameter" ). Ohne Vereinbarung gilt *YES.
WORK-FILE-DELETING = *YES
Die genannten Dateien werden nach fehlerfreier Bearbeitung gelöscht.
WORK-FILE-DELETING = *NO
Die Dateien werden nach der Installation nicht gelöscht. Geparkte Software kann somit mehrfach installiert werden.
UNDO-PREPARATION = *STD / *NO / *PARAMETERS(...)
Bestimmt, ob alle Metadaten, die zur Wiederherstellung des ursprünglichen Zustands vor der Installation (Undo-Funktion, siehe Anweisung UNDO-SUPPLY-UNITS) benötigt werden, in eigenen Dateien (Undo-Dateien) gesichert werden.
UNDO-PREPARATION = *STD
Es gilt der Wert, der im „UNDO-PREPARATION“-Parameter für den angegebenen Pubset des Zielsystems vereinbart ist (Einzelheiten siehe im Abschnitt „IMON-Parameterdatei für Default-Installationsparameter" (IMON-Parameterdatei für Default-Installationsparameter )). Ohne Vereinbarung gilt *NO.
UNDO-PREPARATION = *PARAMETERS(...)
Die Metadaten werden in Undo-Dateien gesichert.
RETENTION-PERIOD = 30 / <integer 0..999 days>
Gibt an, nach wieviel Tagen die erzeugten Undo-Dateien geändert oder gelöscht werden dürfen. Voreingestellt ist eine Schutzfrist von 30 Tagen.
SAVE-MEDIUM = *ARCHIVE-DIRECTORY(...) / *TAPE(...) / *LIBRARY
Bestimmt die Datenträger, die zur Sicherung mit ARCHIVE verwendet werden.
SAVE-MEDIUM = *ARCHIVE-DIRECTORY(...)
Die zu verwendenden Datenträger werden in einem ARCHIVE-Directory verwaltet.
Daraus wird ein entsprechender freier Datenträger verwendet.
NAME = <filename 1..54 without-gen-vers>
Name des ARCHIVE-Directory.
DEVICE-TYPE = <device>
Gerätetyp des Datenträgers.
SAVE-MEDIUM = *TAPE(...)
Der zu verwendende Datenträger wird explizit angegeben.
VOLUME = <vsn>
VSN des Datenträgers.
DEVICE-TYPE = <device>
Gerätetyp des Datenträgers.
SAVE-MEDIUM = *LIBRARY
Die Dateien werden mit LMS/LMSCONV in eine Bibliothek gesichert. Der Name der Sicherungsbibliothek ist $<arbeitsdateikennung>.IMON.UNDO.LIB.<paketname>. Dabei ist <paketname> der Wert des Operanden PACKAGE-NAME und <arbeitsdateikennung> die aktuell eingestellte Arbeitsdateikennung (siehe Anweisung MODIFY-IMON-OPTIONS auf "MODIFY-IMON-OPTIONS IMON-Optionen auswählen ").
CHECK-CONFIGURATION = *STD / *NO / *YES
Bestimmt, ob die Software-Konfiguration überprüft wird.
CHECK-CONFIGURATION = *STD
Es gilt der Wert, der im „CHECK-CONFIGURATION“-Parameter für den angegebenen Pubset des Zielsystems vereinbart ist (Einzelheiten siehe im Abschnitt „IMON-Parameterdatei für Default-Installationsparameter"). Ohne Vereinbarung gilt *YES.
PARAMETER-FILE = *STD / *NO / <filename 1..54 without-gen-vers>
Bestimmt, ob eine IMON-Parameterdatei, die vordefinierte Default-Werte für einige Installationsparameter enthält, verwendet wird. Zu Einzelheiten siehe Abschnitt „IMON-Parameterdatei für Default-Installationsparameter" .
Unabhängig davon wird die optional vorhandene kundenspezifische IMON-Parameterdatei $SYSPAR.IMON.<kkz> bzw. die Datei $TSOS.SYSPAR.IMON immer ausgewertet (siehe Abschnitt „IMON-Parameterdatei für optionale Installationsfunktionen").
PARAMETER-FILE = *STD
Soweit vorhanden werden die Standard-Parameterdateien $TSOS.SYSPAR.IMON.LAST und die kundenspezifische Parameterdatei $TSOS.SYSPAR.IMON.<kkz> bzw. $TSOS.SYSPAR.IMON verwendet. Bei Einträgen, die in beiden Dateien enthalten sind, wird der Wert aus der Parameterdatei $TSOS.SYSPAR.IMON.LAST genommen.
PARAMETER-FILE = *NO
Die Parameterdatei $TSOS.SYSPAR.IMON.LAST wird ignoriert. Die kundenspezifische Parameterdatei $TSOS.SYSPAR.IMON.<kkz> bzw. die Datei $TSOS.SYSPAR.IMON wird immer ausgewertet.
PARAMETER-FILE = <filename 1..54 without-gen-vers>
Angabe einer benutzerspezifischen Parameterdatei. Zusätzlich wird die Parameterdatei $TSOS.SYSPAR.IMON.<kkz> oder $TSOS.SYSPAR.IMON ausgewertet. Die Parameterdatei $TSOS.SYSPAR.IMON.LAST wird ignoriert.
Hinweise
Lieferinformationsdateien:
Bei DISTRIBUTION-MEDIUM=*SOLIS2-VOLUME/*LOCAL-VOLUME werden die Lieferinformationen vom Datenträger auf den Ablageort für Arbeitsdateien abgelegt. Bereits bestehende Dateien mit gleichen Namen werden überschrieben.
Bei DISTRIBUTION-MEDIUM=*REGISTERED-MEDIUM wird das Liefermedium (*SOLIS2-VOLUME/*LOCAL-VOLUME/*LIBRARY) und die bei *SOLIS2-Volume/*LOCAL-VOLUME zusätzlich anzugebenden Werte für VOLUME und DEVICE-TYPE aus dem SCI wiederhergestellt. Durch die abgelegten Lieferinformationen können bereits katalogisierte Dateien verwendet werden, um Zugriffe auf Datenträger/Bibliothek zu sichern.
Die Rückmeldung für den Systems Support wird jedesmal automatisch ausgedruckt, wenn das Öffnen der Lieferung vom Liefermedium (*SOLIS2-VOLUME/*LOCAL-VOLUME/*LIBRARY) erfolgt.
Bei DISTRIBUTION-MEDIUM=*LOCAL-VOLUME wurde die Lieferung bereits auf einem anderen Datenträger (z.B. virtuelles Volume eines CentricStor) gespeichert. In diesem Fall werden die angegebene VSN und Device-Typ für den Zugriff auf die Installationsdateien verwendet und die Angaben aus der Produktbewegungsdatei ignoriert. Es können jedoch nur Dateien von dem angegebenen Volume verarbeitet werden.
Beim Öffnen einer neuen SOLIS2-Lieferung mit INSTALL-UNITS, PARK- UNITS oder PRINT-DOCUMENTATION wird die Lieferung im SCI registriert und die für die laufende IMON-Version benötigten Arbeitsdateien (z.B. SOLPAR.IMON.<ver>.GEN) werden auf die Arbeitsdateikennung übernommen.
Wird eine bereits registrierte SOLIS2-Lieferung geöffnet und die gleiche Arbeitsdateikennung verwendet, dann verwendet die laufende IMON-Version die bereits abgelegten Lieferinformationen und Arbeitsdateien (z. B. SOLPAR.IMON.<ver>.GEN), um Zugriffe auf das Liefermedium (Datenträger/Bibliothek) einzusparen.
IMON kann auch die Musterprozedur SOLPAR.IMON.<ver>.GEN einer älteren IMON-Version verarbeiten. In diesem Fall stehen die Funktionen aus der neuen Musterprozedur nicht zur Verfügung.
Deshalb ist beim Wechsel der IMON-Version Folgendes zu beachten:
Wenn für den Wechsel der IMON-Version die Liefereinheit BS2GA.IMON installiert wurde, befindet sich noch die alte Musterprozedur auf der Arbeitskennung.
Sollen mit der neuen IMON-Version weitere Liefereinheiten (von derselben Lieferung mit demselben SCI und derselben Arbeitsdateikennung) installiert oder geparkt werden, muss die Liefereinheit BS2GA.IMON mit der neuen IMON-Version nochmal installiert werden (diesmal mit REGISTRATION=*REPLACE). Nur in diesem Fall wird Datei SOLPAR.IMON.<ver>.GEN der neuen IMON-Version von der Lieferung auf die Arbeitsdateikennung übernommen.
Software-Erweiterungen von IMON V3.3A (*NP Item-Typ, POSIX-PROCESSING = *BY-CONFIGURATION-FILE) werden von früheren IMON-Versionen ignoriert. Deshalb müssen die SOLIS-Lieferungen, die Release Item vom Typ *NP enthalten, die AUSGEN Prozedur von IMON V3.3A enthalten und mit IMON V3.3A installiert werden.
Operand UNIT-NAME=*FROM-SCI(...):
Mit dieser Funktionalität kann eine Liefereinheit, die bereits auf einem Testsystem installiert und getestet wurde, in das Produktivsystem übertragen und installiert werden. Voraussetzung ist, dass alle Original-Installationsdateien (insbesondere die Produktbewegungsdatei A.SOLIS.B.<paketname>.<kundenkennzeichen>) auf der Arbeitsdateikennung vorhanden sind. Diese Installationsart bietet dieselben Installationsfunktionen wie eine Standardinstallation (aus einer SOLIS2-Lieferung), unterscheidet sich aber in folgenden Punkten:
Als Zielsystem-Version kann nur die Version angegeben werden, für die die Liefereinheit bereits installiert wurde.
Die Installationsdateien werden aus dem bereits installierten System kopiert.
Die RMS-Dateien werden nicht bearbeitet. Es wird kein Depot-Update ausgeführt und es werden auch keine REP-Lader erstellt. Die REP-Lader werden aus dem bereits installierten System kopiert.
Operand UNIT-NAME=*CUSTOMER-APPROVED(...):
Im Gegensatz zu UNIT-NAME=*FROM-SCI(...) werden nur Liefereinheiten ausgewählt, die ein Freigabekennzeichen besitzen. Das Freigabekennzeichen setzt der Kunde mit der Anweisung SET-CUSTOMER-APPROVAL um die Liefereinheit mit einem definierten Qualitätsstandard zur Installation in Produktivsystemen freizugeben. Bei Installationsvorgängen, die ein Installations-Item einer freigegebenen Liefereinheit verändern, setzt IMON das Freigabekennzeichen wieder zurück. Für die freigebenen Liefereinheiten wird dann eine Delta-Installation durchgeführt, d.h. es werden nur Installation-Items installiert, die im Zielsystem einen älteren Installations-Zeitstempel aufweisen.
Die Installation kann nur erfolgen, wenn für alle ausgewählten Liefereinheiten folgende Bedingungen erfüllt sind:
Das Änderungsdatum der Liefereinheit muss vor dem Freigabezeitpunkt (Zeitstempel des Freigabekennzeichens) liegen.
Die Installation auf dem Quell-Pubset muss nach der Installation auf dem Ziel-Pubset erfolgt sein.
Der Korrekturstand auf dem Quell-Pubset muss höher als der auf dem Ziel-Pubset sein.
Die Produktbewegungsdateien müssen auf der Arbeitsdateikennung verfügbar sein.
Bei der Installation entfällt die RMS-Verarbeitung. Es werden nur die REP-Lader vom Quell-Pubset in das Zielsystem kopiert.
Diese Installationsfunktion sollte nur genutzt werden, wenn die Installation auf Quell-und Ziel-Pubset für dieselbe Ziel-Version bestimmt ist.
Operand DELIVERY-MEDIUM=*REGISTERED-MEDIUM:
Die Dateien einer neuen Lieferung können bereits bestehende Dateien überschreiben, und diese Dateien können sich von einer Lieferung zur anderen unterscheiden. Wird die Anweisung mit dem Operanden DELIVERY-MEDIUM=*REGISTERED-MEDIUM aufgerufen, kann es zu Problemen kommen, wenn die katalogisierten Lieferinformationen
nicht zur Lieferung passen. In diesem Fall sollte vom Datenträger gelesen werden.
Operand FORCE-LOCATION:
Bei FORCE-LOCATION=*MINIMUM werden, wenn nötig, die vorgeschriebenen Benutzerkennungen verwendet. Eine Benutzerkennung und ein Präfix, die bei einer Nicht-standard-Installation angegeben werden, werden für andere Items verwendet. DerBenutzer muss damit rechnen, dass seine Items nicht unbedingt unter dem angegebenen
Ablageort erscheinen.
Bei FORCE-LOCATION=*YES werden vorgeschriebene Benutzerkennung und Präfix ignoriert. Eine Benutzerkennung und ein Präfix, die bei einer Nichtstandard-Installation angegeben werden, werden für alle Items verwendet. Die Ablauffähigkeit der installierten Produkte ist nicht garantiert.
In folgenden Fällen wird die Anweisung ohne Aktion zurückgewiesen und eine Fehlermeldung ausgegeben:
Im Batchmodus wurde der Wert *BY-DIALOG angegeben.
Die Zielsystemversion ist nicht [V]19.0, [V]20.0 oder [V]21.0.
Die mit MODIFY-IMON-OPTIONS als Ablageort für Arbeitsdateien angegebene Benutzerkennung 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-MEDUM existiert die Lieferinformationsdatei nicht oder ist nicht zugreifbar.
Bei DISTRIBUTION-MEDUM=*SOLIS2-VOLUME/*LOCAL-VOLUME existiert der angegebene Datenträger oder das angegebene Gerät nicht bzw. ist nicht zugreifbar, oder die Lieferinformationsdatei kann nicht vom Datenträger auf die aktuelle Benutzerkennung gebracht werden.
Bei DISTRIBUTION-MEDIUM=*LIBRARY existiert die entsprechende PLAM-Bibliothek nicht auf der aktuellen Benutzerkennung bzw. ist nicht zugreifbar, oder die Lieferinformationsdatei kann nicht aus der Bibliothek auf die aktuelle Benutzerkennung geholt werden.
Die Lieferinformation kann von IMON nicht erfolgreich bearbeitet werden.
Die zur angegebenen SOLIS2-Lieferung oder zur registrierten SOLIS2-Lieferung gehörende Produktbewegungsdatei enthält keine der Liefereinheiten, die vom Benutzer angegeben wurden.
Die angegebene Parameterdatei existiert nicht, kann nicht geöffnet werden oder liegt im falschen Format vor.
Eine Installationsprozedur wurde bereits für eine oder mehrere der vom Benutzer angegebenen Liefereinheiten erzeugt. Der Installationsstatus ist auf „Being installed“ gesetzt.
Ein Installationsparameter ist nicht korrekt (z.B. Benutzerkennung existiert nicht).
In der Eingabeliste gibt es doppelte Liefereinheiten, d.h. Einheiten mit gleichen Werten oder Schlüsselwörtern für einen der Identifikations-Parameter.
Die für die angegebene Zielsystemversion notwendige IMON-BAS-Generierungsprozedur ist nicht in der Lieferung verfügbar. Folgende Fälle können auftreten:
Die Zielsystemversion [V]19.0 und [V]20.0 erfordert eine Generierungsprozedur mit IMON-BAS
>=V3.3.- Die Zielsystemversion [V]21.0 erfordert eine Generierungsprozedur mit IMON-BAS
>=V3.4.
Ein Installations-Batchauftrag wird in folgenden Fällen abgebrochen:
Eine Installations-Benutzerkennung ist nicht definiert (nach der Erstellung des Batchauftrags gelöscht).
Es wurde REPLACE-OLD-FILES=*NO angegeben und eine Liefereinheit muss unter dem Namen einer existierenden Datei installiert werden.
Gibt es bereits eine Datei unter dem Standard-Installationspfad, unter dem eine Liefereinheit abgelegt werden soll, gibt es zwei Möglichkeiten: Entweder kann die Liefereinheit irgendwo installiert werden und IMON generiert einen neuen Installationspfad oder die Liefereinheit kann nirgends installiert werden und IMON installiert die Liefereinheit nicht. Dann müssen existierende Dateien manuell entfernt oder REPLACE-OLD-FILES=*MINIMUM angegeben werden.
Eine zu überschreibende Datei wird durch ein Kennwort geschützt und es wurde keine Kennwort-Datei angegeben.
Eine zu überschreibende Datei wird durch ein Kennwort geschützt und eine angegebene Kennwort-Datei enthält nicht die nötigen Kennwort-Kommandos bzw. falsche Kommandos.
Eine existierende Datei kann nicht überschrieben werden (z.B. weil sie gesperrt ist).
Der gleichzeitige Ablauf mehrerer Installationsvorgänge sollte vermieden werden, da gegenseitige Blockierungen beim Zugriff auf gemeinsam benutzte Ressourcen möglich sind. So werden z.B. globale Dateien gesperrt, während sie gemischt werden.
Sollen geparkte Dateien nach der Installation gelöscht werden, werden diese Dateien als „nicht mehr geparkt“ betrachtet, sobald der Batchauftrag für die Installation erzeugt wurde.
Wenn mehrere Installationen gleichzeitig laufen, können sich die Zustände „Being Installed“ bzw. „Installed“ gegenseitig überschreiben.
IMON-Parameterdatei:
Existiert eine kundenspezifische IMON-Parameterdatei mit dem Standardnamen $TSOS.SYSPAR.IMON.<kundenkennzeichen>, wertet IMON zusätzlich die Parameter dieser Datei aus. Falls sie nicht existiert, wertet IMON die Datei $TSOS.SYSPAR.IMON (siehe auch Abschnitt „IMON-Parameterdateien").
Undo-Dateien werden nur generiert, wenn explizit UNDO-PREPARATION=*PARAMETERS(...) angegeben ist. Die in diesen Dateien gesicherten Metadaten sind Voraussetzung für die Wiederherstellung des ursprünglichen Zustandes (Undo-Funktion).
Für jede UNDO-Vorbereitung, die auf Datenträger gesichert werden soll, wird ein eigener Datenträger verwendet.
Erstellung eines LOCAL-VOLUME
Bedingt durch die vielfältigen Einsatzmöglichkeiten und kundenspezifischen Abhängigkeiten muss die Umsetzung einer SOLIS2-Lieferung in ein LOCAL-VOLUME manuell erfolgen. Bitte orientieren Sie sich an nachfolgendem Beispiel:
Nur bei Einsatz von Robotersystemen:
Aufnahme des SOLIS2-VOLUME in den Fremdkassettenbereich von ROBAR mit dem ROBAR-SDF-Kommando „ADD-ROBAR-VOLUME" einschließlich der Stellplatz-Angabe für das reale Archivsystem (z.B. 05)
Nur bei Einsatz von MAREN:
Aufnahme des SOLIS2-VOLUME in den MAREN-Katalog mit der MARENADM-Anweisung //ADD-PRIVATE-VOLUME
Umsetzung einer SOLIS2-Lieferung in ein LOCAL-VOLUME:
/START-ARCHIVE FILES FROM=SV,(vsn1),DEVICE=TAPE-C4 FILES FROM=SV,(vsnx),DEVICE=TAPE-C4 SAVE DIR=NONE,TAPES=POOL,DEVICE=TAPE-C4,CH=NO,L=SYSLST END
Bei Folgebändern muss pro MBK eine FILES-Anweisung gegeben werden. Dabei sind vsn1 und vsnx die Volume-Nummern (VSN) der SOLIS2-Lieferung (siehe Lieferanschreiben)
Wenn die Lieferung auf eine zuvor festgelegte VSN kopiert werden soll (z.B. bei Reservierung einer VSN über MAREN), so muss die Angabe im ARCHIVE-Job von „=POOL" auf „=<vsn>" modifiziert werden.
Nur bei Einsatz von Robotersystemen:
Entfernen des SOLIS2-VOLUME aus dem Fremdkassettenbereich von Robar mit der ROBAR-Anweisung //REMOVE-ROBAR-VOLUME
Interaktive Auswahl von Liefereinheiten
Mit dem Operandenwert SUPPLY-UNITS= *BY-DIALOG in der Anweisung INSTALL-UNITS wird ein Auswahlfenster angefordert. Die weitere Auswahl erfolgt interaktiv und maskengesteuert.
Welche Liefereinheiten ausgewählt werden können, hängt ab von der Lieferinformation. Stammt die Lieferinformation vom Datenträger, können alle Liefereinheiten einer Lieferung ausgewählt werden.
Stammt die Lieferinformation aus einem SCI, können nur die Liefereinheiten ausgewählt werden, die noch nicht installiert sind. Ausnahme: Wurden die Liefereinheiten ohne Löschen der Arbeitsdateien installiert, können sie erneut zur Installation ausgewählt werden.
Die Auswahl der Liefereinheiten erfolgt interaktiv, indem vor jeder gewünschten Liefereinheit ein beliebiges Zeichen eingeben wird.
Eine Liefereinheit kann über die Funktionalität *REGISTERED-MEDIUM für das selbe System mehrmals neu installiert werden, da nun auch Liefereinheiten, die bereits im Status „Installiert" sind, erneut auswählbar sind (z. B. nach versehentlichem Löschen einer Datei der Liefereinheit). Zudem wird der Status „Installiert“ einer Liefereinheit jetzt nur noch im SCI des Systems eingetragen, in dem sie tatsächlich installiert ist.
IMON: SOLIS2-Lieferung: Paketname: <Paketname> Kundenkennzeichen: SOL2P
------------------------------------------------------------------------------
Units 1 bis 5 von 5
Liefereinheiten (Supply-Units) Anordnungsparameter Mehr:
Datei Abl.Ort
Unit-Name Vers Korr Catid Userid Praefix Ersatz zwingen
EDT 17.0 D30 *DEF TSOS *NONE Y N
OPENFT 12.1 C10 *DEF *STD *NONE Y N
OPENFT-CR 12.1 B10 *DEF *STD *NONE Y N
PERCON 02.9 C00 *DEF TSOS *NONE Y N
SORT 08.0 A30 *DEF *STD *NONE Y N
*** Ende der Liefereinheiten Anordnungsparameter ***
------------------------------------------------------------------------------
Kommando ==>
F1=Hilfe F3=Beenden F5=Vorheriges F6=Folgendes F7=Rueckwaerts ...
Bild 57: Interaktive Auswahl von Liefereinheiten
Hinweise
Die interaktive Auswahl gehört nur zum Operandenwert *BY-DIALOG. Sie unterscheidet sich von dem ähnlich aussehenden Bildschirm, der im Menü-Modus über die Option Oeffnen des Menüs Datei angeboten wird.
Die Auswahl der Liefereinheiten wird mit [DUE] beendet.
Die interaktive Auswahl steht im Batchmodus nicht zur Verfügung.