Ansicht
Dokumentation
UPG_GET_UPGRADE_INFO - Read Administration Information for Upgrades in System
General Data in Customer Master Fill RESBD Structure from EBP Component StructureThis documentation is copyright by SAP AG.
Functionality
This function module gets upgrade administration information for one or all components. The various
exceptions are only triggered in certain read modes, dependent on the parameter IV_COMP_SELECT (see 4 and 5).
The function module reads the table UVERS using various criteria (read modes), and returns the upgrade information in the result table tt_upginfo.
I Parameters:
------------
1. IV_COMPONENT
If you specify "*" as the component name (default), the module
ignores the component name.
2. IV_NEWRELEASE
The target release of the upgrades is only read if the read mode is
ALL. If you specify a target release other than SPACE, the module
will only read upgrade information on upgrades to this release.
3. IV_UPGTYPE
You can specify "*" (all types), "A" (Repository Switch), or "P"
(delta upgrade) as upgrade types. The module will only return
information on the specified upgrade types.
4. IV_READMODE
The module offers various read modes:
ALL: Taking into account the other restrictions (1 - 3 and 5), the
module reads all available upgrade information. Information
on multiple upgrades is returned for a single component.
Exceptions: readmode_unknown (see below)
component_not_active (see below)
LST: Taking into account the other restrictions (1 - 3 and 5), the
information on the last upgrade is returned for each
component. The upgrade status is ignored.
If the component was selected (1 and 5), but there is no
information on a corresponding (3) upgrade, default
information is returned:
NEWRELEASE = OLDRELEASE = earliest release with information
available
PUTSTATUS = "+" (= completed)
PUTTYPE = "?" (= unknown)
Exceptions: readmode_unknown (see below)
component_not_active (see below)
LSC: This mode only returns information on completed upgrades.
Otherwise, the same applies as with mode LST. Default
information is returned if no completed upgrade can be found.
Exceptions: readmode_unknown (see below)
component_not_active (see below)
ACT: Taking into account the other restrictions (1 - 3 and 5), this
mode only returns information on running upgrades. No default
entries are generated if no active upgrade can be found for a
component.
Exceptions: readmode_unknown (see below)
component_not_active (see below)
ambigious_entries (see below)
no_upgrade_active (see below)
5. IV_COMP_SELECT
This parameter determines whether information is returned only
for components that exist in the system ("X"), or for all
available components ("A").
If IV_COMP_SELECT = 'A' is specified, all modes also return
information on components that are not active according to
UPG_GET_COMPONENT_RELEASES, but for which upgrade information was
found. "A" returns information on component installations that have
been started, but which are not yet registered in the system.
6. IV_BUFFERED
Read using table buffer ("X") or with BYPASSING BUFFER (' ').
II Exceptions:
--------------
1. readmode_unknown
Triggered if IV_READMODE contains an unknown value.
The return table tt_upginfo is not filled.
2. component_not_active
Triggered in all read modes if IV_COMPONENTS is not SPACE, this
component is not active in the system, and IV_COMP_SELECT = 'X'.
The return table tt_upginfo is not filled.
3. ambigious_entries
Triggered in read mode ACT only, if more than one administration
entry (information) for a running upgrade is found for more than
one component.
However, all information on 'active' upgrades is copied to the
result table tt_upginfo.
4. no_upgrade_active
Triggered in read mode ACT only, if no active upgrade is found
under the specified restrictions.
Example
Notes
Further information
For information on restrictions and component names, see the data element DLVUNIT.
Parameters
EV_UPGCNTIV_AVERS_SELECT
IV_BUFFERED
IV_COMPONENT
IV_COMP_SELECT
IV_NEWRELEASE
IV_READMODE
IV_UPGTYPE
TT_UPGINFO
Exceptions
AMBIGIOUS_ENTRIESCOMPONENT_NOT_ACTIVE
NO_UPGRADE_ACTIVE
READMODE_UNKNOWN
Function Group
SUGSrdisp/max_wprun_time - Maximum work process run time General Material Data
This documentation is copyright by SAP AG.
Length: 5387 Date: 20240523 Time: 144434 sap01-206 ( 54 ms )