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

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

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

Note:

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

 

See also: