R3_MODIFY_VARIANT

Modifies variant entries.

Transaction: SA38
Interface: AE and Standard (XBP 2.0)

Syntax (Parameters)

R3_MODIFY_VARIANT

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

Syntax	Description/Format
REP[ORT]=	The name of the report. Format: name or script literal
VAR[IANT]=	The name of the variant. Format: name or script literal
SELN[AME]=	The name of the parameter. Format: name or script literal
KIND=P	Parameter type = parameter. Format: name or script literal
LOW=	Parameter value. Format: name or script literal
VERIFY=	Verification of modifications that have been made in the variant. Format: name or script literal Allowed values: "YES" and "NO" (default value) "YES" = The modified variant is verified. "NO" = The modified variant is not verified.
DELAY=	The time span in seconds which the agent waits after a variant modification. Format: number Default value: "0" Following this delay, the buffer synchronization between application servers should be complete if the SAP system runs with multiple application servers.
MERGE=	The merging of parameters. Allowed values: "YES" (default) or "NO" "YES" = Variant parameters are merged. "NO" = The initial values of the variant parameters are used.

Syntax (Select Options)

R3_MODIFY_VARIANT

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

Syntax	Description/Format
REP[ORT]=	The name of the report. Format: name or script literal
VAR[IANT]=	The name of the variant. Format: name or script literal
SELN[AME]=	The name of the selected option. Format: name or script literal
KIND=S	Parameter type = selection option. Format: name or script literal
LOW=	Parameter value (LOW). Format: name or script literal
HIGH=	Value of the parameters (HIGH). Format: name or script literal Only to be indicated with the OPTION=BT or NB (Interval).
SIGN=	Identifier (Include/Exclude). Format: name or script literal Allowed values: "I" (default value) and "E" "I" - Include "E" - Exclude
OPTION=	Selection options. Format: name or script literal "EQ" - Equal (default value) "NE" - Not equal "GT" - Greater than "GE" - Equal or greater than "LT" - Less than "LE" - Equal or less than "CP" - Pattern comparison (wildcards are allowed) "NP" - Exclude pattern "BT" - Within interval (specify HIGH too) "NB" - Outside interval (specify HIGH too)
MODE=	Adds or modifies a selection term. Format: Name or script literal Allowed values: "REPLACE" (default value) and APPEND By doing so, you can create multiple selections. When you specify MODE=APPEND, then the parameter MERGE= is automatically always YES.
VERIFY=	Verification of modifications that have been made in the variant. Format: Name or script literal Allowed values: "YES" and "NO" (default value) "YES" = The modified variant is verified. "NO" = The modified variant is not verified.
DELAY=	The time span in seconds that the agent waits after variant modification. Format: number Default value: "0" Following this delay, the buffer synchronization between application servers should be complete if the SAP system runs with multiple application servers.
MERGE=	The merging of parameters. Allowed values: "YES" (default) or "NO" "YES" = Variant parameters are merged. "NO" = The initial values of the variant parameters are used.

Depending on the entry that has been made in the variant, there is a difference between

Parameters: They are queried in the report by using PARAMETERS.
Selection options: They are queried in the report by using SELECT OPTIONS.

Notes:

Non-specified parameters are not changed.
If a selection option has been modified, its value range can only be changed with a new modification. It cannot be reset to its initial value.
Free variant delimitation (with logical databases) cannot be changed by using R3_MODIFY_VARIANT.
The order that is kept within the variant does not necessarily reflect the specified order if several individual values are assigned for a selection option.
Variant modifications can cause errors in the SAP system (for example, with the logical database PSJ) if the variant's ABAP program uses a logical database. The reason is that the selection screen of the logical database in the SAP system is dynamically modified.
Tip: Copy an original variant and modify the copy.

Warning! Parameter values and the selection options (including intervals from/to) in SAP Basis versions below 7.10 and / or XBP versions below 3.0 are limited to a maximum length of 45 characters. SAP Basis version 7.10 / XBP versions 3.0 and above allow up to 132 characters, which matches the limit of the SAP GUI.

Examples (Parameters)

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

Examples (Select Options)

Select all users whose names start with "B".

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

Select all users except for those whose names are between "USER100" and "USER199".

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

Select company code 10 and 71-77 - multiple selection.

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