Automation Engine Script Guide > AE JCL for Applications > SAP > R3_MODIFY_VARIANT

R3_MODIFY_VARIANT

Modifies variant entries.

Transaction: SA38

Interface: AE and Standard (XBP 2.0)

Syntax (Parameter)

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 (Selection 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.

Comments

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.

Note:

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 databaseA database is an organized collection of data including relevant data structures. 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. Automic recommends copying an original variant and modifying the copy in such a case.

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