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 reportA report provides more detailed information about a task's execution or a component..
Format: name or script literal 

VAR[IANT]=

The name of the variant.
Format: name or scriptA particular Automation Engine object type. 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 agentA program that enables the de-centralized execution of processes (such as deployments) on target systems (computers or business solutions) or a service that provides connectivity to a target system (such as for databases or middleware). An agent is also an object type in the Automation Engine. [Formerly called "Executor."] See also: host waits after a variant modification.
Format: number

Default value: "0"

Following this delay, the buffer synchronization between applicationAn application is a software which helps a user to fulfill specific tasks. In the context of ARA see also: Application entity. 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

Note:

Parameter values and the selection options (including intervals from/to) in SAP Basis versionsAn application version holds zero or more deployment packages and may have dependencies to zero or more application versions of the same (or to different) applications 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: 

 


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

Copyright © 2016 Automic Software GmbH