ABAPGET_PARAMETER - GET PARAMETER

General Data in Customer Master   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.

GET PARAMETER

Kurzreferenz

Syntax

GET PARAMETER ID pid FIELD dobj.

Wirkung

Diese Anweisung setzt den Inhalt des Datenobjekts dobj auf den Inhalt des in pid angegebenenSPA/GPA-Parameters. Für die Kennung pid wird einflacheszeichenartiges Feld erwartet, das maximal 20 Zeichen und nicht ausschließlich Leerzeichen enthaltendarf. Die Groß-/Kleinschreibung wird berücksichtigt. Für dobj wird ein flacheszeichenartiges Feld erwartet, in das der binäre Inhalt des SPA/GPA-Parameters unkonvertiert übertragen wird.

Die Anweisung GET PARAMETER greift nicht direkt auf das SAP Memory, sondern auf eine lokale Abbildung der SPA/GPA-Parameter imRollbereich zu, die beim Hereinrollen geladen und beim Herausrollen im SAP Memory gespeichert wird (sieheSPA/GPA-Parameter und ABAP-Programme). Wenn der in pid angegebene SPA/GPA-Parameter für den aktuellen Benutzer beim Hereinrollen noch nicht imSAP Memory existierte, wird das Datenobjekt dobj initialisiert und sy-subrc auf 4 gesetzt.

In einem Programm dürfen nur SPA/GPA-Parameter ausgelesen werden, für die es einen Namenin der Tabelle TPARA gibt. Wenn statisch festgestellt werden kann, dass eine in pid angegebene Kennung nicht in der DatenbanktabelleTPARA enthalten und die Paketprüfung der ABAP-Laufzeitumgebung über denProfilparameterabap/package_check eingeschaltet ist, kommt es zu einem Syntaxfehler. Ansonsten meldet nur die erweiterte Programmprüfung einen Fehler.

Systemfelder

sy-subrc	Bedeutung
0	Der in pid angegebene SPA/GPA-Parameter ist für den aktuellen Benutzer im SAP Memory vorhanden und sein Wert wurde in das Zielfeld übertragen.
4	Der in pid angegebene SPA/GPA-Parameter ist für den aktuellen Benutzer nicht im SAP Memory vorhanden.

Hinweise

• Ein mit GET PARAMETER lesbarer SPA/GPA-Parameter kann zuvor entweder mit der Anweisung SET PARAMETER oder automatisch beim EreignisPAI einesDynpros bzw. einesSelektionsbilds im SAP Memory angelegt worden sein.
  
• Damit ein in pid angegebener SPA/GPA-Parameter mit einem Namen in der Datenbanktabelle TPARA übereinstimmt, muss er in Großbuchstaben angegeben werden.
  
• Da die Anweisungen SET PARAMETER und GET PARAMETER nicht direkt mit den SPA/GPA-Parameterndes SAP Memory arbeiten, sind sie nur für die Datenübergabe innerhalb eines Hauptmodusaber nicht für die Datenübergabe zwischen parallelen Hauptmodi geeignet, da parallel laufende Programme den Zustand der Parameter unkontrolliert beeinflussen können.
  
  
  

Beispiel

Auslesen des aktuellen Werts des SPA/GPA-Parameters RID aus dem SAP Memory in das Datenobjekt prog. Dieser Parameter ist in den Dynpros derABAPWorkbench mit den Eingabefeldern für einen Programmnamen verknüpft. Beim ersten Aufrufeines Werkzeugs der ABAP Workbench, in dem ein ABAP-Programm bearbeitet wird, wird der Parameter beimEreignis PAI angelegt und mit dem Namen des dort eingegebenen Programms versorgt. Wenn in der gleichenBenutzersitzung kein Dynpro prozessiert wurde, das den Parameter RID setzt und zuvor auch keine entsprechende Anweisung SET PARAMETER ausgeführt wurde, wird RID im SAP Memory nicht gefunden.

DATA: para TYPE tpara-paramid VALUE 'RID',
      prog TYPE sy-repid.

GET PARAMETER ID para FIELD prog.

IF sy-subrc <> 0.
  MESSAGE 'Parameter not found' TYPE 'I'.
ENDIF.

CPI1466 during Backup   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.


Length: 5714 Date: 20120526 Time: 212206     triton ( 175 ms )