Ansicht
Dokumentation
UPG_GET_UPGRADE_INFO - Lesen von Verwaltungsinformationen zu Upgrades im System
Vendor Master (General Section) BAL_S_LOG - Application Log: Log header dataDiese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Lesen von Upgrade-Verwaltungsinformationen zu einer oder allen Kompo-
nenten. Die verschiedenen Exeptions werden nur in bestimmten Readmodes
und abhängig von Parameter IV_COMP_SELECT ausgelöst (siehe 4.und 5.)
Der Funktionsbaustein
liest die Tabelle UVERS nach verschiedenen Kriterien (Readmodes) aus und liefert die gelesenen Upgrade- Informationen in der Ergebnistabelle tt_upginfo zurück.
I Parameter:
------------
1. IV_COMPONENT
Wird als Komponentenname "*" (Default) übergeben, so wird
beim Lesen der Komponentenname nicht beachtet.
2. IV_NEWRELEASE
Das Zielrelease der zu lesenden Upgrades wird nur bei readmode ALL
beachtet. Wird ein Zielrelease <> SPACE angegeben, so werden nur
Upgradeinformationen zu Upgrades auf dieses Release gelesen.
3. IV_UPGTYPE
Als Upgradetyp kann entweder "*" (alle Typen), "A" (Repository-
Switch) oder "P" (Delta-Upgrade) angegeben werden. Entsprechend
werden nur Informationen zum entsprechenden Upgradetype zurückge-
liefert.
4. IV_READMODE
Über die verschiedenen Modi werden unterschiedliche Lesefunktionen
zur Verfügung gestellt:
ALL : Im Rahmen der anderen Einschränkungen (siehe 1. - 3. und 5.)
werden alle verfügbaren Upgrade-Informationen gelesen. Insbe-
sondere werden für eine Komponente Informationen über mehrere
Upgrades zurückgeliefert.
Exceptions: readmode_unknown (s.u.)
component_not_active (s.u.)
LST : Im Rahmen der anderen Einschränkungen (1., 3. und 5.) wird
zu jeder Komponente die Information zum letzten Upgrade zu-
rückgeliefert. Dabei wird der Upgradestatus nicht berück-
sichtigt.
Wurde die Komponente selektiert (1. und 5.) und es steht aber
keine Information über einen entsprechenden (3.) Upgrade zur
Verfügung, so wird eine Default-Information zurückgeliefert:
NEWRELEASE = OLDRELEASE = frühestes Release über das Infor-
mationen vorliegen
PUTSTATUS = "+" (= beendet)
PUTTYPE = "?" (= unbekannt)
Exceptions: readmode_unknown (s.u.)
component_not_active (s.u.)
LSC : In diesem Modus werden nur bereits Informationen über bereits
abgeschlossene Upgrades zurückgegeben. Ansonsten gilt das
gleiche wie bei Modus LST, wobei hier Default-Informationen
geliefert werden, wenn kein abgeschlossener Upgrade gefunden
werden kann.
Exceptions: readmode_unknown (s.u.)
component_not_active (s.u.)
ACT : Im Rahmen der anderen Einschränkungen (1., 3. und 5.) werden
Informationen nur über laufende Upgrades zurückgeliefert.
Es werden KEINE Default-Einträge generiert, wenn für eine
Komponente kein aktiver Upgrade gefunden wurde.
Exceptions: readmode_unknown (s.u.)
component_not_active (s.u.)
ambigious_entries (s.u.)
no_upgrade_active (s.u.)
5. IV_COMP_SELECT
Der Parameter bestimmt, ob Informationen nur für im System bereits
(bzw. noch) existierende Komponenten geliefert werden sollen ("X"),
oder alle ("A") verfügbaren Informationen.
Wenn IV_COMP_SELECT = 'A' übergeben wird, so werden in allen Modi
auch Informationen zu solchen Komponenten zurueckgeliefert, die
laut UPG_GET_COMPONENT_RELEASES nicht aktiv sind, zu denen aber
Upgrade-Informationen gefunden wurden. Insbesondere liefert
"A" auch Informationen über begonnene Installationen von
Komponenten, die noch nicht im System verzeichnet sind.
6. IV_BUFFERED
Lesen über den Tabellenpuffer ("X") oder mit BYPASSING BUFFER (' ')
II Exceptions:
--------------
1. readmode_unknown
Wird ausgelöst, wenn IV_READMODE einen unbekannten Wert enthält.
Die Rückgabetabelle tt_upginfo wird nicht gefüllt.
2. component_not_active
Wird in allen Readmodes ausgelöst, wenn IV_COMPONENT <> space,
diese Komponente nicht aktiv im System ist und IV_COMP_SELECT
= 'X'.
Die Rückgabetabelle tt_upginfo wird nicht gefüllt.
3. ambigious_entries
Wird nur in Readmode ACT ausgelöst, wenn für >= 1 Komponente
der Ergebnismenge mehr als ein Verwaltungssatz (Info) zu einem
noch laufenden Upgrade gefunden wurden.
Dennoch werden alle Informationen zu "aktiven" Upgrades in die
Ergebnistabelle tt_upginfo kopiert.
4. no_upgrade_active
Wird nur in Readmode ACT ausgelöst, wenn unter den gegebenen
Einschränkungen kein aktiver Upgrade gefunden wurde.
Beispiel
Hinweise
Weiterführende Informationen
Zu Restriktionen bzgl. Komponentennamen siehe Dokumentation zum
Datenelement DLVUNIT.
Parameter
EV_UPGCNTIV_AVERS_SELECT
IV_BUFFERED
IV_COMPONENT
IV_COMP_SELECT
IV_NEWRELEASE
IV_READMODE
IV_UPGTYPE
TT_UPGINFO
Ausnahmen
AMBIGIOUS_ENTRIESCOMPONENT_NOT_ACTIVE
NO_UPGRADE_ACTIVE
READMODE_UNKNOWN
Funktionsgruppe
SUGSSUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up rdisp/max_wprun_time - Maximum work process run time
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 6354 Date: 20240523 Time: 064717 sap01-206 ( 62 ms )
