Automation Engine Script-Leitfaden > AE JCL für Anwendungen > SAP > R3_MODIFY_VARIANT

R3_MODIFY_VARIANT

Modifiziert einen Eintrag in einer Variante.

Transaktion: SA38

Schnittstelle: AE und Standard (XBP 2.0)

Syntax (Parameter)

R3_MODIFY_VARIANT

REPORT=...
,VARIANT=...
,SELNAME=...
,KIND=P
,LOW=...
[,VERIFY=...]
[,DELAY=...]
[,MERGE=...]

Syntax	Beschreibung/Format
REP[ORT]=	Name des Reports. Format: Name oder Script-Literal
VAR[IANT]=	Name der Variante. Format: Name oder Script-Literal
SELN[AME]=	Name des Parameters. Format: Name oder Script-Literal
KIND=P	Typ des Parameters = Parameter. Format: Name oder Script-Literal
LOW=	Parameterwert. Format: Name oder Script-Literal
VERIFY=	Modifizieren der Variante überprüfen. Format: Name oder Script-Literal Erlaubte Werte: "YES" und "NO" (Standardwert) "YES" = Modifizierte Variante überprüfen. "NO" = Modifizierte Variante nicht überprüfen.
DELAY=	Zeitspanne in Sekunden, die der Agent nach dem Modifizieren einer Variante wartet. Format: Zahl Standardwert: "0" Nach dieser Zeitspanne sollte die Buffer-Synchronisation zwischen Applikationsservern abgeschlossen sein, wenn das SAP-System mit mehreren Applikationsservern betrieben wird.
MERGE=	Parameter zusammenmischen Erlaubte Werte: "YES" (Standardwert) oder "NO" "YES" = Varianten-Parameter zusammenmischen "NO" = Intialwerte der Varianten-Parameter verwenden.

Syntax (Select-Optionen)

R3_MODIFY_VARIANT

REPORT=...
,VARIANT=...
,SELNAME=...
,KIND=P
,LOW=...
[,HIGH=...]
[,SIGN=...]
[,OPTION=...]
[,MODE=...]
[,VERIFY=...]
[,DELAY=...]
[,MERGE=...]

Syntax	Beschreibung/Format
REP[ORT]=	Name des Reports. Format: Name oder Script-Literal
VAR[IANT]=	Name der Variante. Format: Name oder Script-Literal
SELN[AME]=	Name der ausgewählten Option. Format: Name oder Script-Literal
KIND=S	Typ des Parameters = Auswahl-Option. Format: Name oder Script-Literal
LOW=	Wert des Parameters (LOW). Format: Name oder Script-Literal
HIGH=	Wert der Parameter (HIGH). Format: Name oder Script-Literal Nur bei OPTION=BT oder NB (Intervall) angeben!
SIGN=	Kennzeichen (Include/Exclude). Format: Name oder Script-Literal Erlaubte Werte: "I" (Standardwert) und "E" "I" = Include "E" = Exclude
OPTION=	Select-Optionen. Format: Name oder Script-Literal "EQ" - gleich (Standardwert) "NE" - ungleich "GT" - Größer als "GE" - Gleich oder größer "LT" - Kleiner als "LE" - Gleich oder kleiner "CP" - Mustervergleich (mit Wildcardzeichen) "NP" - Muster ausschließen "BT" - Intervall (auch HIGH angeben) "NB" - außerhalb Intervall (auch HIGH angeben)
MODE=	Selektionsbegriff ändern oder hinzufügen. Format: Name oder Script-Literal Erlaubte Werte: "REPLACE" (Standardwert) und "APPEND" Damit ist es möglich, Mehrfachselektionen zu erstellen. Bei Angabe von MODE=APPEND ist der Parameter MERGE= automatisch immer YES.
VERIFY=	Modifizieren der Variante überprüfen. Format: Name oder Script-Literal Erlaubte Werte: "YES" und "NO" (Standardwert) "YES" = Modifizierte Variante überprüfen. "NO" = Modifizierte Variante nicht überprüfen.
DELAY=	Zeitspanne in Sekunden, die der Agent nach dem Modifizieren einer Variante wartet. Format: Zahl Standardwert: "0" Nach dieser Zeitspanne sollte die Buffer-Synchronisation zwischen Applikationsservern abgeschlossen sein, wenn das SAP-System mit mehreren Applikationsservern betrieben wird.
MERGE=	Parameter zusammenmischen Erlaubte Werte: "YES" (Standardwert) oder "NO" "YES" = Varianten-Parameter zusammenmischen "NO" = Intialwerte der Varianten-Parameter verwenden.

Anmerkungen

Je nach Eintrag in der Variante ist zu unterscheiden:

Parameter: werden im Report mit PARAMETERS abgefragt und
Select-Optionen: werden im Report mit SELECT-OPTIONS abgefragt.

Hinweis:

Nicht angegebene Einträge bleiben unverändert.
Erfolgt für eine Select-Option eine Änderung, so kann der Wertebereich maximal durch eine neue Änderung eine andere Gültigkeit erhalten. Ein Rücksetzen auf Initialwert ist nicht möglich.
Freie Abgrenzungen einer Variante (bei logischen Datenbanken) können mit R3_MODIFY_VARIANT nicht geändert werden.
Werden für eine Select-Option mehrere Einzelwerte übergeben, so entspricht die Reihenfolge in der Variante letztendlich nicht unbedingt der angegebenen Reihenfolge!
Verwendet das ABAP-Programm, zu welchem die Variante gehört, eine logische Datenbank, kann das Modifizieren der Variante zu Fehlverhalten im SAP System führen (beispielsweise bei logischer Datenbank PSJ). Dies liegt daran, dass das Selektionsbild der logischen Datenbank im SAP System dynamisch modifiziert wird. In solchen Fällen empfiehlt sich, eine Original-Variante zu kopieren und die Kopie zu ändern.

Bei einer SAP Basis Version kleiner 7.10 und / oder einer XBP-Version kleiner 3.0 sind die Werte der Parameter und Selektions-Optionen (auch Intervalle von/bis) auf eine Maximallänge von 45 Zeichen beschränkt! SAP Basis Version 7.10 / XBP-Versionen 3.0 und höher erlauben bis zu 132 Zeichen; dies entspricht der Begrenzung der SAP GUI.

Beispiel (Parameter)

R3_MODIFY_VARIANT REPORT=RSUSR002,VAR=SAP_STANDARD,SELN=TCODE,KIND=P,LOW='SE01'

Beispiele (Select-Optionen)

Alle Benutzer selektieren, deren Name mit "B" beginnt.

R3_MODIFY_VARIANT REP=RSUSR002,VAR=SAP_STANDARD,SELN=USER,KIND=S,LOW='B*',SIGN=I,OPTION=CP

Alle Benutzer selektieren, außer jenen, deren Name zwischen "USER100" und "USER199" liegt.

R3_MODIFY_VARIANT ...,SELN=USER,KIND=S,LOW='USER100',HIGH='USER199',SIGN=I,OPTION=NB

Buchungskreis 10 und 71-77 selektieren - Mehrfachselektion.

R3_MODIFY_VARIANT REP=RF...,VAR=v1,SELN=BUKRS,KIND=S,LOW='10',SIGN=I,OPTION=EQ,MODE=R

R3_MODIFY_VARIANT REP=RF...,VAR=v1,SELN=BUKRS,KIND=S,LOW='71',HIGH='77',SIGN=I,OPTION=BT,MODE=A

Siehe auch:

Allgemeines zur SAP-JCL

Beispielsammlung

Aufruf eines MBeans

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support